doc updates

This commit is contained in:
John Lancaster
2026-06-20 14:56:25 -05:00
parent 467e1d3c35
commit bb7508cf65
9 changed files with 537 additions and 79 deletions
+6 -4
View File
@@ -1,8 +1,10 @@
# Hooking Up a New Skill
Use this checklist to add a new skill in the Phase 1 docs-first model.
Use this checklist to add a new skill in the docs-first model.
## Step 1 Contract: Canonical Skill Shape
For the full contract details, see [Content Contract](./content.md), [Frontmatter Contract](./frontmatter.md), and [URI Contract](./uris.md).
## Canonical Skill Shape
Create one skill directory under `docs/skills/`:
@@ -22,7 +24,7 @@ Rules:
3. Skill directories are ownership boundaries; no cross-skill writes.
4. `skill-id` is lowercase kebab-case and should remain stable.
## Step 2 Contract: SKILL.md Frontmatter
## SKILL.md Frontmatter
`SKILL.md` frontmatter is authoritative for metadata.
@@ -74,7 +76,7 @@ Reference manifest rules:
No `metadata.yaml` sidecar is part of this model.
## Step 3 Contract: URI Surface
## URI Surface
Canonical resource URIs for a skill: