Agent skill

Gap Analyzer

by ItamarZand88 in ItamarZand88/CLI-Anything-WEB

Compares a CLI's implemented commands against its APP.md API map and traffic-analysis.json to find missing endpoints, incomplete CRUD, dead client methods, and priority gaps.

MITAuto-check passed

Install Gap Analyzer

skills CLI
$ npx skills add ItamarZand88/CLI-Anything-WEB --skill gap-analyzer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ItamarZand88/CLI-Anything-WEB gap-analyzer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ItamarZand88/CLI-Anything-WEB.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli-anything-web-plugin/skills/gap-analyzer .claude/skills/gap-analyzer && rm -rf skills-src

Use ~/.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/

Facts

Skill name
gap-analyzer
GitHub stars
231
Token cost
~1.6k tokens
SKILL.md length
523 words
Files
1
Skills in repo
42
Repo updated
First seen
Licence
MIT

At a glance

Compares a CLI's implemented commands against its APP.md API map and traffic-analysis.json to find missing endpoints, incomplete CRUD, dead client methods, and priority gaps.

  • Works in 6 steps: Deterministic First Pass (devkit) → Parse Implemented Surface → Parse Documented Surface → …
  • SKILL.md covers Inputs, Step 0: Deterministic First…, Step 1: Parse Implemented… and Step 2: Parse Documented Surface, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Gap Analyzer is an agent skill from ItamarZand88/CLI-Anything-WEB. Compares a CLI's implemented commands against its APP.md API map and traffic-analysis.json to find missing endpoints, incomplete CRUD, dead client methods, and priority gaps. Runs as the mandatory first step of /cli-anything-web:refine and as an optional pre-review scan in standards.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Claude Code plugin that generates production-grade Python CLIs for any web app. 20 CLIs and counting. The licence is MIT.

Example prompts

  • “Use the gap-analyzer skill to compare a CLI's implemented commands against its APP.md API map and traffic-analysis.json to find missing endpoints…”
  • “/gap-analyzer”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Deterministic First Pass (devkit)
  2. Parse Implemented Surface
  3. Parse Documented Surface
  4. Diff
  5. Priority Scoring (Optional)
  6. Output Report

What it can do on your machine

Read from SKILL.md and the folder at commit 931e201. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    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.

Context cost

Gap Analyzer loads about 1.6k tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 523 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from ItamarZand88/CLI-Anything-WEB at commit 931e201, republished under its MIT licence (© ItamarZand88). 523 words, ~1,601 tokens.

Download SKILL.mdSave it as .claude/skills/gap-analyzer/SKILL.md (or your agent's skills folder).
name
gap-analyzer
description
Compares a CLI's implemented commands against its APP.md API map and traffic-analysis.json to find missing endpoints, incomplete CRUD, dead client methods, and priority gaps. Runs as the mandatory first step of /cli-anything-web:refine and as an optional pre-review scan in standards.
version
0.3.0
when_to_use
Trigger phrases: "gap analysis", "what's missing", "coverage report", "what endpoints are not implemented". For "refine" alone, use the…

CLI Gap Analyzer

Produce a structured gap report comparing a CLI's documented API surface against its implemented commands.

Where this skill runs:

  • /cli-anything-web:refine — mandatory first step. The refine command invokes this skill before reading or changing anything else; the gap report drives which endpoints get implemented.
  • standards skill — optional pre-review scan (endpoint coverage there is otherwise handled by the traffic-fidelity-reviewer agent).
  • Standalone coverage analysis on request.

Evidence rule: the captured-vs-implemented diff must cite its sources — each reported gap references the endpoint entry in <APP>.md (the documented surface) and, when available, traffic-capture/traffic-analysis.json (the analyzer's detected endpoint inventory), plus raw-traffic.json hit counts for priority. A gap with no citation in either file is a guess, not a finding.


Inputs

You need the path to an existing CLI's agent-harness directory:

  • {APP_PATH}/agent-harness/ — the CLI root
  • {app} — the app name (e.g., reddit, hackernews)

Evidence files (read all that exist):

  • {APP_PATH}/agent-harness/{APP_UPPER}.md — documented API map (required)
  • {APP_PATH}/traffic-capture/traffic-analysis.json — detected endpoints/protocol
  • {APP_PATH}/traffic-capture/raw-traffic.json — hit counts for priority scoring

Step 0: Deterministic First Pass (devkit)

Run the mechanical layer diff first — it AST-parses the client and command modules and cross-references traffic-analysis.json, so you only spend judgment on what it can't decide:

bash
cli-web-devkit gaps {app}     # or: PYTHONPATH=devkit python -m cli_web_devkit gaps {app}

The JSON report gives unimplemented_endpoints (captured but absent from client.py) and unexposed_methods (client methods no command calls). Treat these as candidate gaps to verify in Steps 1–3, not as final answers — the string-level endpoint matching is intentionally conservative.

Step 1: Parse Implemented Surface

Read all source files to build the set of implemented functionality:

1a. Extract Click commands

Read all files in {APP_PATH}/agent-harness/cli_web/{app}/commands/:

  • For each file, find @click.command() and @<group>.command() decorators
  • Extract: command group name, subcommand name, arguments, options
  • Build list: [(group, subcommand, [args], [options])]
1b. Extract client methods

Read {APP_PATH}/agent-harness/cli_web/{app}/core/client.py:

  • Find all public methods (not starting with _)
  • For each method, note: name, HTTP method used (GET/POST/etc), URL pattern
  • Build list: [(method_name, http_verb, url_pattern)]
Show full SKILL.md (219 more words)Show less
1c. Map commands to client methods

For each Click command, trace which client method it calls:

  • Read the command function body
  • Find client.method_name() calls
  • Build mapping: {command: client_method}

Step 2: Parse Documented Surface

Read {APP_PATH}/agent-harness/{APP_UPPER}.md (the API map):

  • Find the endpoint inventory section
  • Extract each documented endpoint: resource group, HTTP method, URL, params, description
  • Build list: [(resource, http_verb, url, params, description)]

Cross-check against {APP_PATH}/traffic-capture/traffic-analysis.json (if it exists): endpoints the analyzer detected but <APP>.md never documented are themselves a gap (stale API map) — report them with the traffic-analysis.json entry as the citation.

Step 3: Diff

Compare implemented vs documented:

Missing Commands

Endpoints in <APP>.md that have no corresponding Click command:

For each documented endpoint:
  Find matching client method (by URL pattern or method name)
  Find matching Click command (that calls this client method)
  If no command found → MISSING
Undocumented Commands

Click commands that call client methods not documented in <APP>.md:

For each Click command:
  Find the client method it calls
  Find the endpoint in <APP>.md for this method
  If no endpoint found → UNDOCUMENTED (possible hallucination)
Dead Client Methods

Client methods that no Click command calls:

For each public client method:
  Search all commands/*.py for calls to this method
  If no command calls it → DEAD
Incomplete CRUD

For each resource group, check CRUD coverage:

For each resource in <APP>.md:
  Check which CRUD ops the API supports (list, get, create, update, delete)
  Check which are implemented as commands
  If any supported op is missing → INCOMPLETE

Step 4: Priority Scoring (Optional)

If {APP_PATH}/traffic-capture/raw-traffic.json exists:

  • Count how many times each endpoint URL appears in captured requests
  • Assign priority: HIGH (5+ hits), MED (2-4 hits), LOW (1 hit)
  • Note: traffic captures are incomplete — endpoints not exercised during capture may be ranked LOW even if they are important to users

If raw-traffic.json doesn't exist, skip priority scoring and list all gaps alphabetically.

Step 5: Output Report

Present the gap report in this format:

Gap Report: cli-web-{app}
━━━━━━━━━━━━━━━━━━━━━━━━━
Coverage: X/Y endpoints (Z%)

Missing (HIGH priority):
  {HTTP_METHOD} {url} — {description} ({N} hits in traffic)
  ...

Missing (MED priority):
  {HTTP_METHOD} {url} — {description} ({N} hits)
  ...

Missing (LOW priority):
  {HTTP_METHOD} {url} — {description} ({N} hits)
  ...

Incomplete CRUD:
  {resource}: has {ops} ✓, missing {ops} ✗
  ...

Dead client methods:
  client.{method_name}() — not called by any command
  ...

Undocumented commands:
  {group} {subcommand} — calls client.{method}() but endpoint not in <APP>.md
  ...

If all endpoints are covered:

Gap Report: cli-web-{app}
━━━━━━━━━━━━━━━━━━━━━━━━━
Coverage: Y/Y endpoints (100%)
No gaps found. All documented endpoints are implemented.

© ItamarZand88, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in cli-anything-web-plugin/skills/gap-analyzer of ItamarZand88/CLI-Anything-WEB.

Open the folder on GitHubat commit 931e201

Compare with similar skills

Gap Analyzer 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.

Gap Analyzer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gap Analyzer this skillItamarZand88/CLI-Anything-WEB231—~1.6kAutomated safety check: PassMIT
Implementsickn33/agentic-awesome-skills47k5 repos~306Automated safety check: PassMIT
Iso27001 Gap Analyzerjeremylongshore/tons-of-skills-marketplace2.8k—~579Automated safety check: PassMIT
Implementcodewhale-hq/Codewhale41k—~190Automated safety check: PassMIT
Translational Gap Analyzeraipoch/medical-research-skills2k—~2.6kAutomated safety check: PassMIT
Tao Analyze Gaps Visual ChangenetNVIDIA/skills3.5k—~4.3kAutomated safety check: NotesApache-2.0

Similar skills

  • Implement

    sickn33/agentic-awesome-skills

    Implement a piece of work based on a PRD or set of issues. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 5 repos~306 tokens
    Product & Project ManagementAuto-check passed
  • Iso27001 Gap Analyzer

    jeremylongshore/tons-of-skills-marketplace

    Analyze iso27001 gap analyzer operations. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~579 tokensUpdated today
    Legal & ComplianceAuto-check passed
  • Implement

    codewhale-hq/Codewhale

    Carry an authorized, defined request or approved plan through scoped edits and proportionate verification.

    41k GitHub stars~190 tokensUpdated today
    Auto-check passed
  • Translational Gap Analyzer

    aipoch/medical-research-skills

    Assess translational gaps between preclinical models and human diseases.

    2k GitHub stars~2.6k tokensUpdated 22 days ago
    Research & ScienceAuto-check passed
  • Official

    Performs gap analysis on NVIDIA TAO VCN Classify (Visual Component Net) experiments by invoking the pinned TAO data-services container directly via docker run … gapanalysis vcnaoi … — picks the…

    3.5k GitHub stars~4.3k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Gaps

    anthropics/claude-for-legal

    Official

    Open gaps tracker — what's flagged and not yet closed. An agent skill from anthropics/claude-for-legal.

    9.6k GitHub starsUsed in 2 repos~229 tokens
    Auto-check passed

More from ItamarZand88/CLI-Anything-WEB

All 42 skills in this repo
  • Standards

    ItamarZand88/CLI-Anything-WEB

    Runs Phase 4 review/publish/verify for a cli-web- CLI: implementation review by 3 parallel agents, the tiered quality checklist (Tier 1 critical fail-fast, then comprehensive), pip install + smoke…

    231 GitHub stars~4.2k tokensUpdated 8 days ago
    Auto-check passed
  • Airbnb CLI

    ItamarZand88/CLI-Anything-WEB

    Searches Airbnb from the terminal via cli-web-airbnb — find stays by location, dates, and filters; get listing details, guest reviews, and availability calendars; autocomplete location names.

    231 GitHub stars~801 tokensUpdated 8 days ago
    Auto-check passed
  • Amazon CLI

    ItamarZand88/CLI-Anything-WEB

    Searches Amazon from the terminal via cli-web-amazon — product search, product details by ASIN, Best Sellers by category, and autocomplete suggestions.

    231 GitHub stars~570 tokensUpdated 8 days ago
    Auto-check passed
  • Booking CLI

    ItamarZand88/CLI-Anything-WEB

    Searches Booking.com from the terminal via cli-web-booking — find hotels, apartments, and hostels by destination, dates, and guests; get property details by slug; resolve destination names to IDs.

    231 GitHub stars~776 tokensUpdated 8 days ago
    Auto-check passed
  • Booking CLI

    ItamarZand88/CLI-Anything-WEB

    Use cli-web-booking to search Booking.com for hotels, apartments, hostels, and accommodations by destination, dates, and filters.

    231 GitHub stars~970 tokensUpdated 8 days ago
    Auto-check passed
  • Capitoltrades CLI

    ItamarZand88/CLI-Anything-WEB

    Queries US congressional stock trades (STOCK Act disclosures) on capitoltrades.com via the cli-web-capitoltrades command-line tool — trades with rich filters, politician profiles and leaderboards…

    231 GitHub stars~971 tokensUpdated 8 days ago
    Auto-check passed

Questions about Gap Analyzer

What does Gap Analyzer do?

Compares a CLI's implemented commands against its APP.md API map and traffic-analysis.json to find missing endpoints, incomplete CRUD, dead client methods, and priority gaps. Gap Analyzer is an agent skill from ItamarZand88/CLI-Anything-WEB.json to find missing endpoints, incomplete CRUD, dead client methods, and priority gaps.

How do I install Gap Analyzer in Claude Code?

Run `npx skills add ItamarZand88/CLI-Anything-WEB --skill gap-analyzer -a claude-code`. Or copy the skill folder (cli-anything-web-plugin/skills/gap-analyzer in ItamarZand88/CLI-Anything-WEB) into .claude/skills/gap-analyzer in your project. Claude Code loads it when a task matches its description.

How do I install Gap Analyzer in Codex?

Run `npx skills add ItamarZand88/CLI-Anything-WEB --skill gap-analyzer -a codex`. Or copy the skill folder (cli-anything-web-plugin/skills/gap-analyzer in ItamarZand88/CLI-Anything-WEB) into .agents/skills/gap-analyzer in your project. Codex loads it when a task matches its description.

Can I use Gap Analyzer 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 ItamarZand88/CLI-Anything-WEB --skill gap-analyzer -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-analyzer, .gemini/skills/gap-analyzer, .github/skills/gap-analyzer and .opencode/skills/gap-analyzer in your project.

What does Gap Analyzer need to run?

SKILL.md names no scripts, command-line tools or credentials: Gap Analyzer is instructions for the agent only. Our summary lists: Python 3.

Does Gap Analyzer 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 Analyzer 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. Review the folder before installing.

What licence does Gap Analyzer use?

Gap Analyzer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gap Analyzer use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gap Analyzer?

Skills that share tags, products or a category with Gap Analyzer: Implement (sickn33/agentic-awesome-skills, 47k stars), Iso27001 Gap Analyzer (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Implement (codewhale-hq/Codewhale, 41k stars) and Translational Gap Analyzer (aipoch/medical-research-skills, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gap Analyzer?

ItamarZand88 (a GitHub user) maintains it in ItamarZand88/CLI-Anything-WEB, which has 231 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on October 1, 2026.

Source: ItamarZand88/CLI-Anything-WEB on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.