Can it detect code that isn't in the spec?

Yes, the skill explicitly identifies 'Extra' code—functionality that exists in the implementation but was never mentioned in the specification.

Is this a substitute for unit testing?

No, it complements unit testing by ensuring the logic matches the intended design intent, whereas unit tests primarily verify that the code functions as written.

When is the best time to run this audit?

It is most effective when an implementation is claimed as 'complete' or immediately after a significant refactoring of existing code to prevent logic drift.

What types of documents can this skill compare?

It can compare any text-based specification including PRDs, design docs, API specifications, and high-level architectural requirements.

Spec vs Code Audit

Name: Spec vs Code Audit
Author: ash1794

byash1794

•

Security & Testing

Audits source code against specification documents to identify divergences, missing features, and implementation gaps.

The Spec vs Code Audit skill provides a systematic framework for ensuring that implementation matches intent. By performing a line-by-line comparison between design documents, PRDs, or API specs and the actual codebase, it identifies critical gaps where the code deviates from the requirements. This is essential for maintaining software integrity during final implementation phases, major refactors, or compliance checks, helping developers catch 'drift' before it impacts production.

Key Features

016 GitHub stars

02Severity-based risk assessment for implementation errors

03Line-by-line requirement mapping from docs to code

04Identification of undocumented 'extra' code features

05Standardized audit reporting with clear fix recommendations

06Automated gap classification for missing or incorrect logic

Use Cases

01Debugging unexpected behavior by verifying code against original design specs

02Ensuring codebase compliance after a major architectural refactor

03Verifying feature completion against a Product Requirement Document (PRD)

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ash1794/vibe-engineering spec-vs-code-audit

For use in Claude.ai and ChatGPT

Key Features

016 GitHub stars

02Severity-based risk assessment for implementation errors

03Line-by-line requirement mapping from docs to code

04Identification of undocumented 'extra' code features

05Standardized audit reporting with clear fix recommendations

06Automated gap classification for missing or incorrect logic

Use Cases

01Debugging unexpected behavior by verifying code against original design specs

02Ensuring codebase compliance after a major architectural refactor

03Verifying feature completion against a Product Requirement Document (PRD)

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ash1794/vibe-engineering spec-vs-code-audit

For use in Claude.ai and ChatGPT