mcpbeat

Idea Brief

willoscar/idea-brief

| Lock an ideation run into a single-source-of-truth brainstorm brief (`output/trace/IDEA_BRIEF.md`) and a replayable multi-query plan (`queries.md`).

6k 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-brief

What comes with it

20 814 bytes besides the instruction
assets/brief_contract.json
references/overview.md
scripts/run.py

The instruction itself

8 sections, as written by the author

Idea Brief

Turn a fuzzy ideation request into an auditable brainstorm contract for the later ideation stack.

This skill does not retrieve papers.

It only locks topic, audience, constraints, exclusions, rubric, query buckets, and target artifact shape into:

  • output/trace/IDEA_BRIEF.md
  • queries.md
  • DECISIONS.md

Inputs

  • GOAL.md
  • DECISIONS.md
  • queries.md

Outputs

  • output/trace/IDEA_BRIEF.md
  • queries.md
  • DECISIONS.md

Execution notes

This skill starts from GOAL.md, then refines the topic/constraints into output/trace/IDEA_BRIEF.md, updates queries.md, and records blockers or approvals in DECISIONS.md.

Read references/overview.md before changing the package shape or the brief contract.

assets/brief_contract.json is the machine-readable source for:

  • required brief sections
  • goal / audience framing
  • rubric rows
  • query bucket templates
  • default exclusions
  • focus placeholder
  • shared table/open-question text
  • decisions bootstrap text

Script

Quick Start

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

All Options

  • --workspace <dir>
  • --unit-id <id>
  • --inputs <a;b;...>
  • --outputs <a;b;...>
  • --checkpoint <C*>

Examples

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

How to use it

Copy the folder

Take willoscar/idea-brief 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.