Spec Distill — Protocol Specification to Claude Code Skill

Overview

Transforms a large protocol specification (markdown, 3,000–9,000 lines) into a compact Claude Code skill (25–40KB) through 5 phases: Survey, Extraction, Synthesis, Compression, and Package. The output is a ready-to-install skill under .claude/skills/<spec-name>/.

Input: Path to a markdown specification file (e.g., scripts/markdown/cesr-specification.md) Output: .claude/skills/<spec-name>/SKILL.md + references/*.md

Workflow

Phase 1 — Survey

Goal: Understand the spec's structure, classify content, plan reference file organization.

1. Parse the input argument to get the spec markdown path. Derive spec-name from the filename (e.g., cesr-specification.md → cesr; keri-specification.md → spec).