Agent skill

Clarify Research Idea

by cpt13-g in cpt13-g/clarify-research-idea

Turn vague or partially formed AI, computer-science, data-driven, and engineering-method research directions into evidence-grounded, falsifiable, paper-ready Research Idea Briefs through heuristic…

No licenceAuto-check passedResearch & Science

Install Clarify Research Idea

skills CLI
$ npx skills add cpt13-g/clarify-research-idea --skill clarify-research-idea -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install cpt13-g/clarify-research-idea clarify-research-idea --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/cpt13-g/clarify-research-idea.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/clarify-research-idea .claude/skills/clarify-research-idea && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
clarify-research-idea
GitHub stars
242
Token cost
~2.6k tokens
SKILL.md length
1,198 words
Files
9 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

Turn vague or partially formed AI, computer-science, data-driven, and engineering-method research directions into evidence-grounded, falsifiable, paper-ready Research Idea Briefs through heuristic…

  • Works in 7 steps: Scope the session → Establish the Task Contract → Make the argument and framing explicit → …
  • The user needs to clarify a research idea
  • SKILL.md covers Choose the operating mode, Run the heuristic interaction…, Maintain provenance and Run the workflow, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Clarify Research Idea is an agent skill from cpt13-g/clarify-research-idea. Turn vague or partially formed AI, computer-science, data-driven, and engineering-method research directions into evidence-grounded, falsifiable, paper-ready Research Idea Briefs through heuristic questioning, staged confirmation, literature positioning, novelty attack, and method-figure planning. Use when the user needs to clarify a research idea, formalize inputs/outputs/objectives/constraints, frame background and motivation, select 3-5 anchor papers, identify a defensible gap, derive 2-3 contributions…

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including reference files (for example `agents/openai.yaml`, `references/anchor-paper-positioning.md` and `references/framework-figure.md`).

It sits in Research & Science, covering Hypothesis generation. The repository describes itself as: Turn vague research directions into falsifiable, evidence-grounded Research Idea Briefs with a six-stage Codex workflow.

When your agent uses it

  • The user needs to clarify a research idea
  • Formalize inputs/outputs/objectives/constraints
  • Frame background and motivation
  • Select 3-5 anchor papers

Example prompts

  • “/clarify-research-idea”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Scope the session
  2. Establish the Task Contract
  3. Make the argument and framing explicit
  4. Position against 3-5 anchor papers
  5. Derive and attack the idea
  6. Design the method architecture and core figure
  7. Compile and audit the Research Idea Brief

What it can do on your machine

Read from SKILL.md and the folder at commit 1f8334d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Clarify Research Idea loads about 2.6k tokens when it runs, and up to ~8.7k if it reads all its reference files. Until then it costs about 221 tokens; SKILL.md has 1,198 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~221
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,198 words (~2,564 tokens).

“Convert an early research direction into an auditable idea architecture before detailed experiment design or manuscript writing. Preserve the researcher's judgment: make assumptions and framing visible, challenge weak novelty, and never manufacture supporting evidence.”

— opening of SKILL.md by cpt13-g
name
clarify-research-idea

Read the full SKILL.md on GitHub

Files

SKILL.md and 8 other files (references) in .agents/skills/clarify-research-idea of cpt13-g/clarify-research-idea.

  • SKILL.md
  • agents/openai.yaml
  • references/anchor-paper-positioning.md
  • references/framework-figure.md
  • references/framing-and-motivation.md
  • references/interactive-heuristics.md
  • references/novelty-and-falsification.md
  • references/output-schema.md
  • references/task-formalization.md

Open the folder on GitHubat commit 1f8334d

Compare with similar skills

Clarify Research Idea next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Clarify Research Idea compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Clarify Research Idea this skillcpt13-g/clarify-research-idea242—~2.6kAutomated safety check: PassNone
Hypothesis Generationspacering-net/codeg3.9k14 repos~3.6kAutomated safety check: NotesMIT
Nature Paper CardYuan1z0825/nature-skills47k2 repos~2.1kAutomated safety check: PassApache-2.0
Hypothesis GenerationK-Dense-AI/claude-scientific-writer2.4k2 repos~3.9kAutomated safety check: PassMIT
Good QuestionRimagination/good-question3051 repos~4.3kAutomated safety check: PassMIT
High Stakes Analytics Decision Lablimingrui679-design/high-stakes-analytics-decision-lab1k—~2.2kAutomated safety check: PassMIT

Similar skills

  • Hypothesis Generation

    spacering-net/codeg

    Structured hypothesis formulation from observations. An agent skill from spacering-net/codeg.

    3.9k GitHub starsUsed in 14 repos~3.6k tokens
    Research & ScienceAuto-check: notes
  • Nature Paper Card

    Yuan1z0825/nature-skills

    Builds a structured deep-reading card for one scientific paper, covering methods, how experiments support claims, limitations and research ideas, with a script to prepare the source.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed
  • Hypothesis Generation

    K-Dense-AI/claude-scientific-writer

    Formulate evidence-bounded scientific questions, candidate hypotheses, rival explanations, causal or associational claims, discriminating predictions, measurements, and preregistration-ready…

    2.4k GitHub starsUsed in 2 repos~3.9k tokens
    Research & ScienceAuto-check passed
  • Good Question

    Rimagination/good-question

    A skill your agent uses when a researcher is choosing, framing, refining, or stress-testing a research question, hypothesis, thesis topic, project idea, grant direction, paper angle, or stalled…

    305 GitHub starsUsed in 1 repo~4.3k tokens
    Research & ScienceAuto-check passed
  • High Stakes Analytics Decision Lab

    limingrui679-design/high-stakes-analytics-decision-lab

    Build or review source-backed descriptive, diagnostic, predictive, and prescriptive analysis for consequential decisions.

    1k GitHub stars~2.2k tokensUpdated 5 days ago
    Research & ScienceAuto-check passed
  • Claim-Driven Experiment Planner

    zjYao36/Auto-Research-Refine

    Turns a refined research proposal into a claim-to-evidence-to-run-order roadmap instead of a sprawling benchmark wishlist.

    128 GitHub starsUsed in 6 repos~2.3k tokens
    Research & ScienceAuto-check: notes

Questions about Clarify Research Idea

What does Clarify Research Idea do?

Turn vague or partially formed AI, computer-science, data-driven, and engineering-method research directions into evidence-grounded, falsifiable, paper-ready Research Idea Briefs through heuristic…. Clarify Research Idea is an agent skill from cpt13-g/clarify-research-idea. Turn vague or partially formed AI, computer-science, data-driven, and engineering-method research directions into evidence-grounded, falsifiable, paper-ready Research Idea Briefs through heuristic questioning, staged confirmation, literature positioning, novelty attack, and method-figure planning.

When should I use Clarify Research Idea?

Clarify Research Idea fits situations like: the user needs to clarify a research idea; formalize inputs/outputs/objectives/constraints; frame background and motivation; select 3-5 anchor papers.

How do I install Clarify Research Idea in Claude Code?

Run `npx skills add cpt13-g/clarify-research-idea --skill clarify-research-idea -a claude-code`. Or copy the skill folder (.agents/skills/clarify-research-idea in cpt13-g/clarify-research-idea) into .claude/skills/clarify-research-idea in your project. Claude Code loads it when a task matches its description.

How do I install Clarify Research Idea in Codex?

Run `npx skills add cpt13-g/clarify-research-idea --skill clarify-research-idea -a codex`. Or copy the skill folder (.agents/skills/clarify-research-idea in cpt13-g/clarify-research-idea) into .agents/skills/clarify-research-idea in your project. Codex loads it when a task matches its description.

Can I use Clarify Research Idea in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cpt13-g/clarify-research-idea --skill clarify-research-idea -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clarify-research-idea, .gemini/skills/clarify-research-idea, .github/skills/clarify-research-idea and .opencode/skills/clarify-research-idea in your project.

What does Clarify Research Idea need to run?

SKILL.md names no scripts, command-line tools or credentials: Clarify Research Idea is instructions for the agent only.

Does Clarify Research Idea access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Clarify Research Idea safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Clarify Research Idea use?

No licence was found for Clarify Research Idea or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Clarify Research Idea use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 6.1k tokens, read only when the agent opens those files.

What are the alternatives to Clarify Research Idea?

Skills that share tags, products or a category with Clarify Research Idea: Hypothesis Generation (spacering-net/codeg, 3.9k stars), Nature Paper Card (Yuan1z0825/nature-skills, 47k stars), Hypothesis Generation (K-Dense-AI/claude-scientific-writer, 2.4k stars) and Good Question (Rimagination/good-question, 305 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Clarify Research Idea?

cpt13-g (a GitHub user) maintains it in cpt13-g/clarify-research-idea, which has 242 GitHub stars. The repository was last updated on July 26, 2026.

Source: cpt13-g/clarify-research-idea on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.