fable-agent/PHASES/phase-10-skill-registry.md

Phase 10: Skill Registry

Purpose: Define, store, version, and retrieve reusable routine templates. TS Module: src/tier2-primitives/routines/skill-registry.ts

What It Does

CRUD for skills with versioning, tagging, and search. Skills are the "routines" of the system — patterns that accumulate and improve.

Skill Structure

id: code-review
name: Code Review
version: 0.1.0
steps:
  - id: step-1
    label: Read the code
    instruction: Thoroughly read and understand the code
    expectedOutcome: Complete understanding
    validationCriteria: []
tags: [code-review, engineering]

Usage

fable-agent skills list
fable-agent skills create "Skill Name" --description "..." --steps "a,b,c"
fable-agent skills inspect <skill-id>
fable-agent skills evolve <skill-id>
fable-agent skills sharpen

Key Rules

• Skills are the executable layer of memory
• Update via TS CLI or directly in SKILLS/*.md files
• Versions bump automatically on evolution
• Max 100 history entries per skill (oldest dropped)