blader

Schematic — Testing skill for Claude Code

Testing community

Claude Code / Codex skill: reverse engineer a product & technical spec from a git branch.

How to install Schematic

This entry records only its repository, not the path inside it, so there is no exact command to give. Open blader/schematic and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Schematic does

Claude Code / Codex skill: reverse engineer a product & technical spec from a git branch.

Alternatives in Testing

AI Contribution Skills (Engram) — branch-pr: clean branch and PR workflow 2.5k ★
Spec Kitty — Spec-Driven Development for serious software developers 1.6k ★
Adversarial Spec — A Claude Code plugin that iteratively refines product specifications by debating between multiple LLMs until a 514 ★

README

schematic

A skill that reverse engineers a detailed product and technical specification from a git branch's implementation.

Use it when:

A branch has shipped or is in-progress and needs documentation
You need to understand what a branch does at product and architecture level
Onboarding to someone else's feature branch
Creating PR descriptions or design docs after the fact

Produces a structured markdown spec covering problem statement, product requirements, architecture, technical design, file inventories, testing strategy, rollout plan, and risks.

Install

Claude Code

git clone https://github.com/blader/schematic.git ~/.claude/skills/schematic

Restart Claude Code to pick up the new skill.

Codex

git clone https://github.com/blader/schematic.git ~/.codex/skills/schematic

Or use the built-in skill installer:

Install the skill from github.com/blader/schematic

Restart Codex to pick up the new skill.

Usage

In Claude Code or Codex, just ask:

"Reverse engineer a spec from this branch"
"Analyze this branch"
"Write a spec from the code"
"Document what this branch does"

The skill will systematically analyze every file changed on the branch and produce a comprehensive specification document.

How it works

Scope the branch - Gets the full diff stats and categorizes files
Parallel deep exploration - Launches 2-4 parallel agents to read file groups concurrently
Cross-check for gaps - Diffs analyzed files against the full file list to catch stragglers
Write the spec - Produces a structured 11-section markdown document
Verify completeness - Ensures every changed file is accounted for