# Agents: recursive-decomposition skill

Entrypoint for agentic tooling working on this repository.

## Read these first (mandatory)

| Doc | Why |
|-----|-----|
| **[CONVENTIONS.md](./CONVENTIONS.md)** | Skill format, sources, prose, git, versioning, validation |
| **[CONTRIBUTING.md](./CONTRIBUTING.md)** | Change workflow |
| **[skills/recursive-decomposition/SKILL.md](./skills/recursive-decomposition/SKILL.md)** | The skill itself |
| **[CHANGELOG.md](./CHANGELOG.md)** | Release history |

Follow **CONVENTIONS.md** for every change. This file is a short checklist only. `CLAUDE.md` is a symlink to this file.

## Language policy

- Markdown, manifests, commits: English only.

## Non-negotiables

1. Every number or claim about the paper cites arXiv:2512.24601; nothing invented.
2. `SKILL.md` stays under 500 lines with a single-line, double-quoted description.
3. The skill name and the plugin name never change.
4. Bump `version` in `.claude-plugin/plugin.json` and `SKILL.md` together on every user-visible change.
5. No em dash, no filler, no co-author trailers, no Python.

## Commands

```bash
bash .github/scripts/validate-skill.sh
npx -y skills@latest add . -l
claude plugin validate .
```