Files
magnus919_agent-skills/gap-analysis/README.md
T
Magnus HedemarkandGitHub def688dc1e feat: add gap-analysis methodology skill (#475)
* feat: add gap-analysis methodology skill

Signed-off-by: Magnus Hedemark <magnus919@pm.me>

* fix: satisfy gap-analysis trigger validation

Signed-off-by: Magnus Hedemark <magnus919@pm.me>

* chore: refresh generated marketplace metadata

Signed-off-by: Magnus Hedemark <magnus919@pm.me>

* chore: refresh llms catalog

Signed-off-by: Magnus Hedemark <magnus919@pm.me>

---------

Signed-off-by: Magnus Hedemark <magnus919@pm.me>
2026-09-07 01:17:47 -04:00

2.1 KiB

gap-analysis

Evidence-based comparison of a current state with a justified target state, producing actionable and reviewable decisions.

Why Install This Skill

A gap analysis is easy to make look rigorous: add a current column, a target column, and a red/amber/green score. This skill teaches the harder part: defining a target that is actually warranted, collecting evidence that matches the question, separating observations from causes, and making trade-offs and uncertainty visible.

After installing it, an agent can produce gap registers, capability and maturity assessments, process and operating-model reviews, compliance/readiness assessments, and research-evidence gap analyses. The included templates are designed to be adapted, not treated as a universal scoring system.

What You Get

Path What it provides
SKILL.md Method, routing, quality gates, and completion boundary
references/ Research-grounded methodology, variants, prioritization, examples, and source index
templates/ Gap register plus capability, process, compliance/readiness, and research variants
scripts/validate-register.py Dependency-free checker for a JSON gap register
evals/evals.json Output-quality cases for evidence, ambiguity, prioritization, and variants

Quick Start

No installation or API key is required. Read SKILL.md, choose a context template, and keep current evidence, target authority, confidence, owner, and closure test visible for every material gap.

For a machine-checkable register:

python3 gap-analysis/scripts/validate-register.py path/to/register.json

Triggers

Load this skill when you need to compare current and desired states for a capability, process, control, readiness decision, maturity question, operating model, or research evidence base.

Requirements

  • No external dependencies for the methodology or templates.
  • Python 3 for the optional validator script.
  • A defined decision, outcome, requirement, benchmark, or stakeholder target. Without one, the first deliverable is scoping, not a completed gap analysis.