Skill Architect — Claude Skill Corpus Compiler

Turn any large body of source material — a wiki, an SOP binder, an API reference, a compliance manual, a brand system — into a Claude Skill that loads only what a given question needs, instead of a skill that dumps the whole corpus into every conversation.

What this Claude Skill does

• Surveys the source material's size, shape, and query pattern before writing anything, so the decomposition strategy fits how the skill will actually get used
• Picks the right decomposition — sequence, topic, procedure, or reference units — instead of defaulting to whatever order the source document happened to be in
• Builds a lightweight router SKILL.md that indexes every unit in one line each, so Claude loads only the relevant file instead of re-reading the whole corpus on every query
• Ships with a working token-budget linter script that scans the compiled skill and blocks the release on oversized routers, orphaned units, missing references, and duplicated content

Built for

• Teams turning an internal wiki, playbook, or knowledge base into something Claude can reference efficiently instead of pasting into every chat
• Agencies and consultants compiling client-specific reference material (brand systems, SOPs, compliance docs) into reusable skills
• Anyone who tried dumping a big document into a SKILL.md and found every query got slower and more expensive as the corpus grew

What's inside

• SKILL.md — the full skill file with frontmatter and the five-phase compilation methodology (survey, decompose, route, compile & lint, trigger-test)
• scripts/token_budget_linter.py — a standard-library-only Python script that scans a compiled skill folder and flags oversized/undersized units, orphaned units, missing references, and duplicate paragraphs
• templates/ — router-index, unit-file, glossary, and decision-table templates for compiling the corpus
• reference/anti-patterns.md — 11 documented ways corpus-to-skill compiles fail, each with the fix
• reference/token-budget-linter-guide.md — what the linter checks and how to read its report
• LICENSE.md — usage terms

How a Claude Skill works

This is a Claude Skill — a single SKILL.md file Claude reads as instructions for a specific kind of work. Drop it in your Claude Project, .claude/skills/ folder, or wherever Claude can read it. Claude triggers the skill automatically when your prompt matches its description, then runs the methodology end to end.

Author

Built by Ukiyo Productions — a strategy-led branding and growth agency. Part of a 100+ skill marketplace built for founders, operators, consultants, and agencies.