skills.rest
ousiass
ousiassCOMMUNITY
Explore all skills by this author →
GitHub

spec-audit

Detects specification-to-implementation mismatches in repos with docs/spec files and OpenAPI/Swagger schemas.

Updated May 3, 2026
Search Tags:#api#openapi#requirements#github issues#test coverage#code compliance#spec audit
One-click install
npx skills add https://github.com/ousiass/dotfiles --skill spec-audit-ousiass
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-audit
Source: https://github.com/ousiass/dotfiles/tree/main/.claude/skills/spec-audit
Command: npx skills add https://github.com/ousiass/dotfiles --skill spec-audit-ousiass

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you find mismatches between specification documents and the actual implementation, so you can quickly identify missing functionality, TODO/unfinished work, skipped tests, and API schema divergences.

Core Features & Use Cases

  • Spec vs implementation gap detection: Extracts claims from docs and checks for corresponding code paths, recording mismatched locations on both sides.
  • Unfinished work & test validity checks: Scans for TODO/FIXME/HACK markers and identifies skipped/pending/ignored tests that undermine coverage.
  • API schema divergence detection: Compares OpenAPI/Swagger definitions to implemented handlers and flags missing endpoints.

Quick Start

Run the spec-audit skill without arguments to have it automatically discover spec documents under your project and produce a report or create GitHub Issues.

Frequently Asked Questions about spec-audit

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

FAQPage Schema
How do I detect gaps between OpenAPI schemas and implemented code?▼

Spec audit detects API schema divergences by comparing OpenAPI or Swagger definitions to implemented handlers, flagging missing endpoints and recording mismatched locations across documentation and code.

Can I automatically create GitHub issues for missing test coverage?▼

Yes, spec audit identifies skipped, pending, or ignored tests that undermine coverage and can automatically generate granular GitHub issues via gh after recording mandatory evidence.

What is the best way to find unfinished work and TODO markers in my repository?▼

Spec audit scans repositories for TODO, FIXME, and HACK markers to identify unfinished work, comparing these implementation artifacts against spec documents to report missing functionality.

Does spec audit work with mixed implementation artifacts and documentation files?▼

Spec audit applies to repos with docs or spec files, OpenAPI schemas, and mixed implementation artifacts, automatically discovering spec documents under your project to produce detailed mismatch reports.

How do I report specification-to-implementation mismatches per feature?▼

Spec audit extracts detailed claims from documentation, verifies corresponding code existence and behavior, and generates granular issue reporting per feature or endpoint with mandatory evidence recording.

Related Skills

Explore More Software Engineering Skills→
The-INTJThe-INTJ
1

update-contest-api-docs

Synchronize OpenAPI 3.1.0 documentation for /api/contest endpoints with route implementations.

Community
Advanced
luisgustavooliveiraluisgustavooliveira

gitnexus-pr-review

Automate pull request review and risk assessment with GitNexus and GitHub API.

Community
Advanced
Sheldon-92Sheldon-92
3

Testing

Execute test suites and report failures with coverage metrics.

Community
Intermediate
Chang-Shih-YungChang-Shih-Yung

health

Aggregate type checker, linter, and test results into a 0-10 composite score.

Community
Advanced