Where are the specifications stored during this process?

Specifications are moved from the ./specs/draft/{spec-name} directory to the ./specs/active/{spec-name} directory, ensuring a clean separation of work-in-progress and ready-to-code tasks.

Can I promote a spec if a validation gate has failed?

No, failed gates for Initiatives will block promotion. Users must resolve the underlying issues that caused the gate failure before the spec can be moved to the active stage.

Does this skill update the actual content of my documentation?

Spec Promote specifically updates the YAML frontmatter in your spec.md file, changing the status and stage fields to 'Active' and adding the current promotion date.

What happens if there are unresolved markers in the spec?

The skill will identify any open markers in the validation.yaml file, warn you about the unresolved ambiguities, and ask for explicit confirmation before proceeding with the promotion.

Spec Promote

Name: Spec Promote
Author: srnnkls

bysrnnkls

0•

Productivity & Workflow

Transitions technical specifications from draft status to active implementation readiness by validating markers and updating metadata.

Spec Promote is a workflow automation skill for Claude Code designed to streamline the transition of technical specifications from the ideation phase to the execution phase. It automatically verifies that a specification has passed all required validation gates and resolved critical markers before moving files from the draft directory to the active directory. By updating frontmatter metadata and ensuring documentation completeness, it provides a reliable handoff for implementation tools, ensuring that only vetted and approved designs move into production.

Key Features

01Contextual awareness of existing draft specifications for easy selection

020 GitHub stars

03Automatic frontmatter metadata updates including status and promotion dates

04Interactive marker resolution alerts with override capabilities

05Automated directory migration from draft to active storage

06Validation gate checking to block promotion of failed initiatives

Use Cases

01Moving a validated feature specification into the implementation phase

02Ensuring architectural requirements are met before starting development

03Maintaining an organized project structure by separating draft ideas from active tasks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add srnnkls/tropos spec-promote

For use in Claude.ai and ChatGPT

Download Skill