# Skills

> Procedural memory — lessons that compound across sessions.
> Every file here sharpens every run. Failure modes get added.
> Anti-patterns get documented. Versions get bumped.

## Structure

Each skill lives in its own directory with a `SKILL.md` file:

```
SKILLS/<skill-name>/
├── SKILL.md       # The skill definition (required)
├── scripts/       # Helper scripts (optional)
├── references/    # Reference materials (optional)
└── assets/        # Images, examples (optional)
```

## Skill Template

```markdown
# Skill: <name>

> <one-line description>

---

## Interface
- Input contract
- Output contract
- API endpoints (if applicable)

## Steps
1. Step description with instructions
2. Expected outcome for each step

## Known Failure Modes (accumulated)
- Failure 1: symptom, root cause, fix
- Failure 2: symptom, root cause, fix

## Rules Discovered
- Rule 1
- Rule 2

## Anti-patterns Observed
- Anti-pattern 1
- Anti-pattern 2

## Version History
- v1 — initial (date): description
- v1.1 — (date): changes
```

## Skill Sync

Skills defined here in markdown are synced to the TS skill registry:
```bash
fable-agent skills list          # List all registered skills
fable-agent skills inspect <id>  # View skill details
fable-agent skills evolve <id>   # Auto-improve skill
fable-agent skills sharpen       # Review all skills
```

To register a new skill from markdown, create the file here and run:
```bash
fable-agent skills create "<name>" --description "<desc>" --steps "<step1>,<step2>"
```

## Current Skills

| Skill | Version | Executions | Status |
|-------|---------|------------|--------|

*(Run `fable-agent skills list` to populate)*