How does the Clarify skill update my documents?

It identifies the specific section, such as Requirements or Data Model, and naturally integrates your answers into the existing text rather than creating a separate list of notes.

Where does the skill store the history of changes?

All resolutions are recorded in a clarification_sessions log within your project's validation files, providing a complete audit trail of who decided what and when.

What happens if I skip a clarification question?

You can select the 'Defer' option, which keeps the item as an open marker to be addressed in a future session without blocking the current workflow.

Can I use Clarify for initial project validation?

No, it is designed for resolving specific identified gaps. Use the spec-validate skill for the initial scan and high-level project validation.

Interactive Clarification & Spec Update

Name: Interactive Clarification & Spec Update
Author: srnnkls

bysrnnkls

0•

Collaboration Tools

Resolves project ambiguities interactively by updating specifications and documentation with a full audit trail.

The Clarify skill automates the resolution of missing or ambiguous requirements by identifying gaps in technical specifications, code reviews, and active project initiatives. It engages users through context-aware Q&A sessions, then directly integrates the resulting decisions into the relevant source files—such as spec.md or context.md—ensuring that documentation remains a single source of truth without fragmented notes. By prioritizing high-impact areas like scope and behavior, it streamlines the transition from planning to implementation while maintaining a rigorous audit trail of every modification.

Key Features

01Context-aware ambiguity detection for specs and code reviews

02Interactive Q&A for rapid resolution of project gaps

030 GitHub stars

04Automatic synchronization with ambiguity scans and task markers

05Direct, in-place document updates to maintain a single source of truth

06Comprehensive session logging with an audit trail of all changes

Use Cases

01Clarifying feedback and questions raised during an automated code review

02Filling in missing data models or behavioral constraints in a technical spec

03Resolving blocking requirements before dispatching coding tasks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add srnnkls/tropos clarify

For use in Claude.ai and ChatGPT

Download Skill