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.