Skills
.Work. You
Rest

specs-review

Official

Audit spec health and keep projects aligned.

Product & Management#architecture#documentation#audit#drift#tickets#specs
Authorb12consulting
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Audits the health and consistency of a project's spec-driven documentation, helping teams ensure that specifications stay up to date, detect drift between code and specs, and identify stale or incomplete tickets across Vision, PRD, Goals, Architecture, and tickets.

Core Features & Use Cases

  • Structural Completeness: verifies that the project exposes the required spec files and folders (specs/README.md, specs/Vision.md, specs/PRD.md, specs/Goals.md, specs/Architecture/README.md, specs/Glossary.md, specs/Changelog.md, specs/decisions/, specs/tickets/).
  • Document Quality: evaluates vision, problem statements, functional/non-functional requirements, scope, glossary usage, changelog freshness, and cross-document references.
  • Ticket Health & Cross-Reference: checks ticket frontmatter, lifecycle statuses, and ensures README and decisions reflect current state; validates cross-references between specs and tickets.
  • Drift Detection & Reporting: flags mismatches between codebase and specs, highlights gaps, and recommends remediation steps.

Quick Start

Run specs-review to audit the health and consistency of your project's spec-driven documentation.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: specs-review
Download link: https://github.com/b12consulting/skills/archive/main.zip#specs-review

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.