smith-clarify

Name: smith-clarify
Availability: InStock
Author: ATTCK

Prompts for missing decisions in feature specs and records them as clarifications.

50|8|Updated Apr 12, 2026

Search Tags:#planning #requirements #clarification #spec #traceability #decision-record

Ready to run

npx skills add https://github.com/ATTCKDigital/smith --skill smith-clarify

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: smith-clarify
Source: https://github.com/ATTCKDigital/smith/tree/main/skills/smith-clarify
Command: npx skills add https://github.com/ATTCKDigital/smith --skill smith-clarify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify underspecified areas in feature specs by prompting clarifying questions and encoding answers back into the spec.

Core Features & Use Cases

Interactive clarification of active feature specs to surface missing decisions.
Automatic creation of a "## Clarifications" section with a per-session "### Session YYYY-MM-DD" block and bullet lines capturing Q → A.
Vault session logging of critical events and decisions during the clarification flow.
Resumable and interruptible session with persistence to the spec file and ability to continue later.

Quick Start

Run /smith-clarify to start the interactive clarification against the current feature spec.

Frequently Asked Questions about smith-clarify

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

FAQPage Schema

How do I identify ambiguity in a feature specification?▼

To identify ambiguity in a feature specification, run an interactive clarification flow that prompts targeted questions covering functional scope, data modeling, UX flows, non-functional constraints, and edge cases.

What is the best way to record decisions and clarify feature specs?▼

Recording decisions to clarify feature specs involves appending a dedicated clarifications section to the spec file, logging per-session bullet points that capture each question and its accepted answer.

How do I ensure my implementation plan covers non-functional constraints and edge cases?▼

To ensure an implementation plan covers non-functional constraints and edge cases, prompt clarifying questions within an interactive session that surfaces missing decisions and encodes them back into the spec.

Can I pause and resume a feature spec clarification session?▼

Yes, you can pause and resume a feature spec clarification session because the flow is interruptible and persists progress directly to the spec file, allowing you to continue later.

Does interactive spec clarification work without external dependencies?▼

Yes, interactive spec clarification works without external dependencies, using only the active feature specification file to log decisions and mitigate underspecified areas automatically.