AgentSkillsCN

create-skill

使用多重 YAML 模式搭建新的技能目录。适用于用户输入“/create-skill”时使用。

SKILL.md
--- frontmatter
name: create-skill
description: Scaffold a new skill directory using the multi-YAML pattern. Use when user says /create-skill.
user-invocable: true
allowed-tools: [Read, Write, Edit, Bash, Grep, Glob]
hooks:
  Stop:
    - type: command
      command: "task claude:validate-skill -- --skill create-skill"
  PostToolUse:
    - matcher: "Edit|Write"
      hooks:
        - type: command
          command: "$CLAUDE_PROJECT_DIR/.claude/hooks/check-skill-structure.sh"

Create Skill

Purpose

Create a new .claude/skills/{folder-name}/ skill scaffold that follows the multi-YAML pattern. This skill produces the canonical file set and wires the Stop hook to task claude:validate-skill.

Quick Reference

  • •Creates: SKILL.md, skill.yaml, collaboration.yaml (+ validations.yaml, sharp-edges.yaml for non-helpers)
  • •Requires: folder name, kind, description
  • •Stop hook: task claude:validate-skill -- --skill create-skill

Post-Creation Verification

The Stop hook runs three checks to ensure every created skill is valid:

  1. •Structural: task claude:validate-skill-yaml - YAML parses, required files exist
  2. •Semantic: task claude:audit-skills-strict - Multi-YAML pattern compliance
  3. •Documentation: task claude:audit-skills - Verifies skill is documented in CLAUDE.md

IMPORTANT: After creating skill files, you MUST add the skill to CLAUDE.md under "### Skill kinds". The audit will fail if the skill is not documented.

Automation

See skill.yaml for the full procedure and patterns. See sharp-edges.yaml for common failure modes.

PostToolUse Hook (Automatic)

This skill includes a PostToolUse hook that runs automatically after every Edit or Write operation on skill files (.claude/skills/**). It catches broken skills immediately.

Behavior:

  • •Triggers on skill definition files: skill.yaml, SKILL.md, validations.yaml, collaboration.yaml, sharp-edges.yaml
  • •Runs task claude:validate-skill-yaml (structural check)
  • •Runs task claude:audit-skills in warn mode (semantic check, non-blocking)
  • •Exit 2 only if YAML is invalid or required files are missing

Hook script: .claude/hooks/check-skill-structure.sh