skywalkskills

CatalogueDelivery Documentation & QA

H2Ready

Spec Gap Analysis

Compares a spec with what the code does now, and estimates the gap.

What it examines

  • Requirements checked against the files, not against memory
  • A gap table in the spec's own structure
  • A timeline for a team and for an agent
  • Regression risk drawn from this project's conventions

What you get back

A gap analysis with a timeline, sourced from the spec and the code.

Dependencies

  • An AI coding agent that reads SKILL.md files, such as Claude Code, Codex or Gemini CLI
  • The spec or requirements document, or several versions of it
  • Read access to the codebase it describes. Any language or stack works.
  • Optional: pandoc, to read .docx specs. The skill checks whether it is installed first.
  • Optional: Google Chrome, to render the short PDF for non-technical readers, and pdftoppm to check its pages

How it works

It reads every spec in full, then checks what is actually built against real files, not memory. Where there are two versions, you tell it which is the scope and which is the baseline.

It produces a gap table taken from the spec’s own structure, a timeline for a human team and for AI-assisted work, and a regression-risk view based on your project’s own conventions.

It writes an analysis, not code. If the audience is a non-technical reader, it also builds a short PDF with colour-coded diagrams.

Setup

  1. Unzip the download. Copy the skill folder into your agent's skills folder (for Claude Code, .claude/skills/) in the repository you want to check, or into its global skills folder for every project.
  2. Have the spec file ready. For .docx specs, check that pandoc is installed. For the PDF option, check that Chrome is installed.
  3. Restart your agent, then ask it to run the generate-spec-gap-analysis skill.
  4. Tell it which spec is the scope, which part of the codebase to check and who will read the result.

Run it with your agent

Copy the prompt, fill in the parts in square brackets, and paste it into your agent.

Prompt

Run the generate-spec-gap-analysis skill. Spec file(s): [paths]. Scope source: [which file]. Baseline: [which file, or none]. Part of the codebase to check: [whole repo, or a module]. Audience: [internal, or a named non-technical reader].

What is inside

The files that make up this skill, as your agent reads them.

packages/h2-spec-gap-analysis

skill › SKILL.md

Sign in to download

Use the email and password you signed up with.