This is a discipline tool for when you catch yourself about to build something you don't fully understand yet. It forces Claude to stop, identify what's actually unclear about a task, and ask one focused question at a time instead of guessing or overbuilding. The workflow is lightweight: check project docs if they exist, spot the gaps (objective, scope, constraints, success criteria), then ask sequentially with multiple choice options when possible. No code gets written, no plans get drafted. It's basically a guard rail against the "I'll just assume what they meant" reflex. Works best when you're staring at a vague feature request and need to extract real requirements without twenty back-and-forth messages.

skills.sh installs
213
GitHub stars
48
last updated
Jun 3, 2026

Install

$ npx -y skills add buiducnhat/agent-skills --skill ask --agent claude-code

Installs into .claude/skills of the current project.

Files

Ask

Workflow

Step 1: Gather Project Context

Load only the project context relevant to the current task:

  • If docs/SUMMARY.md exists, read it first.
  • Load only task-relevant detail docs.
  • Prioritize Code Standard docs for implementation conventions.
  • If docs conflict with code or user intent, use the available input/question before broad changes.

Skip this step if no project docs or useful repository files exist.

Step 2: Identify Information Gaps

Determine exactly what is missing before a task can proceed:

  • Objective and user value
  • Scope boundaries and non-goals
  • Constraints (technical, UX, performance, timeline)
  • Success criteria
  • Key decisions with multiple valid options

Step 3: Ask Questions (One at a Time)

Ask targeted questions sequentially to close each gap.

Rules:

  • Ask exactly one question per message
  • Prefer multiple-choice options when practical (2–4 choices)
  • Use open-ended questions only when no reasonable options exist
  • Do not ask questions already answered by project documentation
  • Do not ask about implementation details prematurely
  • Do not bundle multiple questions into one message

Rules

Sponsors

Details

Repository
github.com/buiducnhat/agent-skills
Category
AI & Agent Building
First seen
Jun 3, 2026

More from buiducnhat/agent-skills

All 12
1jorgealves avatark8s-resource-optimizerjorgealves/agent_skillsAnalyzes Kubernetes resource usage metrics and historical data to suggest optimal CPU and Memory requests and limits. Use to reduce cloud costs, prevent OOMKill213skills.sh installs
2unclecatvn avatarpayment-integrationunclecatvn/agent-skillsIntegrate payments with SePay (VietQR), Polar, Stripe, Paddle (MoR subscriptions), Creem.io (licensing). Checkout, webhooks, subscriptions, QR codes, multi-prov213skills.sh installs
3daffy0208 avatarlivestream-engineerdaffy0208/ai-dev-standardsExpert in live streaming, WebRTC, and real-time video/audio212skills.sh installs
4fabriciofs avatarsqlserver-expertfabriciofs/mcp-sql-serverExpert in Microsoft SQL Server development and administration. Use when writing T-SQL queries, optimizing database performance, designing schemas, configuring S212skills.sh installs
5github avatarui-screenshotsgithub/awesome-copilotCapture screenshots of web apps during development using Playwright and PIL. Supports full-page captures, interactive states, and an iterate-on-crop workflow th212skills.sh installs
6appwrite avatarappwrite-kotlinappwrite/agent-skillsappwrite kotlin210skills.sh installs