python scripts/init_skill.py my-skill --path ./my-skill

my-skill/
├── SKILL.md           # Edit this with your skill
├── scripts/           # Add executable code
├── references/        # Add documentation
└── assets/           # Add resources

---
name: my-skill
description: What this skill does and when to use it (3-5 sentences)
license: MIT
---

# My Skill Title

## Purpose
Describe what the skill does in 1-2 paragraphs.

## When to Use
Explain when Claude should activate this skill.

## How to Use

### Step 1: First action
Instructions for step one.

### Step 2: Second action
Instructions for step two.

## Examples
- Example usage 1
- Example usage 2

## Reference Files
- See `references/` for detailed documentation
- Use `scripts/` for executable code

scripts/
├── helper.py          # Reusable code
├── processor.sh       # Shell utilities
└── validator.py       # Input validation

references/
├── api_docs.md        # API specifications
├── schemas.md         # Data schemas
└── best_practices.md  # Guidelines

assets/
├── template.html      # HTML templates
├── icon.png          # Images
└── style.css         # Styles

python scripts/quick_validate.py ./my-skill

python scripts/package_skill.py ./my-skill

/plugin install ./my-skill.zip

Skills:      kebab-case (my-skill)
Scripts:     action_noun.py (rotate_pdf.py)
References:  descriptive.md (api_docs.md)
Files:       kebab-case.extension (config-template.json)

pdf-processor/
├── SKILL.md
│   ---
│   name: pdf-processor
│   description: Process and manipulate PDF files.
│              Use when users need to rotate, merge, or
│              extract data from PDFs.
│   ---
│
│   # PDF Processor
│
│   ## Purpose
│   Advanced PDF manipulation for common tasks.
│
│   ## How to Use
│   1. Prepare input PDF
│   2. Execute relevant script
│   3. Output is saved
│
├── scripts/
│   ├── rotate_pdf.py
│   ├── merge_pdfs.py
│   └── extract_text.py
│
└── references/
    ├── pdf_formats.md
    └── library_guide.md

□ SKILL.md structure
  □ Valid YAML frontmatter
  □ name in kebab-case
  □ description is descriptive

□ File organization
  □ Scripts in scripts/
  □ Docs in references/
  □ Resources in assets/

□ Quality
  □ SKILL.md <5k words
  □ Scripts have docstrings
  □ Clear examples included
  □ All paths relative

□ Ready to distribute
  □ Validated: ✓ All OK!
  □ Packaged: skill-name.zip
  □ Can install: /plugin install