← ClaudeAtlas

skill-authoringlisted

Write, debug, and install Agent Skills (SKILL.md). Use when a skill is ignored, never auto-invoked, has YAML/frontmatter errors, is in the wrong directory, or when the user asks to author a skill, choose trigger words, distribute a Claude Code plugin marketplace, or diagnose a SKILL.md loading failure.
qingsongcui/claude-code-skills · ★ 0 · API & Backend · score 70
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