Source: frameworks/kit-skill-build/00-skill-build-start-here.md

Skill Build Kit — Start Here

What This Kit Does

This kit produces a Claude skill file (.md) and its companion quick-start guide. One skill, two assets. The skill is the product. The quick-start is the setup documentation that ships with it.

A skill file is a markdown document that Claude reads as custom instructions. It defines what the skill does, how to produce the output, the rules it follows, and the exact output format. The quick-start guide tells the recipient how to install and run it.

What It Produces

#	Asset	Format	Purpose
1	Skill File	`.md`	The product — Claude reads this and produces the output
2	Quick-Start Guide	`.md`	Setup instructions for the recipient

Production Sequence

[1] Skill File ──→ Test on real data ──→ Fix until output matches spec
                                              │
                                              ▼
                                    [2] Quick-Start Guide

The skill file must be tested and producing correct output before the quick-start guide is written. The quick-start references the skill's trigger phrase, input requirements, and output sections — all of which come from the tested skill.

Skill File Architecture

Every skill file follows this structure:

Section	Purpose
YAML Frontmatter	Name, description, triggers, metadata (author, version, date)
Heading + Positioning	One-line statement of what this skill does
Core Principle	The operating rule that makes the skill produce good output
What This Skill Does	3 jobs the output performs for the user
Section-by-Section Spec	Each output section defined: what it contains, why it matters, format rules
Rules	Bullet list of constraints (format, input, scope, quality)
Output Format	Complete template with placeholders — the exact structure the skill produces
What Makes This Different	2-3 paragraphs — why this isn't a generic prompt

Quick-Start Guide Architecture

Section	Purpose
What You Need	Prerequisites (Claude Pro, input description)
Setup (One Time)	Enable code execution + upload skill (numbered steps)
Running the Skill	Trigger phrase, paste input, wait
Tips	3-5 tips from real testing
What to Paste	Accepted input types

File Inventory

File	Purpose	When to Use
`00-skill-build-start-here.md`	Orientation — what this produces, architecture	Start here every time
`01-skill-build-context.md`	Required inputs and concept brief template	Before every build — complete inputs first
`02-skill-build-terminology.md`	Locked vocabulary for skills and quick-start guides	Reference when writing
`03-skill-build-golden-example.md`	Pointers to Client Intelligence Brief golden examples	Study before building
`04-skill-build-quality.md`	QC checklist — skill file structure, testing, quick-start completeness	Run after every build
`05-skill-build-output-skill.md`	Production workflow — step by step	Follow for every build

Relationship to Other Kits

Skill Delivery Page Kit (content/frameworks/kit-skill-delivery-page/): The delivery page references the skill's output sections, trigger phrase, and input requirements. Build the skill first — the delivery page depends on it.

Handraiser Post Kit (content/frameworks/kit-handraiser-post/): The LinkedIn post references the skill's real testing results. The skill must be tested before the post can be written.

DM Sequence Kit (content/frameworks/kit-dm-sequence/): DMs deliver the skill via page link. The skill must exist and be hosted before DMs reference it.

business-aos (Connected Repo): Voice, audience, and proof references come from here. Load business-aos/reference/core/voice.md before writing any copy.

Golden Standard Reference

The Client Intelligence Brief is the golden example. Both files live in content/business/marketing/campaigns/practice-command-center/:

client-intelligence-brief.md — the skill file
quick-start.md — the quick-start guide