# question-refiner

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 475 repo stars
- Author: cnfjlhj
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cnfjlhj/ai-collab-playbook/tree/HEAD/skills/full/question-refiner/SKILL.md
- Updated: 2026-10-13
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/question-refiner

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill question-refiner -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/question-refiner/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/question-refiner/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill question-refiner -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/question-refiner/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill question-refiner -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/question-refiner/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cnfjlhj/ai-collab-playbook skills/full/question-refiner
```

2. **Manually: put the files in place**
- File: `.github/skills/question-refiner/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add cnfjlhj/ai-collab-playbook --skill question-refiner -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/cnfjlhj/ai-collab-playbook --path skills/full/question-refiner
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/question-refiner/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/cnfjlhj/ai-collab-playbook/tree/HEAD/skills/full/question-refiner/SKILL.md

## When to use it
- 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
- 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

## Similar
- [stock-question-refiner](https://affpapa.org/en/nevibecode/skills/stock-question-refiner.md) — skill · 369 installs
- [deep-research](https://affpapa.org/en/nevibecode/skills/autohandai-deep-research.md) — skill · ★ 219 repo stars
- [good-question](https://affpapa.org/en/nevibecode/skills/good-question.md) — skill · ★ 240 repo stars
- [paper-reading-research-question](https://affpapa.org/en/nevibecode/skills/paper-reading-research-question.md) — skill · ★ 240 repo stars
- [research-executor](https://affpapa.org/en/nevibecode/skills/research-executor.md) — skill · 114 installs
- [research-question](https://affpapa.org/en/nevibecode/skills/research-question.md) — skill · ★ 185 repo stars

From the same set: [cnfjlhj/ai-collab-playbook](https://affpapa.org/en/nevibecode/by/cnfjlhj/ai-collab-playbook.md) — 18 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
