clarify

Installation
SKILL.md

Clarify

Turn a rough request into a prompt another agent can execute.

Choose a mode

  • Refine directly when the goal is clear and missing details have safe defaults.
  • Interview when one unresolved choice would materially change behaviour, data, security, compatibility, cost, output, or proof.
  • Execute the clarified prompt only when the user explicitly asks to run it or says "just do it."

Process

  1. Read the request and any referenced material.
  2. For repository work, inspect discoverable context such as AGENTS.md, CLAUDE.md, README.md, the file tree, and relevant code before asking questions.
  3. Extract the goal, current state, inputs, outputs, constraints, scope boundaries, failure behaviour, and success checks.
  4. Resolve unambiguous references and project conventions from the available context.
  5. Use a sensible assumption when the user can change it later without reworking the task.
  6. Ask one question when no safe assumption exists. After the answer, check whether another important decision remains.
  7. Include all context needed to execute the prompt. Do not refer to "our discussion" or information outside the prompt.
Installs
99
GitHub Stars
43
First Seen
May 15, 2026
clarify — owainlewis/agent-skills