Katherine's Skills

A shared collection of reusable Codex skills. Each skill lives in its own folder so people can browse the full collection or install one skill at a time.

Status

Starter repo prepared for public GitHub publishing. The first included skill is project-docs-bootstrap.

Quick Start

Browse available skills:

ls skills

List available skills:

scripts/install-skills --list

Preview an install without changing files:

scripts/install-skills --dry-run

Install all skills into the default Codex skill directory:

scripts/install-skills

Install only selected skills:

scripts/install-skills project-docs-bootstrap

Install somewhere else:

scripts/install-skills --target ~/.agents/skills project-docs-bootstrap

Use copies instead of symlinks:

scripts/install-skills --mode copy --target ~/.codex/skills project-docs-bootstrap

Replace an existing installed skill:

scripts/install-skills --force project-docs-bootstrap

Main Workflows

• Add a skill as its own folder under skills/<skill-name>/.
• Keep each skill self-contained: SKILL.md, plus any references/, scripts/, agents/, examples/, or templates/ it needs.
• Install one or more skills with scripts/install-skills.

Validate

Run this after edits:

scripts/validate-skills
ruby -c scripts/install-skills
ruby -c scripts/validate-skills

Important Directories

• skills/: reusable skills, one folder per skill.
• scripts/: helper scripts for installing and validating skills.

Project Docs

• Project Outline
• Plan
• Architecture
• Agent Guide
• Decisions
• TODO
• Contributing

License

MIT License. See LICENSE.