Can I use this for API verification?

Yes, the skill specifically extracts API contracts, endpoint definitions, and function signatures from your documentation and verifies their existence and behavior within the source code.

What file types does Spec Gap Analysis support?

The skill supports Markdown (.md) and text (.txt) files including dedicated specifications, blueprints, requirements documents, and Architecture Decision Records (ADRs) found in your project directories.

Does it just search for keywords or does it understand context?

It performs context-aware verification. For example, when checking a CLI command, it looks for argument parser definitions and handler functions rather than just matching a string in a comment.

What happens if my project doesn't have formal specification files?

If no spec documents or architectural signals are detected, the skill logs a skip message and does not penalize your audit score, making it safe for projects without formal documentation.

How does the scoring system work?

The analysis starts at a score of 100. It deducts 15 points for Missing features (planned but not found), 7 points for Partial implementations, and 5 points for Extra features (implemented but undocumented).

Spec Gap Analysis

Name: Spec Gap Analysis
Author: nsalvacao

bynsalvacao

0•

セキュリティとテスト

Automates the comparison of specification documents against source code to identify unimplemented features and implementation drift.

Spec Gap Analysis is a specialized Claude Code skill designed to bridge the divide between architectural planning and actual implementation. By automatically locating specification files, ADRs, and blueprints, it extracts functional claims and cross-references them with the codebase using advanced search patterns. The skill provides a comprehensive report and a drift score (0-100), highlighting 'ghost features' that were planned but never built, and 'invisible features' that exist in code but lack documentation. This tool is essential for maintaining high-quality documentation, ensuring project requirements are fully met, and conducting rigorous architectural audits.

主な機能

01Claim extraction for features, API contracts, and behavioral constraints

020 GitHub stars

03Automated discovery of specs, blueprints, and Architecture Decision Records (ADRs)

04Deep codebase cross-referencing and verification of implementation evidence

05Classification system for Implemented, Partial, Missing, and Extra features

06Quantitative drift scoring with detailed gap reporting and audit summaries

ユースケース

01Auditing legacy projects to identify undocumented 'invisible' features or missing requirements.

02Conducting pre-release blueprint reviews to ensure all acceptance criteria are satisfied.

03Verifying that a new feature implementation matches the original design document requirements.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nsalvacao/nsalvacao-claude-code-plugins spec-gap-analysis

For use in Claude.ai and ChatGPT

主な機能

01Claim extraction for features, API contracts, and behavioral constraints

020 GitHub stars

03Automated discovery of specs, blueprints, and Architecture Decision Records (ADRs)

04Deep codebase cross-referencing and verification of implementation evidence

05Classification system for Implemented, Partial, Missing, and Extra features

06Quantitative drift scoring with detailed gap reporting and audit summaries

ユースケース

01Auditing legacy projects to identify undocumented 'invisible' features or missing requirements.

02Conducting pre-release blueprint reviews to ensure all acceptance criteria are satisfied.

03Verifying that a new feature implementation matches the original design document requirements.