One-click install
npx skills add https://github.com/luan/agents --skill question-luan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: question
Source: https://github.com/luan/agents/tree/main/skills/question
Command: npx skills add https://github.com/luan/agents --skill question-luan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The question skill prevents wasted research and misaligned implementation by forcing early clarification of intent, scope, edge cases, defaults, and user preferences using evidence from existing docs and code.

Core Features & Use Cases

  • Doc- and code-grounded interviews: Searches and reads relevant vault artifacts and inspects the code for existing behavior and vocabulary, asking humans only for missing intent, tradeoffs, priorities, or domain facts.
  • Branch-by-branch design grilling: Walks the design tree through user-visible behavior, scope, ownership/persistence, compatibility/migration, failure cases, non-goals, and acceptance boundaries, updating the decision tree after each answer.
  • Reusable Question Summary handoff: Produces a structured Question Summary containing project vocabulary, evidence map, resolved answers with rationale, covered decision tree, blocking open questions, recommended defaults, and explicit non-goals.

Quick Start

Ask an AI to run the question phase for your feature request and return a Question Summary suitable for carrying into later QRDSPI phases.

Frequently Asked Questions about question

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

FAQPage Schema
How do I clarify product intent and scope before starting user research?

To clarify product intent and scope before research, interrogate existing documentation and code to map evidence, then grill stakeholders on missing tradeoffs, domain facts, and edge cases to resolve vocabulary and boundaries.

What is the best way to identify edge cases and design tradeoffs early?

Identifying edge cases and design tradeoffs early involves branch-by-branch design grilling across user behavior, persistence, and failure scenarios, updating the decision tree after each answer to capture explicit non-goals.

How do I avoid misaligned implementation when scoping new feature requirements?

Avoid misaligned implementation by grounding feature requirements in an evidence map from existing artifacts, asking humans only for missing intent and priorities, and producing a structured Question Summary handoff.

Can I use existing documentation to resolve missing domain facts for my design plan?

Yes, you can use existing documentation to resolve missing domain facts by searching and reading relevant vault artifacts and inspecting code for current behavior, asking humans only for unresolved tradeoffs or preferences.

What should I do if my team has unresolved blocking questions during requirements scoping?

During requirements scoping, isolate unresolved blocking questions by labeling uncertainty explicitly and compiling them into a Question Summary handoff with recommended defaults, rather than moving into implementation prematurely.

When should I not use intent clarification before moving into design and implementation?

You should not use intent clarification when vocabulary, scope, edge cases, defaults, and user preferences are already fully resolved, or when creating artifacts and moving into downstream design and implementation phases in the same turn.