Does it require previous steps to be completed?

Yes, it is designed as Step 5 of 6 in the reverse engineering process, typically requiring a gap analysis report from Step 4 (docs/gap-analysis-report.md) to exist.

What is the primary purpose of the Complete Specification skill?

It resolves [NEEDS CLARIFICATION] markers in your documentation by asking focused questions and updating spec files with the answers to ensure requirements are ready for development.

Can it detect conflicting requirements?

Yes, if an answer you provide contradicts a previously documented requirement in your spec files, the skill will explicitly surface the conflict and ask you to decide which takes priority.

What happens if I stop the process halfway through?

The skill maintains a hidden progress file at specs/.clarification-progress.md, allowing you to resume the Q&A exactly where you left off in a subsequent session.

How does it handle large numbers of clarifications?

It categorizes markers by priority (P0-P3) and presents them one at a time, summarizing progress every five items to maintain focus and prevent fatigue.

Complete Specification

Name: Complete Specification
Author: jschulte

byjschulte

•

生産性とワークフロー

Resolves ambiguity in software specifications through interactive Q&A to ensure complete and actionable requirements.

The Complete Specification skill automates the final refinement of software requirements by identifying and resolving [NEEDS CLARIFICATION] markers within specification files. As Step 5 in the reverse engineering to spec-driven development workflow, it systematically crawls your gap analysis reports and spec files, prioritizes missing details based on urgency (P0-P3), and engages the user in a focused, one-question-at-a-time Q&A session. It ensures that every requirement is unambiguous and conflict-free by validating answers against existing documentation and maintaining a persistent progress log for complex projects.

主な機能

01Automated identification and extraction of clarification markers from specification files

021 GitHub stars

03Persistent state management via a progress file to resume work seamlessly across sessions

04Real-time specification updates with immediate verification to ensure document integrity

05Conflict detection that surfaces contradictions between new input and previously documented requirements

06Prioritized interactive Q&A session to resolve missing features, UX details, and business rules

ユースケース

01Finalizing technical specifications before moving into the implementation phase of a project

02Systematizing requirements gathering for complex features involving multiple business rules

03Bridging documentation gaps discovered during the reverse engineering of legacy systems

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jschulte/claude-plugins complete-spec

For use in Claude.ai and ChatGPT

Download Skill