---
name: willoscar-idea-shortlist-curator
description: "Converge the screened direction pool into a small, discussion-ready shortlist, writing `output/trace/IDEA_SHORTLIST.md`."
metadata:
  decimalai-skill-id: "259c3c55-03db-44a4-a2cb-3cfafb9a2729"
  decimalai-version-id: "036cfffc-4d81-4f41-841f-0ebfcea71f85"
  decimalai-version: "2"
  decimalai-body-sha256: "f0d5896670f90e1bd2dde59450a58005bfea2fbc8cc4c9f68132bb8e7f8ad978"
  decimalai-name: "willoscar/idea-shortlist-curator"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "research"
  decimalai-source: "https://app.decimal.ai/s/willoscar-idea-shortlist-curator@2/SKILL.md"
---
# Idea Shortlist Curator

## Triggers & routing

- **Trigger**: idea shortlist, shortlist directions, brainstorm shortlist, 方向 shortlist.
- **Use when**: you already have a direction pool and screening table and want the strongest 3-5 directions for the final memo.


## Load Order

Always read:
- `references/overview.md`

Read by task:
- `references/ranking_rubric.md` when customizing risk notes or deferral reasons
- `assets/rationale_templates.json` when changing deterministic shortlist rationale wording or rule order

## Script Boundary

Use `scripts/run.py` only for:
- diversity-aware greedy selection from screened rows
- deterministic ranking record assembly and JSONL/Markdown output

Do not treat `run.py` as the place for:
- domain-specific risk narratives that should be inspectable from references
- reader-facing prose templates for the final memo (those belong in `idea-memo-writer`)

Goal: turn a direction pool into a small shortlist that is:
- explicitly ranked with a real why-#1>#2>#3 argument,
- diverse in program shape rather than just cluster labels,
- specific about why deferred directions are not in the lead set,

and remains:
- academically interesting,
- distinct enough to compare,
- grounded enough to discuss,
- and not yet overfrozen into project plans.

## Script

### Quick Start

- `uv run python .codex/skills/idea-shortlist-curator/scripts/run.py --workspace <workspace>`

### All Options

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

### Examples

- Curate a shortlist for a brainstorm workspace:
  - `uv run python .codex/skills/idea-shortlist-curator/scripts/run.py --workspace workspaces/brainstorm-llm-agents`