@@ -0,0 +1,46 @@
1+# coder-skills
2+
3+A collection of agent skills compliant with the [agentskills.io](https://agentskills.io) open spec.
4+
5+## Skills
6+
7+| Skill | Description |
8+|-------|-------------|
9+| [code-review](code-review/) | Thorough, structured code review with severity-tiered findings |
10+
11+## Usage
12+
13+Copy or symlink a skill directory into one of the standard discovery paths:
14+
15+```
16+# Project-level (any agent)
17+<project>/.agents/skills/
18+
19+# Project-level (client-specific)
20+<project>/.<client-name>/skills/
21+
22+# User-level (any agent)
23+~/.agents/skills/
24+
25+# User-level (client-specific)
26+~/.<client-name>/skills/
27+```
28+
29+Any agent that supports the agentskills.io spec will discover and load skills from these locations.
30+
31+## Skill structure
32+
33+Each skill is a directory containing a `SKILL.md` file with YAML frontmatter and markdown instructions:
34+
35+```
36+skill-name/
37+├── SKILL.md # Required: metadata + instructions
38+├── scripts/ # Optional: executable scripts
39+├── references/ # Optional: additional documentation
40+├── assets/ # Optional: templates, schemas, data files
41+└── evals/ # Optional: test cases
42+```
43+
44+## License
45+
46+MIT