wanshuiyin/auto-claude-code-research-in-sleep-skills-codex-idea-creator
Generate and rank research ideas given a broad direction. Use when user says \"\u627eidea\", \"brainstorm ideas\", \"generate research ideas\", \"what can we work on\", or wants to explore a research area for publishable directions.
npx skills add https://github.com/wanshuiyin/Auto-claude-code-research-in-sleep --skill idea-creator
Generate publishable research ideas for: $ARGUMENTS
Given a broad research direction from the user, systematically generate, validate, and rank concrete research ideas. Standalone, Phase 1's landscape survey is inline (WebSearch — it does not invoke /research-lit); Phases 4-5 invoke /novelty-check, /run-experiment, and /monitor-experiment for validation and pilots. For the full sub-skill pipeline (/research-lit → idea generation → /novelty-check → /research-review), run /idea-discovery (Workflow 1), which orchestrates this skill.
gpt-5.6-sol — Model used via a secondary Codex agent for brainstorming and review. Must be an OpenAI model (e.g., gpt-5.6-sol, o3, gpt-4o).codex — Default: Codex xhigh reviewer through spawn_agent / send_input. Use --reviewer: oracle-pro only when explicitly requested; if Oracle is unavailable, warn and fall back to Codex xhigh.idea-stage/ — All idea-stage outputs go here. Create the directory if it doesn't exist.> 💡 Override via argument, e.g., /idea-creator "topic" — pilot budget: 4h per idea, 20h total.
Idea generation is breadth-bound, so use one fresh spawn_agent shard per
analytic lens when delegation is available; otherwise run the same lenses
sequentially in fresh contexts. Each shard is read-only and returns
{"shard_id": ..., "candidates": [{"payload": ..., "dedup_key": ...}]}.
Merge and mechanically deduplicate by dedup_key; shards must not rank, reject,
or write shared files. The final Codex jury sees the full deduped set and records
same-family provisional, never accepted. See
fan-out-pattern.md.
Skip this phase entirely if research-wiki/ does not exist.
Resolve the wiki helper using the Codex-side canonical chain (see
../shared-references/wiki-helper-resolution.md):
ARIS_REPO="${ARIS_REPO:-$(awk -F'\t' '$1=="repo_root"{print $2; exit}' .aris/installed-skills-codex.txt 2>/dev/null)}"
WIKI_SCRIPT=""
[ -n "$ARIS_REPO" ] && [ -f "$ARIS_REPO/tools/research_wiki.py" ] && WIKI_SCRIPT="$ARIS_REPO/tools/research_wiki.py"
[ -z "$WIKI_SCRIPT" ] && [ -f tools/research_wiki.py ] && WIKI_SCRIPT="tools/research_wiki.py"
[ -z "$WIKI_SCRIPT" ] && [ -f ~/.codex/skills/research-wiki/research_wiki.py ] && WIKI_SCRIPT="$HOME/.codex/skills/research-wiki/research_wiki.py"
THREAT_SCANNER=""
[ -n "$ARIS_REPO" ] && [ -f "$ARIS_REPO/tools/threat_scan.py" ] && THREAT_SCANNER="$ARIS_REPO/tools/threat_scan.py"
[ -z "$THREAT_SCANNER" ] && [ -f tools/threat_scan.py ] && THREAT_SCANNER="tools/threat_scan.py"
If research-wiki/query_pack.md exists and is less than 7 days old, read it as initial landscape context:
python3 "$THREAT_SCANNER" research-wiki/query_pack.md --scope strictwhen the scanner resolves. A hit blocks the cached pack from entering context;
preserve the raw file for human inspection and rebuild through WIKI_SCRIPT.
If the rebuilt pack still hits, continue without wiki context and report
BLOCKED input rather than injecting the payload. See
injection-hygiene.md.
If research-wiki/ exists but query_pack.md is stale or missing, rebuild it only when WIKI_SCRIPT is available. If the helper is unavailable, continue without rebuilding and report that wiki refresh was skipped.
Map the research area to understand what exists and where the gaps are.
papers/ and literature/ in the project directory for existing PDFs. Read first 3 pages of relevant papers to build a baseline understanding before searching online. This avoids re-discovering what the user already knows.Use a secondary Codex agent for divergent thinking:
spawn_agent:
model: REVIEWER_MODEL
reasoning_effort: xhigh
message: |
You are a senior ML researcher brainstorming research ideas.
Research direction: [user's direction]
Here is the current landscape:
[paste landscape map from Phase 1]
Key gaps identified:
[paste gaps from Phase 1]
Generate 8-12 concrete research ideas. For each idea:
1. One-sentence summary
2. Core hypothesis (what you expect to find and why)
3. Minimum viable experiment (what's the cheapest way to test this?)
4. Expected contribution type: empirical finding / new method / theoretical result / diagnostic
5. Risk level: LOW (likely works) / MEDIUM (50-50) / HIGH (speculative)
6. Estimated effort: days / weeks / months
Prioritize ideas that are:
- Testable with moderate compute (8x RTX 3090 or less)
- Likely to produce a clear positive OR negative result (both are publishable)
- Not "apply X to Y" unless the application reveals genuinely surprising insights
- Differentiated from the 10-15 papers above
Be creative but grounded. A great idea is one where the answer matters regardless of which way it goes.
Save the agent id for follow-up.
Save a Review Tracing record for this spawn_agent call following ../shared-references/review-tracing.md, including the landscape summary, prompt summary, raw idea list path, reviewer route, and saved agent id.
> This phase does NOT judge idea quality, novelty, or impact — those are the
> job of the Phase-4 fresh reviewer (same-family provisional in the base mirror). Dropping
> ideas here on a same-family novelty or impact call would pre-filter the
> reviewer's input with same-family judgment — the opposite of why ARIS uses a
> fresh reviewer at all. Phase 3 only (a) clusters near-duplicate ideas
> and (b) drops ideas that are OBJECTIVELY out of budget; everything else
> passes through ANNOTATED, not eliminated.
mechanical, budget-based fact — estimated compute > 1 week of available GPU
time, OR a dataset that is provably unavailable. Do NOT drop on
"implementation looks complex" — annotate complexity instead.
and attach a prior_work note (what looks related, with links). This is
input for the Phase-4 reviewer, not a filter; full /novelty-check runs in
Phase 4. Do NOT drop an idea here because it "might already be done."
so_whatnote (why the result would matter either way). Do NOT drop on a same-family
"a reviewer wouldn't care" call — that is exactly what the Phase-4
fresh reviewer is for.
Every feasible, non-duplicate idea — with its prior_work and so_what
annotations — proceeds to Phase 4, where the fresh reviewer does the
quality/novelty narrowing.
For each surviving idea, run a deeper evaluation:
/novelty-check workflow (multi-source search + GPT-5.6-Sol cross-verification) for each ideasend_input (same agent): send_input:
target: [saved reviewer id from the earlier idea review]
message: |
Here are our top ideas after filtering:
[paste surviving ideas with novelty check results]
For each, play devil's advocate:
- What's the strongest objection a reviewer would raise?
- What's the most likely failure mode?
- How would you rank these for a top venue submission?
- Which 2-3 would you actually work on?
Before committing to a full research effort, run cheap pilot experiments to get empirical signal. This is the key differentiator from paper-only validation.
/run-experiment to launch pilots on different GPUs simultaneously: GPU 0: Pilot for Idea 1
GPU 1: Pilot for Idea 2
GPU 2: Pilot for Idea 3
Use run_in_background: true to launch all at once.
/monitor-experiment to check progress. If any pilot exceeds PILOT_TIMEOUT_HOURS, kill it and collect partial results. Once all pilots complete (or timeout), compare:Note: Skip this phase if the ideas are purely theoretical or if no GPU is available. Flag skipped ideas as "needs pilot validation" in the report.
Write a structured report to idea-stage/IDEA_REPORT.md:
Lead every recommended idea with its method, in plain language. Before any hypothesis, novelty score, or claim, state in 2–4 concrete steps what we actually build / train / run — no jargon, no claim-IDs. The reader must understand *what we do* before *what we claim*; claims (hypothesis, validation, expected outcome) come after and read as the method's acceptance criteria.
# Research Idea Report
**Direction**: [user's research direction]
**Generated**: [date]
**Ideas evaluated**: X generated → Y survived filtering → Z piloted → W recommended
## Landscape Summary
[3-5 paragraphs on the current state of the field]
## Recommended Ideas (ranked)
### Idea 1: [title]
- **Method (what we actually do)**: [2–4 concrete steps in plain language — what we build / train / run. No jargon, no claim-IDs, no hypothesis yet. Lead with this so the reader grasps the approach first.]
- **Hypothesis**: [one sentence]
- **Minimum experiment**: [concrete description]
- **Expected outcome**: [what success/failure looks like]
- **Novelty**: X/10 — closest work: [paper]
- **Feasibility**: [compute, data, implementation estimates]
- **Risk**: LOW/MEDIUM/HIGH
- **Contribution type**: empirical / method / theory / diagnostic
- **Pilot result**: [POSITIVE: metric +X% / NEGATIVE: no signal / SKIPPED: needs GPU]
- **Reviewer's likely objection**: [strongest counterargument]
- **Why we should do this**: [1-2 sentences]
### Idea 2: [title]
...
## Eliminated Ideas (for reference)
| Idea | Reason eliminated |
|------|-------------------|
| ... | Already done by [paper] |
| ... | Requires > 1 week GPU time |
| ... | Result wouldn't be interesting either way |
## Pilot Experiment Results
| Idea | GPU | Time | Key Metric | Signal |
|------|-----|------|------------|--------|
| Idea 1 | GPU 0 | 45 min | +2.3% CE | POSITIVE |
| Idea 2 | GPU 1 | 30 min | -0.1% CE | NEGATIVE |
| Idea 3 | GPU 2 | 1.5 hr | +0.8% CE | WEAK POSITIVE |
## Suggested Execution Order
1. Start with Idea 1 (positive pilot signal, lowest risk)
2. Idea 3 as backup (weak signal, may need larger scale to confirm)
3. Idea 2 eliminated by pilot — negative result documented
## Next Steps
- [ ] Scale up Idea 1 to full experiment (multi-seed, full dataset)
- [ ] If confirmed, invoke /auto-review-loop for full iteration
Skip this phase entirely if research-wiki/ does not exist.
This is critical for spiral learning: without it, ideas/ stays empty and re-ideation has no memory.
The idea page is written by the deterministic upsert_idea helper — NOT freehand
markdown — so **every generation, including a re-run with updated constraints, records
reliably** (one helper call per idea, not a prose step the model can skip). upsert_idea
writes the page, wires the inspired_by/addresses_gap edges, and rebuilds index +
query_pack in a single call. Default skip-on-exist: a re-ideation run records NEW
ideas without clobbering an existing idea whose outcome /result-to-claim may already
have enriched. --outcome stays pending at creation (the experiment verdict is set
later by /result-to-claim, never guessed here). If WIKI_SCRIPT is unavailable, the
ideas are NOT recorded and a single WARN is reported (fix: install ARIS research_wiki.py).
if research-wiki/ exists AND WIKI_SCRIPT is available:
for each recommended (stage proposed) and eliminated (stage archived) idea:
python3 "$WIKI_SCRIPT" upsert_idea research-wiki/ --slug "<stable-idea-id>" \
--title "<idea title>" --stage "<proposed|archived>" --outcome pending \
--thesis "<core hypothesis / direction>" \
--risks "<novelty / feasibility risks; why killed if eliminated>" \
--based-on "<paper:slug,paper:slug2>" --target-gaps "<G2,G10>"
log: "idea-creator wrote N ideas (M recommended, K eliminated)"
else if research-wiki/ exists AND WIKI_SCRIPT unavailable:
report: ideas NOT recorded — ARIS research_wiki.py unreachable
Edge semantics (wired by upsert_idea itself): idea:<id> --inspired_by--> paper:<slug>
and idea:<id> --addresses_gap--> gap:<id>.
Composition: default is standalone and writes the normal ranked report. If
and only if — composed: <canonical-report-path> is present, fold unique idea,
pilot, and reviewer findings into that report and do not emit overlapping
standalone summaries. — standalone always wins; never infer composition from
an old report already existing. Traces and reusable pilot artifacts remain.
See output-composition.md.
> Follow these shared protocols for all output files:
> - Output Versioning Protocol — write timestamped file first, then copy to fixed name
> - Output Manifest Protocol — log outputs only above the manifest threshold
> - Output Language Protocol — respect the project's language setting
cat << 'EOF' > file) to write in chunks. Do NOT ask the user for permission — just do it silently.After this skill produces the ranked report:
/idea-creator "direction" → ranked ideas
/novelty-check "top idea" → deep novelty verification (already done in Phase 4, but user can re-run)
/research-review "top idea" → external critical feedback
implement → write code
/run-experiment → deploy to GPU
/auto-review-loop → iterate until submission-ready
After each spawn_agent or send_input reviewer call, save the trace following ../shared-references/review-tracing.md. Include the reviewer route, saved agent id, prompt summary, raw output path, selected ideas, and rejected ideas.
Take wanshuiyin/auto-claude-code-research-in-sleep-skills-codex-idea-creator from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
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.