mcpbeat

Idea Memo Writer

willoscar/idea-memo-writer

| Synthesize the shortlist into a discussion-ready research idea brainstorm memo, writing `output/REPORT.md`, `output/APPENDIX.md`, and `output/REPORT.json`.

2k tokens
context cost
the whole folder, loaded on every use
4
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
496
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/WILLOSCAR/research-units-pipeline-skills --skill idea-memo-writer

What comes with it

4 749 bytes besides the instruction
references/overview.md
references/report_structure.md
scripts/run.py

The instruction itself

7 sections, as written by the author

Idea Memo Writer

Goal: turn the shortlist into a discussion-ready memo.

Load Order

Always read:

  • references/overview.md
  • references/report_structure.md

Script Boundary

Use scripts/run.py only for:

  • deterministic assembly of the report from trace artifacts
  • calling tooling/ideation.py library functions for rendering

Do not treat run.py as the place for:

  • ideation heuristics or scoring logic
  • hardcoded report prose templates

The final memo should feel like:

  • an advisor-ready discussion memo rather than workflow notes,
  • paper-specific in its evidence hooks and appendix reading guide,
  • explicit about rank logic and quick kill criteria,

and still feel like:

  • a strong brainstorming artifact,
  • grounded in the literature,
  • rich enough for PI/PhD discussion,
  • but not frozen into a rigid project execution spec.

Script

Quick Start

  • uv run python .codex/skills/idea-memo-writer/scripts/run.py --workspace <workspace>

All Options

  • --workspace <dir> (required)
  • --unit-id <U###>
  • --inputs <semicolon-separated>
  • --outputs <semicolon-separated>
  • --checkpoint <C#>

Examples

  • Assemble the brainstorm memo for a workspace:
  • uv run python .codex/skills/idea-memo-writer/scripts/run.py --workspace workspaces/brainstorm-llm-agents

How to use it

Copy the folder

Take willoscar/idea-memo-writer from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.