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.