xonecas.io
696
Cs

coder-skills / files

coder-skills / AGENTS.md

990 bytes
1# AGENTS.md
2
3This repo contains agent skills that follow the [agentskills.io](https://agentskills.io) open spec.
4
5## Structure
6
7Each skill is a top-level directory named after the skill, containing a `SKILL.md` file. The directory name must match the `name` field in the SKILL.md frontmatter.
8
9## Conventions
10
11- Skills must be compliant with the agentskills.io spec
12- SKILL.md frontmatter requires: `name`, `description`
13- SKILL.md body should stay under 500 lines / 5,000 tokens
14- Move detailed reference material to `references/` subdirectory
15- Scripts go in `scripts/` and should be self-contained, non-interactive, and produce structured output (JSON/CSV to stdout, diagnostics to stderr)
16- Description field should use imperative phrasing ("Use when...") and list trigger contexts explicitly
17
18## Adding a new skill
19
201. Create a directory: `skill-name/`
212. Add `SKILL.md` with YAML frontmatter (`name`, `description`) and markdown instructions
223. Update the skills table in `README.md`