Skip to main content
skill CX Codex

question-refiner — Claude Code skill: what it does, how to install

question-refiner transforms a vague research question into a structured deep-research brief. Asks clarifying questions, collects requirements for format, sources and scope, then generates a ready-to-use prompt.

no license ★ 475 updated 2026-10-13

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add cnfjlhj/ai-collab-playbook --skill question-refiner -a claude-code
Open on GitHub

What question-refiner does

The skill operates in two stages. First, it asks a series of questions: what exactly you are researching, what output format you need, whether there are geographic or time constraints, which sources count as credible. Once all details are collected, it assembles a structured prompt with TASK, CONTEXT, SPECIFIC QUESTIONS, KEYWORDS, CONSTRAINTS, OUTPUT FORMAT and FINAL INSTRUCTIONS sections. A seven-point checklist verifies that every field is filled concretely.

The skill has a hard rule: do not answer the research question itself, only refine and formulate. If you provide incomplete answers, it asks the next round of questions. It will not generate the prompt without answers to clarifying questions: the author wanted to replace ChatGPT o3 for this task, and the strict sequence prevents delivering a vague brief.

The skill does not run the actual research, search literature or write reports.

What it helps with

  • turn a vague idea into a concrete research specification
  • gather all requirements for format, sources and scope before starting work
  • avoid the need to go to ChatGPT for question refinement
  • verify that the prompt includes timeframe, geography and source types

Example prompts for the agent

  • I need to research the AI tooling market for developers, but I don't know how to phrase it properly
  • Help me build a prompt for research on remote work's impact on team productivity
  • Ask me questions so I can figure out what I actually need to know about blockchain in logistics

How to install question-refiner

1Skills CLI (Vercel)

npx skills add cnfjlhj/ai-collab-playbook --skill question-refiner -a claude-code

2Manually: put the files in place

~/.claude/skills/question-refiner/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/question-refiner/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about question-refiner

How to install question-refiner in Claude Code?

Run npx skills add cnfjlhj/ai-collab-playbook --skill question-refiner -a claude-code, then open ~/.claude/skills/question-refiner/SKILL.md.

What does question-refiner do?

Transforms a vague research question into a structured prompt with sections for task, context, keywords, constraints and output format. First asks clarifying questions, then assembles a ready specification.

When should I skip question-refiner?

If you already have a paper draft or a ready research specification. The skill is useful at the question-formulation stage, not for executing the research itself.

Similar skills

All skills for Writing and docs →

From the same set18

The whole set →
论文精读 论文精读 is a Claude Code prompt for reading English academic papers paragraph by paragraph, preserving the original text and providing a scholarly Chinese translation and analytical commentary. GP ChatGPT ★ 475repo stars research-lead-sidecar The research-lead-sidecar skill keeps the lead agent on the critical path while bounded side tasks go to subagents. Use it for research-led work where the lead still needs to own the final decisions. CX Codex +1 ★ 475repo stars spec-first-mvp The spec-first-mvp skill stops development before implementation and requires a short spec, a list of throwaway probes, and a go/no-go decision point. CX Codex +1 ★ 475repo stars collaborating-with-gemini collaborating-with-gemini connects Gemini CLI as a second opinion for diff inspection, bug analysis, and prototyping via a Python bridge. CX Codex +1 ★ 475repo stars collaborating-with-codex collaborating-with-codex is a Claude Code skill that sends bounded coding tasks to a separate local or SSH-based Codex CLI session. Claude Code retains final edits and verification. CX Codex +1 ★ 475repo stars collaborating-with-claude collaborating-with-claude consults Claude Code CLI as an advisor for diff reviews and tradeoffs while your primary agent builds. CX Codex +1 ★ 475repo stars paper-review-pipeline paper-review-pipeline is a Claude Code skill that reviews near-final ML conference papers section by section, prioritizes issues from P0 to P2, and drafts rebuttal responses. CX Codex +1 ★ 475repo stars paper2html paper2html converts academic papers from arXiv, LaTeX or PDF into self-contained Chinese reading pages with KaTeX math and verified evidence. CX Codex +1 ★ 475repo stars

Project sponsors

Companies that keep this analytics open