research-ideation
- Repo stars 1,203
- Author updated Live
- Author repo claude-code-my-workflow
- Domain
- Data
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 88 / 100 · community maintained
- Author / version / license
- @pedrohcgs · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No special requirements
- Permissions
-
- Read-only
- Write / modify
- Shell exec
- Network behavior
- Local-only
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: research-ideation
description: Generate structured research questions, testable hypotheses, and candidate empirical strategies…
category: data
runtime: no special runtime
---
# research-ideation output preview
## PART A: Task fit
- Use case: Generate structured research questions, testable hypotheses, and candidate empirical strategies from a topic, phenomenon, or dataset description. Use when user says "give me research ideas on X", "brainstorm questions about Y", "what could I study with this data?", "I'm looking for a paper idea on...", "generate hypotheses for...". One-shot generation, not multi-turn. For idea-refinement use `/interview-me`..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “Steps / Output Format / Overview” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “Generate structured research questions, testable hypotheses, and candidate empirical strategies from a topic, phenomenon, or dataset description. Use when user says "give me research ideas on X", "brainstorm questions about Y", "what could I study with this data?", "I'm looking for a paper idea on...", "generate hypotheses for...". One-shot generation, not multi-turn. For idea-refinement use `/interview-me`.”.
- **02** When the source has headings, the agent prioritizes “Steps / Output Format / Overview” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, write/modify files, run shell commands; mostly runs locally; usually needs no extra API key.
## Running Rules
- read files, write/modify files, run shell commands; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source mentions slash commands such as `/interview-me`; use them first when your agent supports command triggers.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, write/modify files, run shell commands.
Start with a small task and check whether the result follows “Steps / Output Format / Overview”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: research-ideation
description: Generate structured research questions, testable hypotheses, and candidate empirical strategies…
category: data
source: pedrohcgs/claude-code-my-workflow
---
# research-ideation
## When to use
- Generate structured research questions, testable hypotheses, and candidate empirical strategies from a topic, phenomen…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “Steps / Output Format / Overview” and keep inference separate from source facts.
- read files, write/modify files, run shell commands; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "research-ideation" {
input -> user goal + target files + boundaries + acceptance criteria
context -> Steps / Output Format / Overview
rules -> SKILL.md triggers / order / output contract
runtime -> no special runtime | read files, write/modify files, run shell commands | mostly runs locally
guardrails -> usually needs no extra API key + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} Research Ideation
Generate structured research questions, testable hypotheses, and empirical strategies from a topic, phenomenon, or dataset.
Input: $ARGUMENTS — a topic (e.g., "minimum wage effects on employment"), a phenomenon (e.g., "why do firms cluster geographically?"), or a dataset description (e.g., "panel of US counties with pollution and health outcomes, 2000-2020").
Steps
Understand the input. Read
$ARGUMENTSand any referenced files. Checkmaster_supporting_docs/for related papers. Check.claude/rules/for domain conventions.Generate 3-5 research questions ordered from descriptive to causal:
- Descriptive: What are the patterns? (e.g., "How has X evolved over time?")
- Correlational: What factors are associated? (e.g., "Is X correlated with Y after controlling for Z?")
- Causal: What is the effect? (e.g., "What is the causal effect of X on Y?")
- Mechanism: Why does the effect exist? (e.g., "Through what channel does X affect Y?")
- Policy: What are the implications? (e.g., "Would policy X improve outcome Y?")
Tag each RQ with a likely paper type (drawn from
methods-referee.md):reduced-form(DiD, IV, RD, event study, synthetic control)structural(estimation of a fully-specified model)theory+empirics(formal model + empirical test of its predictions)descriptive(measurement, data construction, pattern documentation)formal-theory(pure theory, no empirical test in this paper)survey-experiment(vignette, conjoint, list-experiment)unsure(when multiple types are plausible — the user can pick later via/interview-me)
Use
.claude/references/discipline-cards.mdto bias the distribution by field (econ vs poli-sci default frequencies differ — e.g., poli-sci skews more towardsurvey-experimentandformal-theorythan econ does).For each research question, develop:
- Hypothesis: A testable prediction with expected sign/magnitude
- Identification strategy: How to establish causality (DiD, IV, RDD, synthetic control, etc.)
- Data requirements: What data would be needed? Is it available?
- Key assumptions: What must hold for the strategy to be valid?
- Potential pitfalls: Common threats to identification
- Related literature: 2-3 papers using similar approaches
Rank the questions by feasibility and contribution.
Save the output to
quality_reports/research_ideation_[sanitized_topic].md
Output Format
# Research Ideation: [Topic]
**Date:** [YYYY-MM-DD]
**Input:** [Original input]
## Overview
[1-2 paragraphs situating the topic and why it matters]
## Research Questions
### RQ1: [Question] (Feasibility: High/Medium/Low)
**Type:** Descriptive / Correlational / Causal / Mechanism / Policy
**Paper type:** reduced-form / structural / theory+empirics / descriptive / formal-theory / survey-experiment / unsure
**Hypothesis:** [Testable prediction]
**Identification Strategy:**
- **Method:** [e.g., Difference-in-Differences]
- **Treatment:** [What varies and when]
- **Control group:** [Comparison units]
- **Key assumption:** [e.g., Parallel trends]
**Data Requirements:**
- [Dataset 1 — what it provides]
- [Dataset 2 — what it provides]
**Potential Pitfalls:**
1. [Threat 1 and possible mitigation]
2. [Threat 2 and possible mitigation]
**Related Work:** [Author (Year)], [Author (Year)]
---
[Repeat for RQ2-RQ5]
## Ranking
| RQ | Feasibility | Contribution | Priority |
|----|-------------|-------------|----------|
| 1 | High | Medium | ... |
| 2 | Medium | High | ... |
## Suggested Next Steps
1. [Most promising direction and immediate action]
2. [Data to obtain]
3. [Literature to review deeper]
Post-Flight Verification (mandatory, CoVe)
Before returning the ideation report, run the Post-Flight Verification protocol from .claude/rules/post-flight-verification.md. Research ideation is hallucination-prone in three specific ways:
- Negative-literature claims — "no prior work studies X" is frequently wrong.
- Dataset structure claims — "The CPS contains field
educ_attain" can be confidently wrong about variable names, coverage years, or restricted-access status. - Estimator feasibility claims — "this works with panel fixed effects" can misstate an identification assumption.
Steps
- Extract claims from the draft ideation report: each negative-literature claim, each named dataset with attributed fields, each claimed identification strategy + required data structure.
- Generate verification questions per claim. Example: "Has Card & Krueger, Autor, or anyone in the last 10 years studied X? Search Google Scholar + NBER working papers." / "Does IPUMS-CPS include the
educ_attainvariable 1990–2024?" - Spawn
claim-verifierviaTaskwithsubagent_type=claim-verifierandcontext=fork. Hand it claims + questions + source pointers (WebSearch allowed, NBER/SSRN URLs preferred, dataset codebooks preferred). Do NOT include the draft. - Reconcile: PASS → attach green block; PARTIAL → mark uncertain RQs with flags; FAIL → rewrite the affected RQ/hypothesis/strategy.
Skip conditions
--no-verifyflag- User explicitly says "I'll verify the literature myself"
Principles
- Be creative but grounded. Push beyond obvious questions, but every suggestion must be empirically feasible.
- Think like a referee. For each causal question, immediately identify the identification challenge.
- Consider data availability. A brilliant question with no available data is not actionable.
- Suggest specific datasets where possible (FRED, Census, PSID, administrative data, etc.).
Decide Fit First
Design Intent
How To Use It
Boundaries And Review