AGENTS.md git:20260807.1aa79a2A

Immutable. This exact content never changes and is served at /api/v1/blob/3e4a0bc9391d57b9.

# AGENTS.md

Markdown-first skills collection — no build, tests, or linters. Skills may ship small helper scripts under `skills/<name>/scripts/`.

## Skill File Format

- Each skill lives at `skills/<name>/SKILL.md` with YAML frontmatter (`name`, `description`, `version`).
- `description` MUST be a single-line string — never a YAML block scalar (`|` or `>`); block scalars break skill registration.
- Keep `description` ≤1024 chars, or Codex CLI silently skips the skill.
- Optional `references/` subdirectory for supporting docs, linked from SKILL.md.

## Non-Obvious Rules

- Keep skills self-contained: each SKILL.md must work standalone, with no dependency on other skills.
- Register every new skill in `.claude-plugin/marketplace.json` (the `skills` array) or it won't be published.
- The skills.sh renderer crashes on Markdown tables and zero-width-char fence hacks in SKILL.md — use bullet lists and 4-backtick outer fences instead.