Code Design Rationale Investigator
cursor/plugins
Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.
Analyze gaps by comparing a defined current state with a justified target state, characterizing causes and uncertainty, prioritizing actionable interventions, and producing traceable matrices…
Install Gap Analysis
$ npx skills add magnus919/agent-skills --skill gap-analysis -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install magnus919/agent-skills gap-analysis --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/gap-analysis .claude/skills/gap-analysis && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "gap-analysis" agent skill from https://github.com/magnus919/agent-skills/tree/main/gap-analysis into .claude/skills/gap-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gap-analysis", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/magnus919/agent-skills/tree/main/gap-analysisType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add magnus919/agent-skills --skill gap-analysis -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install magnus919/agent-skills gap-analysis --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/gap-analysis .agents/skills/gap-analysis && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "gap-analysis" agent skill from https://github.com/magnus919/agent-skills/tree/main/gap-analysis into .agents/skills/gap-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gap-analysis", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add magnus919/agent-skills --skill gap-analysis -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install magnus919/agent-skills gap-analysis --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/gap-analysis .cursor/skills/gap-analysis && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "gap-analysis" agent skill from https://github.com/magnus919/agent-skills/tree/main/gap-analysis into .cursor/skills/gap-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gap-analysis", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/magnus919/agent-skills.git --path gap-analysis--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add magnus919/agent-skills --skill gap-analysis -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install magnus919/agent-skills gap-analysis --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/gap-analysis .gemini/skills/gap-analysis && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "gap-analysis" agent skill from https://github.com/magnus919/agent-skills/tree/main/gap-analysis into .gemini/skills/gap-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gap-analysis", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install magnus919/agent-skills gap-analysisInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add magnus919/agent-skills --skill gap-analysis -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/gap-analysis .github/skills/gap-analysis && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "gap-analysis" agent skill from https://github.com/magnus919/agent-skills/tree/main/gap-analysis into .github/skills/gap-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gap-analysis", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add magnus919/agent-skills --skill gap-analysis -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install magnus919/agent-skills gap-analysis --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/gap-analysis .opencode/skills/gap-analysis && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "gap-analysis" agent skill from https://github.com/magnus919/agent-skills/tree/main/gap-analysis into .opencode/skills/gap-analysis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gap-analysis", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
gap-analysis- GitHub stars
- 116
- Token cost
- ~1.5k tokens
- SKILL.md length
- 677 words
- Files
- 14 (incl. scripts, references)
- Skills in repo
- 130
- Repo updated
- First seen
- Licence
- MIT
At a glance
Analyze gaps by comparing a defined current state with a justified target state, characterizing causes and uncertainty, prioritizing actionable interventions, and producing traceable matrices…
- Works in 9 steps: Frame the decision. State the decision… → Define the criterion. Make the target… → Specify evidence. For each dimension,… → …
- Operating-model
- SKILL.md covers Overview, When to use, Core method and Required output shape, plus 3 more sections
- Runs Python scripts from its folder
What it does
Gap Analysis is an agent skill from magnus919/agent-skills. 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.
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 17 other files, including scripts and reference files (for example `README.md`, `evals/evals.json` and `references/examples-and-anti-patterns.md`). Compatibility notes: Platform-agnostic methodology. No runtime dependency; optional Python 3 script uses only the standard library.
It sits in Development, covering Root cause analysis and Startup and business strategy. The repository describes itself as: Curated collection of AI agent skills for Hermes and other agent frameworks. The licence is MIT.
When your agent uses it
- Operating-model
- Research-evidence gaps
- A vague list of problems
- A standalone root-cause analysis
Example prompts
- “/gap-analysis”
Requirements
- Python 3
- Compatibility (from SKILL.md): Platform-agnostic methodology. No runtime dependency; optional Python 3 script uses only the standard library.
Workflow steps
9 steps, taken from the first numbered list in SKILL.md.
- Frame the decision. State the decision or outcome, sponsor, population/system, time horizon, boundary, exclusions, and who will use the…
- Define the criterion. Make the target observable and source it to a requirement, outcome, benchmark, risk appetite, strategy, or…
- Specify evidence. For each dimension, define measure, unit, period, source, sampling, confidence, and acceptance rule before collecting…
- Describe the current state. Use multiple relevant evidence types: records/metrics, direct observation, interviews, artifacts, tests, or…
- Compare like with like. For every dimension, show current, target, difference, evidence, confidence, and consequence. A gap is a bounded…
- Characterize the gap. Distinguish outcome gap, capability/control gap, process gap, resource gap, knowledge/evidence gap, and…
- Prioritize transparently. Use criteria appropriate to the decision, such as impact, urgency/exposure, reach, feasibility, dependency…
- Plan closure. Convert selected gaps into actions with a measurable closure condition, owner, dependencies, resources, date or review…
- Validate and revisit. Review findings with affected stakeholders, test high-consequence claims, resolve material contradictions, and…
What it can do on your machine
Read from SKILL.md and the folder at commit c545c2b. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Python), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Platform-agnostic methodology. No runtime dependency; optional Python 3 script uses only the standard library.
From compatibility in the SKILL.md frontmatter.
Context cost
Gap Analysis loads about 1.5k tokens when it runs, and up to ~5.6k if it reads all its reference files. Until then it costs about 131 tokens; SKILL.md has 677 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from magnus919/agent-skills at commit c545c2b, republished under its MIT licence (© magnus919). 677 words, ~1,549 tokens.
Download SKILL.mdSave it as
.claude/skills/gap-analysis/SKILL.md (or your agent's skills folder). This skill also uses 13 other files; get the full folder from GitHub.- name
- gap-analysis
- description
- 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.
- compatibility
- Platform-agnostic methodology. No runtime dependency; optional Python 3 script uses only the standard library.
- license
- MIT
- metadata.tags
- gap-analysis, current-state, target-state, capability, maturity, readiness, compliance, evidence, prioritization
Gap Analysis
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
- Frame the decision. State the decision or outcome, sponsor, population/system, time horizon, boundary, exclusions, and who will use the result.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.”
- 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.
Show full SKILL.md (247 more words)Show less
Required output shape
Use templates/gap-register.md as the canonical row schema, then add only the context artifact needed:
| Context | Add |
|---|---|
| Capability or maturity | templates/capability-assessment.md |
| Process or operating model | templates/process-gap-analysis.md |
| Compliance or readiness | templates/compliance-readiness-assessment.md |
| Research or evidence | templates/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 limits | references/methodology.md |
| You need to choose among capability, process, compliance, readiness, maturity, or research variants | references/variants.md |
| You need prioritization, scoring, sequencing, or closure controls | references/prioritization-and-roadmaps.md |
| You need examples, anti-patterns, or review questions | references/examples-and-anti-patterns.md |
| You need source provenance and claims behind this skill | references/source-index.md |
| You need a structured checker for a completed JSON register | scripts/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.
© magnus919, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 13 other files (scripts, references) in gap-analysis of magnus919/agent-skills.
- SKILL.md
- README.md
- evals/evals.json
- references/examples-and-anti-patterns.md
- references/methodology.md
- references/prioritization-and-roadmaps.md
- references/source-index.md
- references/variants.md
- scripts/validate-register.py
- templates/capability-assessment.md
- templates/compliance-readiness-assessment.md
- templates/gap-register.md
- templates/process-gap-analysis.md
- templates/research-evidence-gap.md
Open the folder on GitHubat commit c545c2b
Compare with similar skills
Gap Analysis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Gap Analysis this skillmagnus919/agent-skills | 116 | — | ~1.5k | Automated safety check: Pass | MIT | |
| Code Design Rationale Investigatorcursor/plugins | 10k | 9 repos | ~2.6k | Automated safety check: Pass | None | |
| OpenLogi macOS Permissions TriageAprilNEA/OpenLogi | 23k | — | ~2.5k | Automated safety check: Notes | Apache-2.0 | |
| Bug Finder for daisyUIsaadeghi/daisyui | 43k | — | ~2.3k | Automated safety check: Pass | MIT | |
| Root Cause Debugginggarrytan/gstack | 136k | — | ~1.4k | Automated safety check: Pass | MIT | |
| Review PRapache/shardingsphere | 21k | — | ~6.4k | Automated safety check: Pass | Apache-2.0 |
Similar skills
- Official
OpenLogi macOS Permissions Triage
AprilNEA/OpenLogi
Decides whether an OpenLogi device problem on macOS is a privacy-permission (TCC) problem, using agent log lines, and says which identity needs which grant.
Bug Finder for daisyUI
saadeghi/daisyui
Investigates suspected bugs in the daisyUI monorepo through read-only analysis, then writes a decision-ready fix plan in tmp/bugs without changing any product code.
Root Cause Debugging
garrytan/gstack
Investigates bugs, errors and stack traces in phases and requires a root-cause hypothesis to be confirmed before any fix is written.
Review PR
apache/shardingsphere
Review Apache ShardingSphere or user-authorized downstream pull requests and PR discussions from public or authorized repository evidence.
Graph-Based Bug Tracing
tirth8205/code-review-graph
Traces a bug through a code knowledge graph, following callers, callees and execution flow before opening source files, within a small token budget.
More from magnus919/agent-skills
All 130 skills in this repoArtifact Pyramids
magnus919/agent-skills
Organize durable agent research outputs as summaries, analysis, and evidence dossiers.
Ascii City Engine
magnus919/agent-skills
Build portable, first-person colored ASCII city engines and small GIS-derived city packs.
Color Management
magnus919/agent-skills
Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science.
Data Scientist
magnus919/agent-skills
A skill your agent uses for PhD-level expertise in data science, statistics, and machine learning: rigorous statistical analysis, experimental design, causal inference, advanced modeling, research…
Docker Compose
magnus919/agent-skills
Use Docker Compose to define, run, debug, and harden multi-container applications.
Fpga Development
magnus919/agent-skills
Design, review, simulate, and verify FPGA logic using explicit RTL contracts, clock and reset models, CDC analysis, timing constraints, and reproducible implementation evidence.
Related
Categories
Questions about Gap Analysis
What does Gap Analysis do?
Analyze gaps by comparing a defined current state with a justified target state, characterizing causes and uncertainty, prioritizing actionable interventions, and producing traceable matrices…. Gap Analysis is an agent skill from magnus919/agent-skills. 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.
When should I use Gap Analysis?
Gap Analysis fits situations like: operating-model; research-evidence gaps; A vague list of problems; A standalone root-cause analysis.
How do I install Gap Analysis in Claude Code?
Run `npx skills add magnus919/agent-skills --skill gap-analysis -a claude-code`. Or copy the skill folder (gap-analysis in magnus919/agent-skills) into .claude/skills/gap-analysis in your project. Claude Code loads it when a task matches its description.
How do I install Gap Analysis in Codex?
Run `npx skills add magnus919/agent-skills --skill gap-analysis -a codex`. Or copy the skill folder (gap-analysis in magnus919/agent-skills) into .agents/skills/gap-analysis in your project. Codex loads it when a task matches its description.
Can I use Gap Analysis in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add magnus919/agent-skills --skill gap-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gap-analysis, .gemini/skills/gap-analysis, .github/skills/gap-analysis and .opencode/skills/gap-analysis in your project.
What does Gap Analysis need to run?
Going by SKILL.md and its folder, Gap Analysis needs Python for the scripts in its folder. Our summary lists: Python 3. Compatibility (from SKILL.md): Platform-agnostic methodology. No runtime dependency; optional Python 3 script uses only the standard library..
Does Gap Analysis access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Gap Analysis safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Gap Analysis use?
Gap Analysis is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Gap Analysis use?
About 1.5k tokens (SKILL.md is roughly 6.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.1k tokens, read only when the agent opens those files.
What are the alternatives to Gap Analysis?
Skills that share tags, products or a category with Gap Analysis: Code Design Rationale Investigator (cursor/plugins, 10k stars), OpenLogi macOS Permissions Triage (AprilNEA/OpenLogi, 23k stars), Bug Finder for daisyUI (saadeghi/daisyui, 43k stars) and Root Cause Debugging (garrytan/gstack, 136k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Gap Analysis?
magnus919 (a GitHub user) maintains it in magnus919/agent-skills, which has 116 GitHub stars. The repository holds 130 skills in this directory. The repository was last updated on October 8, 2026.
Source: magnus919/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.