research-plan
Skill52 starsChanged 8 months agoMITView on GitHub
Build execution-ready research plans, experiment proposals, and ablation designs. Prefer invoking via research-workflow. TRIGGER when: user asks for research proposal, experiment plan, ablation design, evaluation roadmap, study design, or after deep-research scoping needs conversion to actionable plan. DO NOT TRIGGER when: evidence gathering needed first (use deep-research), actual experiment launch (use experiment-execution), or paper writing (use paper-writing).
5 other projects use a version of this.
Adopted by
Most recently taken up by
- miguelclavel/ux-research-skillstheir own version, first seen Nov 8, 2026
- lalulali/vespyrtheir own version, first seen Nov 6, 2026
- tsingyuai/scientifytheir own version, first seen Oct 8, 2026
- dongzhigang13305312738-art/paper-skillstheir own version, first seen Jul 21, 2026
- huangwb8/ChineseResearchLaTeXtheir own version, first seen Mar 17, 2026
Other versions5 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 5
- huangwb8/ChineseResearchLaTeX★ 3ksame name
- tsingyuai/scientify★ 2.2ksame name
- lalulali/vespyr★ 11same name
- dongzhigang13305312738-art/paper-skills★ 1same name
- miguelclavel/ux-research-skills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository10 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- deep-researchSkill
- experiment-executionSkill
- human-checkpointSkill
- memory-managerSkill
- paper-writingSkill
- project-contextSkill
- research-workflowSkill
- run-governorSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
24 rules. About 0 are common, 24 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈24
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 19
Default behavior after direction is fixed:
- Distinctive: line 22
Write the full detailed plan in one pass.
- Distinctive: line 23
Ask follow-up questions only for hard blockers or high-risk ambiguity.
- Distinctive: line 25
Do not turn normal planning into a back-and-forth questionnaire.
- Distinctive: line 40
Keep progress updates short while drafting.
- Distinctive: line 44
Use this skill when the user asks for any of the following:
- Distinctive: line 54
Every final plan must include all sections below.
- Distinctive: line 85
Follow this order unless the user explicitly asks for a lighter output:
- Distinctive: line 108
When the plan depends on repository choice, reproducibility, benchmark selection, or dataset alignment, apply …
- Distinctive: line 112
Do not produce vague items such as "run some experiments" or "evaluate performance."
- Distinctive: line 126
Use this experiment stack by default:
- Distinctive: line 133
Remove or vary each key component one at a time.
- Distinctive: line 135
Check scale, configuration, workload, or data sensitivity.
- Distinctive: line 137
Check domain shift, input perturbation, user variation, or annotation mismatch.
- Distinctive: line 163
Do not call something innovative if it is only:
- Distinctive: line 169
If novelty is weak, say so directly and reframe it as:
- Distinctive: line 177
Always make this section operational.
- Distinctive: line 220
If the user has not chosen the evaluation inputs, propose candidates and explain tradeoffs.
- Distinctive: line 224
If the plan needs broader coverage, specify extra experiment variants such as:
- Distinctive: line 242
Prefer ranges or decision thresholds over vague claims.
- Distinctive: line 263
Use tables when they make experiment plans easier to scan.
- Distinctive: line 265
When returning results to the user in chat, summarize the plan instead of pasting the full long-form document unless the user explicitly …
- Distinctive: line 278
If any answer is no, refine before responding.
- Distinctive: line 282
When drafting the plan, use references/research-plan-template.md as the default skeleton and checklist.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Research Plan
Mission
Turn an early-stage research idea into a concrete, execution-ready plan with clear experiments, implementation prerequisites, and expected results.
Interaction Policy
Once the user has chosen a direction, stop asking frequent clarification questions unless a missing detail would materially change the plan.
Default behavior after direction is fixed:
- Infer reasonable assumptions.
- Write the full detailed plan in one pass.
- Ask follow-up questions only for hard blockers or high-risk ambiguity.
Do not turn normal planning into a back-and-forth questionnaire.
Delivery Policy
Separate the full planning artifact from the chat summary.
- The full plan should still be detailed and complete.
- In the CLI chat, do not dump the entire long report unless the user explicitly asks for it.
- In the CLI chat, provide a concise summary focused on:
- key innovation points
- experiment plan
- code base and file requirements
- data or workload requirements
- expected results
- major risks
- Keep progress updates short while drafting.
When To Use
Use this skill when the user asks for any of the following:
- A research plan or proposal.
- A project plan before implementation.
- A paper idea breakdown into experiments.
- An ablation or evaluation roadmap.
- A study design for a general CS research project.
Non-Negotiable Output Sections
Every final plan must include all sections below. Do not omit a section just because the user did not mention it.
Problem Definition- What problem is being solved?
- Why does it matter?
- What exact question will the study answer?
Research Focus- State the core research points.
- Separate primary question, secondary questions, and boundary conditions.
Innovation Points- List specific novelty claims.
- Compare against likely baselines or common approaches.
- Distinguish true novelty from engineering cleanup.
Experiment Plan- Enumerate the exact experiments to run.
- Include baseline, main experiment, ablation, robustness, and error-analysis experiments when relevant.
- For each experiment: hypothesis, setup, variables, metrics, and success signal.
How To Do ItCode Base: what kind of repository or framework is needed.Related Files: configs, manifests, experiment scripts, evaluation scripts, request templates when needed, documentation, metadata, report templates, and logs.Data / Workloads / Inputs: required datasets, workloads, traces, corpora, benchmarks, or input sources; plus split policy, access constraints, and preprocessing if needed.
Expected Results- What outcomes are expected qualitatively and quantitatively.
- What negative or null outcomes are still informative.
Risk And Fallback- Technical risks, data risks, evaluation risks, and fallback routes.
Deliverables- What artifacts should exist at the end.
Default Planning Workflow
Follow this order unless the user explicitly asks for a lighter output:
- Restate the research objective in one sentence.
- Identify task type:
algorithmicsystemsdata or benchmarkinghuman-computer interactionsystem-evaluation
- Identify the primary unit of progress:
- accuracy or quality gain
- efficiency or cost reduction
- robustness improvement
- usability or workflow improvement
- scientific understanding
- Form 1-3 core hypotheses.
- Design the minimum baseline set.
- Design the main experiment set.
- Design ablations to isolate the claimed contribution.
- Design stress tests or out-of-domain checks where relevant.
- Specify the implementation foundation.
- Specify expected outcomes and decision rules.
When the plan depends on repository choice, reproducibility, benchmark selection, or dataset alignment, apply references/codebase-and-data-research-rules.md.
Experiment Design Rules
Do not produce vague items such as "run some experiments" or "evaluate performance."
Each experiment block should specify:
NamePurposeHypothesisIndependent VariablesControlled FactorsData / Workloads / Evaluation ScopeMetricsImplementation NotesExpected Outcome
Use this experiment stack by default:
Baseline- Reproduce a standard or strong practical baseline.
Main Method- Evaluate the proposed idea end to end.
Ablations- Remove or vary each key component one at a time.
Sensitivity- Check scale, configuration, workload, or data sensitivity.
Robustness- Check domain shift, input perturbation, user variation, or annotation mismatch.
Error Analysis- Identify where the method fails and why.
How To Write Research Focus
Research focus should be written as concrete questions, not generic themes.
Good:
- "Does the proposed indexing strategy reduce query latency under high-concurrency workloads without hurting recall?"
- "Which component contributes most: cache policy, partitioning scheme, or request scheduling?"
Weak:
- "Study system performance."
- "Improve performance."
How To Write Innovation Points
Innovation points must be defensible. Use this test:
Method novelty: a genuinely new mechanism, training strategy, architecture, or data construction method.Evaluation novelty: a benchmark, protocol, or measurement setup that reveals something existing work misses.System novelty: a workflow or tooling contribution that materially changes what can be studied.
Do not call something innovative if it is only:
- More tuning.
- More data without a justification.
- Routine engineering migration.
If novelty is weak, say so directly and reframe it as:
- strong empirical study
- practical system paper
- careful benchmark or evaluation study
How To Write "How To Do It"
Always make this section operational.
Code Base
Specify:
- Main language and framework.
- Experiment and execution entry points.
- Config system.
- Evaluation pipeline.
- Reproducibility requirements.
Examples:
- A language and framework already established in the target project.
- A reproducible config system for experiments and evaluation.
- An existing project-specific codebase when reproduction fidelity matters more than flexibility.
Related Files
Mention the concrete file classes the repo should contain:
run_experiment.pyor stage-specific experiment scriptseval.pyand metric wrappers- data manifests, workload definitions, or split files
- system or experiment configs
- experiment configs or request templates if applicable
- execution or evaluation scripts
- experiment registry or run sheet
- annotation instructions
- result summary tables
- failure case logs
Data / Workloads / Inputs
Always specify:
- Primary data source, workload, benchmark, trace, or corpus
- Validation, comparison, or test scope
- External or robustness inputs
- Licensing, access, or collection constraints
- Preprocessing, filtering, or normalization
If the user has not chosen the evaluation inputs, propose candidates and explain tradeoffs.
Additional Experiment Variants
If the plan needs broader coverage, specify extra experiment variants such as:
- domain shift or out-of-domain evaluation
- noisy or low-resource settings
- scale or configuration sensitivity
- user group or input-type variation
- execution-time cost or latency constraints
Expected Results Rules
Expected results must be specific enough to judge success.
Include:
Best-case outcomeExpected practical outcomeFailure-case interpretation
Prefer ranges or decision thresholds over vague claims.
Examples:
- "Expected 3-7% relative improvement on the primary success metric, with neutral or slightly improved performance on the stable reference workload."
- "A null result would suggest the proposed component adds complexity without improving the key bottleneck it was meant to address."
Output Format
By default, structure the final plan in this order:
- Title
- Objective
- Research Focus
- Innovation Points
- Experiment Plan
- How To Do It
- Expected Results
- Risks And Fallbacks
- Deliverables
Use tables when they make experiment plans easier to scan.
When returning results to the user in chat, summarize the plan instead of pasting the full long-form document unless the user explicitly requests the full text.
Required Quality Bar
Before finalizing, check:
- Are the experiments concrete enough to run?
- Are the research points framed as questions?
- Are innovation claims defended against obvious baseline objections?
- Are codebase, files, and data or workload requirements all specified?
- Are expected results measurable?
- Are failure cases still informative?
If any answer is no, refine before responding.
Reference
When drafting the plan, use references/research-plan-template.md as the default skeleton and checklist.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

