Managing Skills
Overview
House style for this catalog's skills: contract layout and lean writing. Recipes own create, update, and review; skill-contract.md is structure; lean-contract.md is the leanness test.
Agent workflow
Follow this skill when creating, updating, or reviewing a skill that uses this catalog's layout (SKILL.md, references/, agents/openai.yaml). Works wherever the agent can read and write skill directories. Match one Recipes row; open that reference, skill-contract.md, and lean-contract.md.
Recipes
| Intent |
Example phrasing |
Read |
| Create |
"Create a skill for …", "Write a new skill", "add a skill" |
creating-skill.md |
| Update |
"Lean this skill", "Add a recipe", "Fix section order", "trim / de-noise this skill" |
updating-skill.md |
| Review |
"Review this skill", "Is this SKILL.md too verbose?", "Does this follow the contract?" |
reviewing-skill.md |
Reference index
Contract
skill-contract.md — layout, naming, SKILL.md and reference sections, independence, checklist. lean-contract.md — finding categories, strategies, content shape.
| Doc |
When to use |
| skill-contract.md |
Layout, naming, sections, independence, resolve target, checklist |
| lean-contract.md |
Leanness test, finding categories, strategies, content shape |
| creating-skill.md |
New skill directory; authoring mode |
| updating-skill.md |
Amend structure, lean an existing skill, or both |
| reviewing-skill.md |
Read-only contract and leanness audit |
1---2name: managing-skills3description: Creates, updates, and reviews agent skills that follow this catalog's house style — directory layout, SKILL.md and reference sections, naming, independence, and lean writing. Use when the user asks to write, create, add, update, lean, trim, restructure, or review a skill or SKILL.md, or when authoring skills under skills/.4---56# Managing Skills78## Overview910House style for this catalog's skills: contract layout and lean writing. Recipes own create, update, and review; [skill-contract.md](references/skill-contract.md) is structure; [lean-contract.md](references/lean-contract.md) is the leanness test.1112## Agent workflow1314Follow this skill when creating, updating, or reviewing a skill that uses this catalog's layout (`SKILL.md`, `references/`, `agents/openai.yaml`). Works wherever the agent can read and write skill directories. Match one **Recipes** row; open that reference, [skill-contract.md](references/skill-contract.md), and [lean-contract.md](references/lean-contract.md).1516### Recipes1718| Intent | Example phrasing | Read |19| --- | --- | --- |20| Create | "Create a skill for …", "Write a new skill", "add a skill" | [creating-skill.md](references/creating-skill.md) |21| Update | "Lean this skill", "Add a recipe", "Fix section order", "trim / de-noise this skill" | [updating-skill.md](references/updating-skill.md) |22| Review | "Review this skill", "Is this SKILL.md too verbose?", "Does this follow the contract?" | [reviewing-skill.md](references/reviewing-skill.md) |2324## Reference index2526### Contract2728[skill-contract.md](references/skill-contract.md) — layout, naming, `SKILL.md` and reference sections, independence, checklist. [lean-contract.md](references/lean-contract.md) — finding categories, strategies, content shape.2930| Doc | When to use |31| --- | --- |32| [skill-contract.md](references/skill-contract.md) | Layout, naming, sections, independence, resolve target, checklist |33| [lean-contract.md](references/lean-contract.md) | Leanness test, finding categories, strategies, content shape |34| [creating-skill.md](references/creating-skill.md) | New skill directory; authoring mode |35| [updating-skill.md](references/updating-skill.md) | Amend structure, lean an existing skill, or both |36| [reviewing-skill.md](references/reviewing-skill.md) | Read-only contract and leanness audit |
cedmandocdoc