creating-skills

npx skills add AgentWorkforce/relay --skill creating-skills-skill --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Creating Skills ## Overview **Skills are reference guides for proven techniques, patterns, or tools.** Write them to help future Claude instances quickly find and apply effective approaches. Skills must be **discoverable** (Claude can find them), **scannable** (quick to evaluate), and **actionable** (clear examples). **Core principle**: Default assumption is Claude is already very smart. Only add context Claude doesn't already have. ## When to Use **Create a skill when:** - Technique wasn't intuitively obvious - Pattern applies broadly across projects - You'd reference this again - Others would benefit **Don't create for:** - One-off solutions specific to single project - Standard practices well-documented elsewhere - Project conventions (put those in `.claude/CLAUDE.md`) ## Required Structure ### Frontmatter (YAML) ```yaml --- name: skill-name-with-hyphens description: Use when [triggers/symptoms] - [what it does and how it helps] tags: relevant-tags --- ``` **Rules:** - Only `name` and `description` fields supported (max 1024 chars total) - Name: letters, numbers, hyphens only (max 64 chars). Use gerund form (verb + -ing) - Avoid reserved words: "anthropic", "claude" in names -

set -e  # Exit on error
if [ ! -f "config.json" ]; then
echo "Error: config.json not found" >&2
exit 1
fi
Script logic here
echo "Success"
exit 0