targeted-questions

Asks minimal high-value factual questions and persists answers in task repository files.

6|Updated Jul 10, 2026
One-click install
npx skills add https://github.com/Mozurok/fhorja.dev --skill targeted-questions-mozurok
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: targeted-questions
Source: https://github.com/Mozurok/fhorja.dev/tree/main/.claude/skills/targeted-questions
Command: npx skills add https://github.com/Mozurok/fhorja.dev --skill targeted-questions-mozurok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineering tasks often stall or go wrong because critical facts are missing, yet asking broad or redundant questions wastes time. This Skill identifies only the factual gaps that materially affect correctness, scope, testing, rollout, or runtime behavior, asks the minimum set of questions, and records confirmed facts in the task repository so context survives across sessions. ## Core Features & Use Cases - Minimal question generation: Filters out questions answerable from code, tests, docs, or existing task artifacts, and groups remaining questions by category (business rule, contract, schema, runtime, tests, rollout). - Task state persistence: Updates TASK_STATE.md with open blockers, confirmed facts, and next steps, and writes to DECISIONS.md only when evidence-backed resolutions exist. - Unattended-run safety: In background or fleet-dispatched runs, records open questions as [NEEDS CLARIFICATION] markers instead of inventing answers. - Use Case: After an impact analysis reveals uncertainty about an API payload contract, run this Skill to produce three targeted questions, update TASK_STATE.md with the blockers, and route to the correct next command once answers arrive. ## Quick Start Ask the agent to run targeted-questions on the active task to identify the minimum factual questions needed before planning can proceed safely.

Frequently Asked Questions about targeted-questions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clarify missing requirements before starting implementation?▼

Run targeted-questions on the active task to generate only the factual questions that materially affect correctness, scope, testing, or rollout. It skips anything answerable from code, tests, or existing artifacts and records results in TASK_STATE.md.

What is the difference between targeted-questions and decision-interview?▼

targeted-questions resolves factual gaps, such as unknown payload contracts or runtime behavior. decision-interview handles missing policy or behavioral decisions. Use targeted-questions when correctness depends on unconfirmed facts, not on choices.

Can targeted-questions run unattended in background or automated sessions?▼

Yes, but it never self-answers. Open questions are recorded as [NEEDS CLARIFICATION] markers in the task artifacts, and the run stalls or escalates to the next human session rather than inventing facts.

When should I not use targeted-questions?▼

Skip it when enough information already exists to move safely into planning, when the gap is a decision rather than a fact, or when the task is already in implementation and the missing information is not correctness-critical.

Does targeted-questions modify project files?▼

It updates TASK_STATE.md with open blockers, confirmed facts, and next steps, and writes to DECISIONS.md only when a question is resolved by explicit evidence. If nothing materially changes, it emits a no-op note instead of churning files.