gap-analysis

Compare design documents against implementation code to calculate a Match Rate and classify gaps.

14|2|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/excatt/superclaude-plusplus --skill gap-analysis-excatt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gap-analysis
Source: https://github.com/excatt/superclaude-plusplus/tree/main/skills/gap-analysis
Command: npx skills add https://github.com/excatt/superclaude-plusplus --skill gap-analysis-excatt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill identifies and quantifies discrepancies between design specifications and the actual implementation code, ensuring alignment and highlighting areas needing correction.

Core Features & Use Cases

  • Design-Implementation Comparison: Compares API endpoints, data models, feature lists, and conventions against design documents.
  • Match Rate Calculation: Quantifies the alignment between design and implementation.
  • Gap Classification: Categorizes discrepancies into Missing, Added, or Changed items.
  • Use Case: After implementing a new user authentication feature, use this Skill to verify that the code precisely matches the API contracts and data models defined in the design document before merging.

Quick Start

Run the gap analysis skill for the user authentication feature.

Frequently Asked Questions about gap-analysis

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

FAQPage Schema
How do I verify my implementation code matches the design document?

Gap analysis compares API endpoints, data models, and feature lists against design specifications to calculate a match rate. It classifies discrepancies into missing, added, or changed items to verify implementation alignment.

What is the best way to calculate a match rate between design and code?

The best way to calculate a match rate between design and code is to compare API specifications and convention compliance directly against the implementation, categorizing gaps to quantify the overall alignment percentage.

How does gap classification categorize discrepancies in implementation verification?

Gap classification categorizes discrepancies found during implementation verification into Missing, Added, or Changed items. This highlights areas needing correction by identifying what code lacks, exceeds, or alters from the design.

Can I use gap analysis for pre-PR code review?

Yes, you can use gap analysis for pre-PR code review. It checks convention compliance and verifies that API contracts and data models precisely match the design document before merging new features.

When do I need design vs code comparison for the PDCA Check phase?

You need design vs code comparison for the PDCA Check phase to execute verification by quantifying alignment and identifying discrepancies between planned design specifications and the actual implementation code.