Gap Analysis

SkillAI & models

Analyze gaps by comparing a defined current state with a justified target state, characterizing causes and uncertainty, prioritizing actionable interventions, and producing traceable matrices, roadmaps, and decision records. Use for capability, process, compliance, readiness, maturity, operating-model, or research-evidence gaps. Do not use for a vague list of problems, a standalone root-cause analysis, a generic SWOT, or legal or audit certification advice without a governing standard and qualified owner.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Gap Analysis skill

What this skill tells your AI

The instructions your AI receives, as published by magnus919/agent-skills in gap-analysis/SKILL.md and read by ahel’s review.

Overview

A gap analysis is a decision method, not a scorecard: define a bounded question, establish an observable current state, justify a desired state, compare them, explain why the difference exists, and decide what to do. A credible result makes evidence, assumptions, uncertainty, ownership, and trade-offs visible.

When to use

Load this skill when the work compares current and desired performance, capability, controls, process behavior, readiness, maturity, operating model, or research evidence and must produce an actionable artifact. Choose the variant from references/variants.md.

When not to use

Do not use this as a substitute for root-cause analysis, a risk assessment, SWOT, benchmarking, a requirements specification, a regulatory/legal opinion, or an audit/certification conclusion. Route technical capacity questions to capacity-and-cost-engineering, governance questions to ai-governance, and causal diagnosis to systematic-debugging or the relevant domain owner. A gap analysis may expose a need for those disciplines; it does not replace them.

Core method

  1. Frame the decision. State the decision or outcome, sponsor, population/system, time horizon, boundary, exclusions, and who will use the result.
  2. Define the criterion. Make the target observable and source it to a requirement, outcome, benchmark, risk appetite, strategy, or explicitly labeled stakeholder preference. Do not invent a maturity scale or imply that a framework tier is a universal goal.
  3. Specify evidence. For each dimension, define measure, unit, period, source, sampling, confidence, and acceptance rule before collecting data. Separate observed facts, reported perceptions, inferred causes, and assumptions.
  4. Describe the current state. Use multiple relevant evidence types: records/metrics, direct observation, interviews, artifacts, tests, or research synthesis. Record missing and contradictory evidence instead of filling it with confidence.
  5. Compare like with like. For every dimension, show current, target, difference, evidence, confidence, and consequence. A gap is a bounded difference, not merely a bad feeling or an absence of a preferred practice.
  6. Characterize the gap. Distinguish outcome gap, capability/control gap, process gap, resource gap, knowledge/evidence gap, and decision/ownership gap. Keep root causes and proposed remedies separate from the observed gap.
  7. Prioritize transparently. Use criteria appropriate to the decision, such as impact, urgency/exposure, reach, feasibility, dependency, cost, confidence, and reversibility. Show the rationale and do not hide value judgments inside a score.
  8. Plan closure. Convert selected gaps into actions with a measurable closure condition, owner, dependencies, resources, date or review trigger, and residual risk. Assign an accountable decision-maker, not “the team.”
  9. Validate and revisit. Review findings with affected stakeholders, test high-consequence claims, resolve material contradictions, and schedule a follow-up measurement. Closure means evidence that the target condition is met, not that an action was started.

Required output shape

Use templates/gap-register.md as the canonical row schema, then add only the context artifact needed:

ContextAdd
Capability or maturitytemplates/capability-assessment.md
Process or operating modeltemplates/process-gap-analysis.md
Compliance or readinesstemplates/compliance-readiness-assessment.md
Research or evidencetemplates/research-evidence-gap.md

A useful report normally contains: executive decision, scope and method, target/criteria register, current-state evidence, gap register, prioritization logic, action roadmap, assumptions/unknowns, stakeholder review, and follow-up measure. Label hypothetical examples as hypothetical.

Quality gates

Before delivery, verify that each material gap has (a) a defined target and source, (b) current evidence or an explicit evidence gap, (c) a stated comparison and consequence, (d) a cause hypothesis distinguished from fact, (e) an owner and closure test, and (f) a priority rationale. Check that the report does not claim compliance, readiness, causation, or improvement without the evidence needed to support that claim.

Reference routing

Load this file when...Reference
You need the research-grounded method, evidence taxonomy, or source limitsreferences/methodology.md
You need to choose among capability, process, compliance, readiness, maturity, or research variantsreferences/variants.md
You need prioritization, scoring, sequencing, or closure controlsreferences/prioritization-and-roadmaps.md
You need examples, anti-patterns, or review questionsreferences/examples-and-anti-patterns.md
You need source provenance and claims behind this skillreferences/source-index.md
You need a structured checker for a completed JSON registerscripts/validate-register.py

Completion

Stop when the decision question is answered by a reviewed, traceable artifact, or report the bounded unresolved evidence and the next collection action. Do not convert missing data into a green score or keep researching after the decision-relevant uncertainty is explicit.

Signals

GitHub stars
78
Forks
8
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
gap-analysis-magnus919
Source
github.com/magnus919/agent-skills