skill-authorlisted

# Authoring a cross-agent SKILL.md skill A skill is a folder with a `SKILL.md` file inside. The file starts with a YAML frontmatter block (name + description) followed by Markdown instructions the agent loads on demand. Because Claude Code, DeepSeek Harness (dsh), Codex CLI, Gemini CLI, Copilot and Cursor all read this same format, one well-authored skill serves every agent. ## Anatomy ``` my-skill/ ├── SKILL.md # required: frontmatter + instructions ├── references/ # optional: long-form docs the model reads on demand └── scripts/ # optional: helper scripts the skill may run ``` ```markdown --- name: my-skill description: >- One or two sentences: what it does AND when to use it. This is the trigger the agent matches against the user's request — write it like a routing rule. --- # My skill Step-by-step instructions. Assume a competent engineer; be concrete, not vague. ``` ## Rules that decide whether a skill works 1. **`name` must be kebab-case** — lowercase letters, digits, hyphens; max 64 chars. Agents reject or mangle other names. `aipx` normalizes for you, but ship it correct. 2. **`description` is the trigger, not documentation.** Bad: "Utilities for working with things." Good: "Summarize YouTube/Bilibili videos and podcasts from a URL. Use when the user pastes a video or audio link." 3. **Keep SKILL.md under ~500 lines.** Put depth in `references/*.md` and link to them ("see references/schema.md"). Agents load the