skillregistry (trusted)

This repository is a trusted internal registry of agent skills.

Design notes and history are tracked in beads; this repo stays “runtime-minimal”.

Docs

• docs/PRD.md for the canonical spec
• docs/BOOTSTRAP.md for usage and update policy
• docs/SECURITY.md for supply-chain guardrails
• docs/CONTRIBUTING.md for adding skills and local checks

Structure

• skills/<skill-name>/SKILL.md
• templates/ for generating project overlays
• catalog/skillsets.json for bootstrap selection

Quickstart (project bootstrap)

1. Install project-bootstrap globally:
   • Codex: ~/.codex/skills/project-bootstrap/
   • Claude: ~/.claude/skills/project-bootstrap/ (optional; claude support is TODO)
2. Run bootstrap inside a project repo:

python3 .agent/skillregistry/skills/project-bootstrap/scripts/bootstrap.py init \
  --skillregistry-git <GIT_OR_PATH> \
  --skillregistry-ref <REF>

Bootstrap is safe to re-run: registry skills update, overlays are protected. Overlays are prefixed (<prefix>-project-workflow, <prefix>-api-*) and overwritten only if unchanged since last generation. Use --force-overwrite-overlays to overwrite anyway. Use --install-method local for offline/tests and --project-prefix to override the prefix. Claude targets are currently skipped (recorded in .agent/skills_todo.md).

See docs/BOOTSTRAP.md for the full flow and docs/PRD.md for the canonical spec.