manage-specs

Audit and update specification files in the specs/ directory.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/softwareByAndi/workflow --skill manage-specs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: manage-specs
Source: https://github.com/softwareByAndi/workflow/tree/main/.claude/skills/manage-specs
Command: npx skills add https://github.com/softwareByAndi/workflow --skill manage-specs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires npm, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that the project's specification files (specs/) are accurate, up-to-date, and well-organized, reflecting the current state of the source code and project architecture.

Core Features & Use Cases

  • Audit Spec Files: Automatically checks for inconsistencies between source code changes and spec documentation.
  • Update Stale Specs: Identifies and updates specifications that have become outdated due to code modifications.
  • Create New Specs: Assists in scaffolding and documenting new features or subsystems.
  • Restructure Spec Tree: Helps maintain a logical hierarchy within the specification documentation.
  • Use Case: After refactoring a core module, run this Skill to ensure all related specifications are updated and accurate, preventing documentation drift.

Quick Start

Run the manage-specs skill to perform a full audit of all spec files.

Frequently Asked Questions about manage-specs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit spec files to prevent documentation drift after refactoring?▼

To audit spec files and prevent documentation drift, compare your `specs/` directory against recent changes in `src/` and `resources/` source files. This process identifies outdated specifications by mapping source file modifications to their corresponding documentation.

What is the best way to maintain specification files for an existing codebase?▼

The best way to maintain specification files is to run an automated audit that enforces a strict frontmatter schema and Markdown body format. This ensures all documents in the `specs/` directory accurately reflect the current source code architecture.

How do I create new specs that map to my source files?▼

To create new specs that map to your source files, scaffold specification documents by mapping source files to their architectural purposes. This enforces a strict frontmatter schema and Markdown body format for all new subsystem documentation.

Do I need npm to run manage-specs for code audits?▼

Yes, you need npm installed to run manage-specs for code audits. npm is a required dependency to execute the scripts that identify stale specifications and maintain the specification directory structure.

Why does my spec file audit fail when checking the Markdown body format?▼

Your spec file audit fails because all specification documents must adhere to a strict frontmatter schema and Markdown body format. Deviations from this enforced structure within the `specs/` directory will trigger validation errors during the code audit.

Can I restructure the spec tree hierarchy for a large project architecture?▼

Yes, you can restructure the spec tree hierarchy for a large project architecture. The skill helps maintain a logical document structure within the `specs/` directory by organizing specifications according to source file relationships.