skill-management

Skill Management -- CRUD for the Skill Library

When to use

• User asks "what skills do I have?" or "list skills"
• User wants to inspect a specific skill's content
• A /retrospective proposes CREATE, PATCH, or DELETE actions on skills
• User says "update skill X" or "fix skill Y"
• Periodic audit: check for stale or duplicate skills

Arguments

Argument	Required	Description
action	YES	One of: list, show, create, patch, delete, audit
name	for show/patch/delete	Skill directory name (e.g. github-pr-rebase-merge)
scope	no	global (default, ~/.claude/skills/) or local (./claude/skills/)

Examples:

• /skills action=list -- list all skills with descriptions
• /skills action=show name=github-pr-rebase-merge -- show full SKILL.md
• /skills action=create name=new-skill -- interactive skill creation
• /skills action=patch name=existing-skill -- modify specific sections
• /skills action=delete name=old-skill -- remove with confirmation
• /skills action=audit -- find stale, duplicate, or oversized skills

Procedure

action=list

SKILL_DIR="${HOME}/.claude/skills"
if [ "$SCOPE" = "local" ]; then SKILL_DIR="./.claude/skills"; fi

echo "=== Skills in $SKILL_DIR ==="
for dir in "$SKILL_DIR"/*/; do
  skill_file="$dir/SKILL.md"
  if [ -f "$skill_file" ]; then
    name=$(basename "$dir")
    # Extract description from frontmatter
    desc=$(sed -n '/^description:/{ s/^description: *//; p; q; }' "$skill_file")
    printf "  %-35s %s\n" "$name" "$desc"
  fi
done

Present as a compact table. If both global and local exist, show both.

action=show

1. Read ~/.claude/skills/{name}/SKILL.md
2. If it has a references/ subdirectory, list those files too
3. Present the full content

action=create

Interactive skill creation workflow:

1. Ask for trigger context: "When should this skill activate?"
2. Ask for procedure steps: "What does it do, step by step?"
3. Generate SKILL.md with proper frontmatter: