vibe-gap-analysis

vibe-gap-analysis is a skill for Claude Code, Codex from ash1794/vibe-engineering. It costs 36 tokens per session (1,358 once invoked), scanned A, original, MIT.

A code-audit guide that compares a project's design documents or specifications with its implementation. It offers a quick review, a full 17-area audit, or a focused review of selected areas.

In plain words
What is it for?
Use it for production-readiness checks, completeness reviews, and audits of projects that have both specifications and code.
Why use it?
It reveals missing, incomplete, or lost work before release, after refactoring, or when taking over an unfamiliar codebase.

Skill for Claude CodeCodex

Part of the vibe-engineering plugin — 38 skills shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/ash1794/vibe-engineering/gap-analysis
Any agent
npx skills add ash1794/vibe-engineering --skill gap-analysis
Clone the repo
git clone --depth 1 https://github.com/ash1794/vibe-engineering

Made for: Claude Code, Codex.

Or install vibe-engineering, the plugin that ships this one along with the rest of its 38 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for vibe-gap-analysis

README.md
[![agentmods](https://agentmods.dev/badge/skills/ash1794/vibe-engineering/gap-analysis.svg)](https://agentmods.dev/skills/ash1794/vibe-engineering/gap-analysis)
Your own site
<a href="https://agentmods.dev/skills/ash1794/vibe-engineering/gap-analysis"><img src="https://agentmods.dev/badge/skills/ash1794/vibe-engineering/gap-analysis.svg" alt="Measured on agentmods" height="20"></a>
Per session 36 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,358 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00036 $0.01358
Opus 5 $0.00018 $0.00679
Sonnet 5 $0.00007 $0.00272
Haiku 4.5 $0.00004 $0.00136

Measured 3d ago against content hash 092ddcd537ea, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

vibe-gap-analysis scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

plugins/vibe-engineering/skills/gap-analysis/SKILL.md · 144 lines

How it starts

The opening of the file, as written. The whole thing — 144 lines — stays where its author put it; the contents beside it link to each section on GitHub.

vibe-gap-analysis

Cynical gap analysis comparing specs/architecture to actual implementation. Three modes from fast to exhaustive. Works with any project that has architecture docs and implementation code.

When to Use This Skill

  • Before launching to production
  • After a major refactor to verify nothing was lost
  • When inheriting a codebase and need to assess completeness
  • Periodic production readiness audits
  • When stakeholders ask "how done are we?"

When NOT to Use This Skill

  • Greenfield projects with no specs yet (write specs first)
  • Simple bug fixes or feature additions
  • Frontend-only or design-only reviews

Usage

/vibe-gap-analysis              # Quick static (5 structural dimensions)
/vibe-gap-analysis --deep       # Full 17-dimension audit with parallel agents
/vibe-gap-analysis --dim N      # Single dimension deep-dive (1-17)
/vibe-gap-analysis --dim 1,4,9  # Multiple specific dimensions

Modes

Quick Static (default)

Fast, single-agent structural audit. No subagents dispatched.

  1. Read architecture/design docs in docs/ or similar
  2. Read implementation code in src/, internal/, lib/ etc.
  3. Compare implementation against architecture doc section by section
  4. Cover dimensions 1-5 (structural):
    • Dim 1: Spec Compliance — check specs against implementation
    • Dim 2: Backend Code Quality — test coverage, error handling, lint issues
    • Dim 3: Frontend Completeness — UI components, routes, test coverage
    • Dim 4: Deployment & Ops — deploy scripts, CI/CD, Docker, TLS
    • Dim 5: Architecture Integrity — design pattern compliance, component boundaries
  5. Produce structured gap report: component, expected status, actual status, % complete, action items
  6. Save to docs/plans/gap-analysis-$(date +%Y%m%d).md
  7. Commit with docs: gap analysis $(date +%Y%m%d)

Deep (--deep)

Full 17-dimension audit using parallel subagents. Exhaustive production readiness assessment.

Dispatch parallel agents (model: sonnet) in 3 rounds:

Read the full file on GitHub · 144 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 144 lines · 36 tokens per session scan A 092ddcd537ea

Subscribe to this mod's changes

vibe-gap-analysis is a skill published in the GitHub repository ash1794/vibe-engineering (10 stars, last pushed 3mo ago), licensed MIT. It adds 36 tokens to every session and 1,358 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

pptgen-drawio

根据论文或汇报内容生成多页 Draw.io 格式 PPT,支持论文答辩与通用汇报两种模式,自动导出为 .pptx。当用户提到论文答辩 PPT、答辩幻灯片、通用 PPT、汇报 PPT、根据模板生成 PPT、drawio2pptx 时使用。.

xstongxue/best-skills · 80 tokens

create-skill

Guides users through creating effective Agent Skills for Cursor. Use when the user wants to create, write, or author a new skill, or asks about skill structure, best practices, or SKILL.md format.

xstongxue/best-skills · 46 tokens

wechat-article-writer

公众号/自媒体全流程。根据用户表述自动匹配:撰写文章、封面图、正文插图、风格提取。支持多种写作风格。当用户提到写公众号、技术博客、公众号封面、正文插图、步骤图、演示图、流程示意、分析写作风格、克隆文风、模仿爆款、提取风格时使用。详见 reference 目录。.

xstongxue/best-skills · 105 tokens

project-docs

对任意代码项目生成一套面向新人的循序渐进文档集,输出到 docs/ 目录。含架构、设计思想、语言特性、代码导读、运行时模型、构建、对接、调试、设计规范共 9 篇,支持全部生成 / 只写几篇 / 更新已有文档。当用户提到"生成项目文档"、"新人文档"、"上手文档"、"架构文档"、"代码导读"、"项目理解"、"深入理解项目"、"onboarding 文档"、"给新同事看的文档"时使用。要按用户给的格式写论文章节、项目梳理、重点问题、简历项目描述的,用 codegen-doc。.

xstongxue/best-skills · 177 tokens

drawio-diagram

为深度学习模型、网络架构、算法流程等生成标准 Draw.io (.drawio) 格式的可视化图表;支持从零生成与风格迁移两种模式。从零生成:模型架构图、流程图、感受野示意图等;风格迁移:参考图 + 内容描述/项目 → 按参考图风格生成新图。确保 XML 格式正确,可直接在 Draw.io 中打开编辑。.

xstongxue/best-skills · 104 tokens

skill-prompt-convert

在 Skill(SKILL.md)与 Prompt(聊天框指令)两种格式之间相互转换。支持 Skill→Prompt 与 Prompt→Skill 双向转换,保持核心信息零丢失。当用户提到 Skill 转 Prompt、Prompt 转 Skill、格式互转、SKILL.md 转换时使用。.

xstongxue/best-skills · 72 tokens