Can I use this to update statuses in any Markdown file?

This skill is specifically optimized for ADRs and OpenSpec files located in standard documentation paths like docs/adrs/ and docs/openspec/.

Does it modify the actual content of my ADR?

No, the skill is designed to only modify the status field within the YAML frontmatter and will not touch your architectural descriptions or diagrams.

What are the valid statuses for an ADR?

The skill enforces standard ADR statuses: proposed, accepted, deprecated, and superseded.

What happens if I don't provide a specific status?

The skill will identify the current status of the file and present you with a list of valid status options to choose from via an interactive prompt.

What if my file doesn't have YAML frontmatter yet?

If no frontmatter exists, the skill will automatically generate and insert the necessary YAML block at the top of the file.

ADR and Spec Status Manager

Name: ADR and Spec Status Manager
Author: joestump

byjoestump

•

Learning & Documentation

Updates the lifecycle and approval status of Architecture Decision Records (ADRs) and OpenSpec specifications via YAML frontmatter.

The Status skill automates the management of technical documentation lifecycles by updating the status fields within ADRs and OpenSpecs. It allows users to quickly transition documents through standardized states—such as moving from 'proposed' to 'accepted' or 'draft' to 'review'—without manual file editing. By leveraging intelligent file discovery and status validation, this skill ensures consistency across architectural documentation and streamlines the decision-tracking process directly within the Claude Code environment.

Key Features

01Standardized status validation for architectural lifecycles

02Interactive prompts for selecting files and valid status options

03Automated YAML frontmatter updates for ADR and SPEC files

04Support for Docusaurus and OpenSpec documentation structures

05Intelligent file discovery using ADR-XXXX and SPEC-XXXX identifiers

064 GitHub stars

Use Cases

01Approving a proposed architectural change after a successful team review

02Marking an outdated specification as deprecated or superseded by a newer version

03Transitioning a new technical specification from draft to active review status

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add joestump/claude-plugin-design status

For use in Claude.ai and ChatGPT

Download Skill