# Create Skill

> Scaffold a new skill directory using the multi-YAML pattern. Use when user says /create-skill.

- Skill: `majiayu000/create-skill-31` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/create-skill-31`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/create-skill-31/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/create-skill-31

---


# 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 for a new skill in the ci-core-e2e-runner project.

## Quick Reference
- Creates: SKILL.md, skill.yaml, collaboration.yaml, sharp-edges.yaml
- Requires: folder name, kind, description
- No task runner or hooks -- this is a shell/YAML project

## Procedure

1. **Gather inputs** from the user:
   - `folder_name` -- directory name under `.claude/skills/`
   - `title` -- human title for H1 header in SKILL.md
   - `description` -- one-line description for trigger matching (frontmatter)
   - `purpose` -- 2-3 sentences for the SKILL.md purpose section
   - `kind` -- one of: action, workflow, gate, helper, meta
   - `user_invocable` -- true or false
   - `allowed_tools` -- list of tools the skill needs

2. **Create folder**: `mkdir -p .claude/skills/{folder-name}/`

3. **Write SKILL.md** (thin wrapper):
   - Frontmatter: name, description, user-invocable, allowed-tools
   - Purpose section (2-3 sentences)
   - Quick Reference (creates/requires pointers)
   - Automation section pointing to skill.yaml / sharp-edges.yaml / collaboration.yaml

4. **Write skill.yaml**:
   - Canonical patterns, anti-patterns, ownership, procedure
   - All rule details live here, not in SKILL.md

5. **Write collaboration.yaml**:
   - Dependencies, composition sequences, triggers

6. **Write sharp-edges.yaml**:
   - Common gotchas with detection hints, impact, and fixes

7. **Document in CLAUDE.md**:
   - Add the skill to the skills table in CLAUDE.md
   - Format: appropriate section with skill name and description

## File Layout

```
.claude/skills/{folder-name}/
  SKILL.md              # Thin wrapper with frontmatter + pointers
  skill.yaml            # Canonical patterns, procedure, ownership
  collaboration.yaml    # Dependencies, triggers, composition
  sharp-edges.yaml      # Common failure modes and fixes
```

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