Skills Library

Centralized library of agent skills with origin tracking and upstream sync.

Each skill directory contains:

skills/
├── SKILL.md          # Skill definition (prompt, instructions, workflow)
├── metadata.yaml     # Origin, category, status, sync config
├── templates/        # Reusable templates
├── scripts/          # Helper scripts
├── references/       # API docs, specs, examples
└── assets/           # Diagrams, images, configs

Every skill MUST have a metadata.yaml with:

name: skill-name
origin: https://github.com/original/repo
origin_path: path/to/skill
category: devops|github|software-development|mlops|...
status: active|deprecated|experimental
sync:
  enabled: true
  interval: weekly
  strategy: git-submodule|download|manual

1. Create directory: skills/<name>/
2. Add SKILL.md with the skill definition
3. Add metadata.yaml with origin info
4. Add any supporting files
5. Submit PR

When sync.enabled: true, the skill should be kept in sync with its origin:

# Pull latest from origin
./scripts/sync <skill-name>

# Check for updates
./scripts/check-updates

See CONTRIBUTING.md for guidelines.