agentsclimarketplace

Gap analysis

Skill MarieLynneBlock/arcanum-artifex/skills/analysis/gap-analysis

Provides a repeatable framework for identifying and prioritising gaps between where things are now and where they need to be.From its SKILL.md

Install
npx -y skills add MarieLynneBlock/arcanum-artifex --skill gap-analysis

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

5.4 KB, ~1.2k tokens by cl100k_base, as published. Nobody here has run it

What this skill does

Provides a repeatable framework for identifying and prioritising gaps between where things are now and where they need to be. It structures the analysis by dimension (process, data, technology, people, compliance, etc.), scores each gap by severity, and produces actionable recommendations with ownership.

When to use it

  • User asks to "identify gaps", "do a gap analysis", or "compare current to target state".
  • User is preparing for a migration, transformation, audit, or initiative and needs to understand what needs to change.
  • User needs evidence to justify a project or roadmap item.
  • User wants to feed results into a miro-board, risk-analysis, or tradeoff-analysis.

Key concepts

Dimensions

A gap analysis is organised by dimension — the aspect of the system or organisation being assessed. Choose dimensions that are relevant to the subject:

DimensionWhat it covers
ProcessHow work is done; workflows, steps, handoffs
DataData availability, quality, structure, lineage
TechnologyTools, systems, integrations, infrastructure
PeopleSkills, roles, capacity, knowledge
ComplianceRegulatory, policy, or audit requirements
PerformanceSLAs, KPIs, benchmarks
DocumentationSpecs, runbooks, architecture records

Severity

SeverityMeaning
CriticalBlocks the target state; must close before proceeding
HighSignificant risk or rework if not addressed early
MediumImportant but manageable; schedule in backlog
LowNice to fix; low impact if deferred

Instructions

  1. Define the subject. Confirm what is being compared: a system, a process, a team capability, a product area.

  2. Establish the target state. If the user has not defined it, ask. The target state must be specific enough to measure against — not "be more agile" but "deploy to production daily with zero manual steps".

  3. Select dimensions. Choose the dimensions relevant to the subject. Do not include dimensions where there is nothing to compare.

  4. Assess each dimension. For each dimension:

    • Describe the current state in one or two sentences with evidence.
    • Describe the target state for that dimension.
    • Identify the gap — what is missing, insufficient, or misaligned.
    • Assign a severity.
  5. Identify root causes for Critical/High gaps where the cause is not obvious.

  6. Write recommendations. For each Critical/High gap, provide a concrete action, an owner role, and an indication of whether it is a quick fix or a larger initiative.

  7. Produce the report using the output format below.

Output format

# Gap Analysis: [Subject]

**Date:** YYYY-MM-DD  
**Analyst:** [name or AI-assisted]  
**Subject:** [what is being assessed]  
**Target state:** [one-sentence definition of the desired end state]

---

## Summary

| Severity | Count | Top gap |
| --- | --- | --- |
| Critical | n | ... |
| High | n | ... |
| Medium | n | ... |
| Low | n | ... |

**Overall readiness:** [Not ready / Partially ready / Mostly ready / Ready]

[2–3 sentence narrative: what is the dominant gap theme and what single action would most accelerate progress toward the target state?]

---

## Gap Register

### [Dimension] — [Severity]

| | Detail |
| --- | --- |
| **Current state** | [Evidence-based description] |
| **Target state** | [What good looks like for this dimension] |
| **Gap** | [What is missing or insufficient] |
| **Root cause** | [Why the gap exists — if known] |
| **Recommendation** | [Concrete action] |
| **Owner** | [Role or team] |
| **Effort** | Quick fix / Sprint / Initiative |

---

## Recommended actions (priority order)

1. [Action] — Owner: [role] — Effort: [size]
2. [Action] — Owner: [role] — Effort: [size]

Examples

Example 1 — CI/CD maturity gap analysis

Input: "We want to move to daily deployments. Currently we deploy manually once a month."

Expected output: Gap register covering: Technology (no pipeline — Critical), Process (no deployment runbook — High), People (no on-call rotation — High), Documentation (no rollback procedure — Medium). Recommended actions in priority order with owner roles.

Example 2 — Data readiness for ML project

Input: "We want to build a churn prediction model. Assess whether our data is ready."

Expected output: Dimensions: Data (label availability, data quality, historical coverage), Technology (feature store, training infrastructure), People (ML engineering capacity). Each dimension assessed against ML-ready target state.

Notes

  • Never describe the current state in terms of the gap ("current state: no monitoring" — that is the gap, not the state). Describe what does exist, then state what is missing.
  • If evidence for the current state is not provided, flag it as an assumption rather than stating it as fact.
  • A gap analysis is not a project plan — do not assign dates or sprint numbers unless the user requests it.
  • This skill integrates naturally with risk-analysis (gaps often surface risks) and miro-board (gap columns map directly to a three-column Miro board).

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 326,764. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.