Creating skills

my-skill/
├── SKILL.md          # Required — what the AI reads
├── scripts/          # Optional — runnable helpers
│   └── process.py
└── references/       # Optional — longer-form docs
    └── guide.md

---
name: my-skill
description: Brief one-line description — this is what the AI sees in <available_skills>
---

# My Skill

## When to use
Describe the task signal that should make the AI reach for this skill.

## Workflow
1. ...
2. ...

## Scripts
- `scripts/process.py` — what it does, how to call it.

## Output format
Be explicit about where files should land and what shape the user expects.

# scripts/process.py
import argparse, sys, json

def main():
    ap = argparse.ArgumentParser()
    ap.add_argument("--input", required=True)
    ap.add_argument("--output", required=True)
    args = ap.parse_args()
    # ...
    print(json.dumps({"ok": True, "path": args.output}))

if __name__ == "__main__":
    main()