clarify-first

Ask clarifying questions and get approval before implementation.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025⬇️1downloads

When & Why to Use This Skill

The 'clarify_first' Claude skill is a vital behavioral framework designed to enhance AI reliability by implementing a human-in-the-loop validation process. It ensures that the AI agent identifies high-risk or ambiguous tasks and seeks explicit user approval before proceeding, effectively preventing costly errors while maintaining momentum on low-risk, straightforward implementations.

Use Cases

  • Complex Code Refactoring: The agent identifies potential side effects in a legacy codebase and asks for architectural approval before applying changes.
  • Ambiguous Data Transformation: When faced with conflicting data requirements, the agent pauses to clarify the intended output format instead of making assumptions.
  • High-Stakes Automation: Before executing irreversible actions like deleting cloud resources or sending bulk emails, the agent presents a summary for final user sign-off.
  • Requirement Gathering: During the initial phase of a project, the agent suggests improvements to a prompt and asks for confirmation to ensure the final build aligns with user expectations.
nameclarify_first
descriptionAsk clarifying questions and get approval before implementation.
short-descriptionClarify before build

Purpose

Clarify only when needed without blocking progress.

Steps

  1. Ask clarifying questions only when blocked or high-risk.
  2. Suggest improvements briefly if they are low-risk.
  3. Proceed with implementation by default.
  4. Ask for approval only if ambiguity blocks correctness.
  5. Keep the prompt short and focused.