Skip to main content

subagent

query-clarifier — Claude Code subagent: setup and use

Checks a research request for ambiguity and scope, then decides whether the user should clarify it before research starts.

Install into Claude Code · claude-code-templates All methods and platforms ↓

npx claude-code-templates@latest --agent deep-research-team/query-clarifier

What query-clarifier does

This subagent reviews a research request before work begins. It looks for vague wording, competing interpretations, missing scope, unclear goals, and topics that are too broad. It then chooses whether to proceed, refine the request, or ask the user for clarification.

Its response is a JSON object containing the decision, confidence score, short reasoning, clarification questions, a revised query, and focus areas. The configured tools are Read, Write, and Edit. That keeps query-clarifier focused on shaping the research request rather than conducting the research itself.

For Claude Code, setup uses npx and the file .claude/agents/query-clarifier.md. The repository entry also provides agent paths for Codex and Cursor.

What it helps with

check a query before research
spot vague research wording
narrow an overly broad topic
ask focused clarification questions
return a structured query assessment

Example prompts for the agent

Review this research request and tell me whether clarification is needed: “Compare tools for data analysis.”
Assess “Tell me about AI” and ask only the questions needed to make the research actionable.
Return the query review as JSON using the subagent’s required structure.

How to install query-clarifier

1claude-code-templates

npx claude-code-templates@latest --agent deep-research-team/query-clarifier

2Manually: put the files in place

.claude/agents/query-clarifier.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Manually: put the files in place

.codex/agents/query-clarifier.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Manually: put the files in place

.cursor/agents/query-clarifier.md

Cursor also reads .claude/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about query-clarifier

How do I install query-clarifier in Claude Code?

Run npx claude-code-templates@latest --agent deep-research-team/query-clarifier, then use .claude/agents/query-clarifier.md.

What does query-clarifier do?

It checks a research request for ambiguity, missing scope, and unclear goals. It then proceeds, refines the query, or asks for clarification.

Which tools does the subagent use?

Its configuration lists Read, Write, and Edit. The result is JSON with a decision, questions, a refined query, and focus areas.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

explore-code lllllllama A skill for cautious code experiments in deep learning repositories: it transplants modules and adapts architectures on an isolated branch, with rollback-aware records. CX Codex +1 336,700installs firecrawl-research-index firecrawl A skill that finds papers for a research query in Firecrawl's index: semantic search over abstracts, citation-based expansion, and in-body verification. CX Codex +1 24,400installs tavily-research tavily-ai Runs deep web research via the Tavily CLI and returns a structured report with source citations. Useful for market reviews and multi-source technical comparisons. CX Codex +1 22,000installs parallel-deep-research parallel Runs multi-step deep research jobs using parallel-cli. Use it when you need an exhaustive markdown report with citations rather than a quick web search. CX Codex +1 15,600installs learn tw93 A six-phase research workflow that turns source material into notes, an outline, or a publish-ready draft. Use it for unfamiliar domains and multi-source work. CX Codex +1 13,200installs tanstack-query-best-practices DeckardGer A rule set for TanStack Query in React: query keys, caching, mutations, SSR. Installs into Claude Code, Codex, Cursor or Copilot so data fetching follows one pattern across the repo. CX Codex +1 12,800installs

From the same set361

The whole set →

create-onboarding-guide Scans your project repository to generate tailored onboarding documentation for new team members. It extracts stack details and workflows directly from config files. 835installs data-feeds This skill turns URLs from 40+ websites into structured JSON through Bright Data. Use it for products, profiles, reviews, posts, or comments. 816installs supabase-backup-manager A Claude slash command that runs Supabase database backups: takes snapshots, validates restores and manages the schedule. 812installs optimize-database-performance A Claude slash command that walks through slow queries, indexes and schema, then tells you what to rewrite. Useful when a page stalls on one SELECT. 794installs mcp-protocol-specialist A subagent for Model Context Protocol work: transports, JSON-RPC 2.0, versioning and compliance across implementations. 781installs supabase-realtime-monitor Inspect Supabase Realtime connections, find subscription code in a project, and focus analysis on performance, errors, or connection status. 764installs draw-io A Claude skill that edits .drawio XML, converts diagrams to PNG and fixes element layout. 757installs visual-analysis-ocr Reads text from PNG images, maps document structure, and turns the result into markdown. Useful for scans and visual documents. 742installs

Project sponsors

Companies that keep this analytics open

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor