75 lines
1.7 KiB
Markdown
75 lines
1.7 KiB
Markdown
# 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
|
|
npx tsx src/index.ts skills list # List all registered skills
|
|
npx tsx src/index.ts skills inspect <id> # View skill details
|
|
npx tsx src/index.ts skills evolve <id> # Auto-improve skill
|
|
npx tsx src/index.ts skills sharpen # Review all skills
|
|
```
|
|
|
|
To register a new skill from markdown, create the file here and run:
|
|
```bash
|
|
npx tsx src/index.ts skills create "<name>" --description "<desc>" --steps "<step1>,<step2>"
|
|
```
|
|
|
|
## Current Skills
|
|
|
|
| Skill | Version | Executions | Status |
|
|
|-------|---------|------------|--------|
|
|
|
|
*(Run `npx tsx src/index.ts skills list` to populate)*
|