xonecas.io
64875
Mc

mini-coder / commit b896840

docs: add skills.md

Sean2026-02-25 b896840f50b6898cb2f13e29c9133a8410c7af63 parent 910f91c

1 file changed

docs/skills.md+71−0
@@ -0,0 +1,71 @@
1+# Skills
2+
3+A skill is a reusable instruction file injected inline into your prompt.
4+Use `@skill-name` to load it — the content is inserted into the message
5+before it's sent to the LLM.
6+
7+> **Skills are never auto-loaded.** They must be explicitly referenced
8+> with `@skill-name` in your prompt. Nothing is injected automatically.
9+
10+## Where to put them
11+
12+Each skill is a folder containing a `SKILL.md`:
13+
14+| Location | Scope |
15+|---|---|
16+| `.agents/skills/<name>/SKILL.md` | Current repo only |
17+| `~/.agents/skills/<name>/SKILL.md` | All projects (global) |
18+
19+Local skills override global ones with the same name.
20+
21+## Create a skill
22+
23+The folder name becomes the skill name (unless overridden by `name:` in frontmatter).
24+
25+`.agents/skills/conventional-commits/SKILL.md`:
26+
27+```md
28+---
29+name: conventional-commits
30+description: Conventional commit message format rules
31+---
32+
33+# Conventional Commits
34+
35+All commit messages must follow this format:
36+
37+ <type>(<scope>): <short summary>
38+
39+Types: feat, fix, docs, refactor, test, chore
40+- Summary is lowercase, no period at the end
41+- Breaking changes: add `!` after type, e.g. `feat!:`
42+- Body is optional, wrapped at 72 chars
43+```
44+
45+Then in the REPL:
46+
47+```
48+@conventional-commits write a commit message for my staged changes
49+```
50+
51+The skill content is wrapped in `<skill name="…">…</skill>` tags and
52+included in the message sent to the LLM.
53+
54+## Frontmatter fields
55+
56+| Field | Required | Description |
57+|---|---|---|
58+| `name` | No | Skill name for `@` reference. Defaults to folder name. |
59+| `description` | No | Shown in `/help`. Defaults to name. |
60+
61+## Tab completion
62+
63+Type `@` and press `Tab` to autocomplete skill names alongside files.
64+
65+## Listing skills
66+
67+```
68+/help
69+```
70+
71+Skills are listed in yellow, tagged `(local)` or `(global)`.