fable-agent/SKILLS/README.md

1.7 KiB

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

# 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:

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:

fable-agent skills create "<name>" --description "<desc>" --steps "<step1>,<step2>"

Current Skills

Skill Version Executions Status

(Run fable-agent skills list to populate)