clarify
Use when the user has an idea, feature request, design direction, or product problem that is still ambiguous. Ask focused questions before PRD or implementation, and turn the answers into a short handoff summary.
How do I install this agent skill?
npx skills add https://github.com/yansfil/vibe-engineering --skill clarifyIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The 'clarify' skill is a development assistant tool designed to resolve ambiguity in user requests by exploring the local repository and asking targeted questions. It uses standard tools for file system navigation and content searching to gather context, following a structured workflow that prioritizes repository data over user surveys. It does not perform network operations or access sensitive system directories.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
clarify
Use this skill before planning or implementation when the request still has important ambiguity.
Do not write code, create a PRD, or change files while using this skill unless the user explicitly asks for notes to be saved.
Workflow
- Restate the current goal in 2-4 bullets.
- Explore the codebase freely as the conversation requires - read any docs, code, or config that could answer the question, and follow leads instead of asking the user what the repo can answer.
- Identify the 2-4 decisions that would most change the implementation.
- Ask one question at a time.
- For each question, include why it matters and a recommended default.
- Keep a compact running summary of decisions, assumptions, and deferred items.
- Stop when a PRD writer could proceed without guessing.
Question Rules
- Ask the smallest useful question, not a survey.
- Prefer concrete options with tradeoffs.
- Do not ask the user for facts that the repository can answer.
- If the user does not know, choose a tentative assumption and mark it clearly.
- Push on vague words such as simple, fast, MVP, admin, secure, nice, and done.
Handoff Format
## Current Goal
- ...
## Decisions
- ...
## Assumptions
- ...
## Deferred
- ...
## PRD Input
- Problem:
- Users:
- Scope:
- Non-goals:
- Acceptance signals:
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/yansfil/vibe-engineering/clarify">View clarify on skillZs</a>