gap-analysis-agent

Analyze a codebase and output a prioritized P0/P1/P2 action plan.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/carlosmarte/skills --skill gap-analysis-agent
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gap-analysis-agent
Source: https://github.com/carlosmarte/skills/tree/main/.agents/skills/gap-analysis-agent
Command: npx skills add https://github.com/carlosmarte/skills --skill gap-analysis-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gap Analysis Agent performs a rigorous comparison between a known Current State (the files under the user's location) and a defined Target State (the user's prompt), then emits a prioritized action plan organized by P0, P1, and P2 with cross-reference traceability.

Core Features & Use Cases

  • Ingests a target codebase location and a user-specified objective, maps current and target states, and computes the delta.
  • Produces a structured action plan with P0 (critical blockers), P1 (high-value features), and P2 (low-risk utilities) and provides traceability between gaps and requirements.
  • Works as a read-only analysis tool to guide teams on what to fix or improve before proceeding with changes.

Quick Start

Provide the location to analyze (e.g., src/ or repo/) and a clear objective prompt describing the desired target state.

Frequently Asked Questions about gap-analysis-agent

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

FAQPage Schema
How do I analyze the gap between a current codebase and a target state?▼

To perform a gap analysis on a codebase, provide the target directory location and an objective prompt defining the desired target state. The tool computes the delta and outputs a prioritized action plan.

How do I prioritize codebase gaps into an actionable P0 P1 P2 action plan?▼

You can prioritize codebase gaps by running an analysis against your target state. The tool automatically categorizes gaps into critical blockers, high-value features, and low-risk utilities to generate the action plan.

What is codebase gap analysis with traceability for software engineering?▼

Codebase gap analysis identifies the delta between current artifacts and target requirements. Traceability ensures every identified gap is cross-referenced back to the specific target state requirements defined in your prompt.

Does the gap analysis tool modify my existing repository files?▼

The gap analysis tool does not modify your repository files. It operates as a read-only analysis tool to surface structured, audit-friendly recommendations and an action plan without mutating your code.

Can I use gap analysis for prioritizing technical debt in a specific source directory?▼

Yes, you can target a specific source directory like src/ for gap analysis. By defining your desired target state in the prompt, the tool maps current artifacts and prioritizes the required technical debt remediation.