Can this skill help with legacy codebases?

Yes, provided there is some form of design documentation available. It can help identify where legacy implementations have drifted from the original intended architecture over time.

Is the Design Spec Auditor language-agnostic?

Yes, as a Claude Code skill, it can analyze code across various programming languages by focusing on the logic, structure, and interface contracts described in your design specs.

What documentation formats does the Design Spec Auditor support?

The skill is optimized for Markdown-based design documents stored within your repository, allowing it to parse structured requirements and compare them directly against your source code.

How does it handle intentional deviations from a design?

The auditor identifies 'Extra' features or variations. If a deviation is intentional (such as for performance), the skill will flag it and recommend updating the design document to reflect the new reality.

Design Spec Auditor

Name: Design Spec Auditor
Author: sunholo-data

bysunholo-data

•

Security & Testing

Verifies that code implementations align with technical design specifications to ensure architectural compliance and consistency.

The Design Spec Auditor is a specialized Claude Code skill designed to bridge the gap between architectural planning and actual implementation. By systematically comparing project design documents—both planned and implemented—against the codebase, it identifies discrepancies in module boundaries, interface contracts, and behavioral requirements. Whether used during code reviews, after major refactors, or following feature development, this skill helps teams maintain high architectural standards, catch 'design drift,' and ensure that every line of code serves the intended design goals.

Key Features

01Intelligent mapping of design requirements to specific packages and function signatures

02Identification of undocumented feature additions and 'design drift'

03Automated comparison between design documentation and source code

0412 GitHub stars

05Detection of architectural violations and broken interface contracts

06Categorized discrepancy reporting with severity levels from Critical to Minor

Use Cases

01Auditing a codebase after a major refactoring to ensure architectural integrity remains intact

02Generating detailed compliance reports for technical stakeholders during software audits

03Verifying a new feature implementation against its original design document before merging

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sunholo-data/ailang design-spec-auditor

For use in Claude.ai and ChatGPT

Download Skill