Which files does the Technical Spec Auditor examine?

It requires a spec.md file but will also analyze spec-research.md, checklist.md, and FEATURE.md if they are available in the project directory.

Can I use this for existing legacy documentation?

Yes, it is highly effective for auditing old specs to see if they have drifted from the current state of the codebase before you start a new feature iteration.

How does this differ from a standard consistency checker?

Consistency checkers look for internal formatting issues, whereas this skill performs an adversarial review by comparing the spec's claims against the actual codebase to identify real-world implementation blockers.

What happens if the skill gives a 'REVISE' verdict?

A REVISE verdict indicates critical findings or multiple major issues. You should address the highlighted sections in your spec-review.md before proceeding with implementation.

Does this skill automatically rewrite my specifications?

No, it is an auditing tool. It produces a detailed review report highlighting defects and risks so the author can make informed revisions based on objective feedback.

Technical Spec Auditor

Name: Technical Spec Auditor
Author: AI-Builder-Team

byAI-Builder-Team

•

Developer Tools

Critically evaluates technical specifications for feasibility, completeness, and architectural risks before implementation begins.

Technical Spec Auditor provides an adversarial, objective review of your project specifications to ensure they are accurate, buildable, and logically sound. Unlike standard consistency checkers, this skill utilizes three parallel sub-agents to verify specification claims against the actual codebase, validating interface contracts, file structures, and architectural patterns. It generates a comprehensive spec-review.md report with prioritized findings (Critical to Suggestion), helping engineering teams catch costly design flaws and implementation blockers before a single line of code is written.

Key Features

01Automated generation of detailed spec-review.md reports with severity ratings

02Verdict-based feedback system (Pass, Pass with Reservations, or Revise)

03Adversarial evaluation of technical feasibility and hidden project risks

04Pattern consistency checking to ensure alignment with existing code standards

052 GitHub stars

06Three-agent parallel verification of file structures and interface contracts

Use Cases

01Validating that a technical design accurately reflects existing codebase interfaces

02Revisiting legacy specifications to identify drift from the current code state

03Auditing a newly generated spec.md before moving to the implementation phase

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ai-builder-team/ai-builder-plugin-marketplace reviewing-specs

For use in Claude.ai and ChatGPT

Download Skill