skill-authoringlisted
Install: claude install-skill qingsongcui/claude-code-skills
# Skill authoring
Produce a skill that a host can discover and an agent can select. Treat “the file exists” as a starting condition, not proof that the skill is usable.
Official format reference: <https://agentskills.io/specification>.
## First decide the delivery mode
| Delivery mode | Put the skill here | Verify it with |
|---|---|---|
| Claude Code personal skill | `~/.claude/skills/<name>/SKILL.md` | Restart/reload, then invoke or ask for a matching task |
| Claude Code project skill | `.claude/skills/<name>/SKILL.md` | Open the target project, then test in that project |
| Claude Code plugin skill | `<plugin>/skills/<name>/SKILL.md` | Install the plugin, reload plugins, use `/<plugin>:<skill>` |
| Another Agent Skills host | That host’s documented skill directory | Host-specific discovery check |
Do not promise universal auto-discovery. Hosts may use different paths, activation rules, and tool permissions.
## Build the smallest valid skill
One skill is one directory with one required file:
```text
skill-name/
├── SKILL.md
├── scripts/ # optional executable helpers
├── references/ # optional, open only when needed
└── assets/ # optional templates or static data
```
The directory name must match the frontmatter `name`. Per the Agent Skills specification, `name` is lowercase letters, numbers, and hyphens; `description` must say both **what the skill does** and **when to use it**.
```yaml
---
name: todo-cli-maintainer
description: >
Maintain the s