SuperAPI AI Directory

managing-skills

General & other

View repository

Updated 10-16 05:45

About this skill

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