Agent SkillsAgent Skills
WILLOSCAR

idea-brief

@WILLOSCAR/idea-brief
WILLOSCAR
424
29 forks
Updated 5/2/2026
View on GitHub

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`). **Trigger**: idea brief, ideation brief, research ideas, brainstorm, 找 idea, 选题, 点子, 找方向. **Use when**: the user wants research ideas and their input is long / multi-turn; you need to clarify topic + constraints before retrieval. **Skip if**: the goal is to write a survey draft directly (use `arxiv-survey*` pipelines instead). **Network**: none. **Guardrail**: do not invent papers/citations; do not start retrieval here; keep the brief structured (no long prose).

Installation

$npx agent-skills-cli install @WILLOSCAR/idea-brief
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

RepositoryWILLOSCAR/research-units-pipeline-skills
Path.codex/skills/idea-brief/SKILL.md
Branchmain
Scoped Name@WILLOSCAR/idea-brief

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

npx agent-skills-cli list

Skill Instructions

name: idea-brief description: | 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). Trigger: idea brief, ideation brief, research ideas, brainstorm, 找 idea, 选题, 点子, 找方向. Use when: the user wants research ideas and their input is long / multi-turn; you need to clarify topic + constraints before retrieval. Skip if: the goal is to write a survey draft directly (use arxiv-survey* pipelines instead). Network: none. Guardrail: do not invent papers/citations; do not start retrieval here; keep the brief structured (no long prose).

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

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

All Options

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

Examples

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

More by WILLOSCAR

View all
citation-verifier
424

Generate and verify BibTeX entries from paper notes, writing `citations/ref.bib` and `citations/verified.jsonl`. **Trigger**: citation, BibTeX, ref.bib, verified.jsonl, references, 引用, 参考文献. **Use when**: 已有 `papers/paper_notes.jsonl`，需要为 prose/LaTeX 准备可追溯的引用（每条都有 url/date/title 验证记录）。 **Skip if**: 还没有 paper notes（或本次产出不需要引用/参考文献）。 **Network**: 自动验证通常需要网络；无网络时可先 record，再标注 needs manual verification。 **Guardrail**: 每个 BibTeX entry 必须对应一条 `citations/verified.jsonl` 记录；prose 只能使用已存在于 `citations/ref.bib` 的 citation keys。

tutorial-module-writer
424

Write the tutorial content (`output/TUTORIAL.md`) from an approved module plan, including exercises and answer outlines. **Trigger**: write tutorial, tutorial modules, 教程写作, TUTORIAL.md. **Use when**: tutorial pipeline 的写作阶段（C3），且 `DECISIONS.md` 已记录 HUMAN 对 scope/running example 的批准（C2）。 **Skip if**: module plan 未完成/未批准（先跑 `module-planner`/`exercise-builder` 并通过 Approve C2）。 **Network**: none. **Guardrail**: 只写已批准范围；保持 running example 一致；每模块包含练习与答案要点。

deliverable-selfloop
424

Use when a reader-facing deliverable exists and needs a deterministic PASS/FAIL quality gate. **Trigger**: self loop, self-loop, polish deliverable, quality gate, fix-on-fail, 收敛, 自循环, 质量门. **Use when**: A pipeline has produced a reader-facing deliverable (`output/*.md`) and you want deterministic convergence to PASS. **Skip if**: You are still pre-approval for prose or the upstream evidence/structure artifacts are missing. **Network**: none. **Guardrail**: Do not invent papers/citations/results. Only use in-scope inputs already present in the workspace.

pdf-text-extractor
424

Download PDFs (when available) and extract plain text to support full-text evidence, writing `papers/fulltext_index.jsonl` and `papers/fulltext/*.txt`. **Trigger**: PDF download, fulltext, extract text, papers/pdfs, 全文抽取, 下载PDF. **Use when**: `queries.md` 设置 `evidence_mode: fulltext`（或你明确需要全文证据）并希望为 paper notes/claims 提供更强 evidence。 **Skip if**: `evidence_mode: abstract`（默认）；或你不希望进行下载/抽取（成本/权限/时间）。 **Network**: fulltext 下载通常需要网络（除非你手工提供 PDF 缓存在 `papers/pdfs/`）。 **Guardrail**: 缓存下载到 `papers/pdfs/`；默认不覆盖已有抽取文本（除非显式要求重抽）。