skills.rest
ATTCKDigital
ATTCKDigitalOFFICIAL
Explore all skills by this author →
Website𝕏@attckGitHub

smith-clarify

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
One-click install
npx skills add https://github.com/ATTCKDigital/smith --skill smith-clarify
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
BOUROUIS-MOHAMEDBOUROUIS-MOHAMED

speckit-clarify

Generate up to five clarification questions and apply answers to a feature specification.

Community
Advanced
jasonkneenjasonkneen
734

spec-driven-development

Transform vague feature ideas into EARS-based specifications with design documents and task plans.

Community
Advanced
ddunnockddunnock
10

specification-refiner

Analyze and refine specifications using the SEAMS gap-analysis framework.

Community
Advanced
cicero78Mcicero78M

speckit-clarify

Identify underspecified areas in a feature specification and update the SPEC file.

Community
Advanced