Codex skills

Personal Codex skills used from ~/.codex/skills. Skill sources live under src/.

_{A sharpened tool. An open codex. A practiced hand.}

Skills

• change-friendly-architecture: reviews designs for narrow, testable boundaries, explicit dependencies, visible workflows, and low blast radius.
• beads: keeps Beads work claimed, updated with evidence, and closed when complete.
• changelog: keeps unreleased changelog entries accurate and finalizes version sections at release time.
• ci: adds GitHub Actions checks and README badges for code and skills projects.
• coding: surfaces code execution exceptions, keeps code idiomatic, separates mixed-language scripts, and avoids machine-specific paths.
• commit-discipline: prepares small local commits with clear rationale and task hygiene.
• create-skill: creates concise skills with OpenAI metadata, eval scaffolding, and focused validation.
• decompose-skill: splits oversized skills into a small trigger surface plus focused resources.
• devloop: discovers devloop from its built-in guidance and validates workflows with observable evidence.
• documentation-boundary: separates README synopsis work from real documentation updates.
• docs-structure: organises README synopsis content and durable docs into focused files.
• kata: keeps Kata issues searched, assigned, updated with evidence, and closed when verified.
• markdown: edits Markdown with useful Unicode, including box-drawing directory trees.
• release: releases through protected main, PR CI, merged release commits, tags, and release workflows.
• repo-policy: configures GitHub repository policies for protected main, PR merges, CI gates, and artifact releases.
• roborev-kata-workflow: coordinates kata task tracking with non-blocking Roborev review.
• shell-script: requires strict shell mode for shell scripts and automation wrappers.
• skill-project: scaffolds standalone skill-set repositories with shared validation, linking, eval, and agent metadata conventions.
• testing: selects the narrowest deterministic validation for a change's blast radius.
• web-realtime-devloop: enforces a live browser development loop for realtime web work.

Use

Run ./scripts/link_skills.sh to symlink the skills into ~/.codex/skills and the hosted Codex-home instructions into ~/.codex/AGENTS.md.

Validation

Run bash scripts/validate_skills.sh. The wrapper installs skill-validator when needed and uses the verified skilpel release binary at ~/.local/bin/skilpel.

Model-backed evals use scripts/skilpel.yaml, which sets target and judge temperature to 0.

To iterate on one eval case, pass a skill relpath and eval id:

bash scripts/validate_skills.sh --eval-id reject-overfit-domain-type change-friendly-architecture

For local model-backed evals, put OPENAI_API_KEY in .env. The committed .envrc loads .env into the shell with direnv; .env is ignored by Git.

Versioning

The current version is recorded in VERSION.

See CHANGELOG.md for release history. Version tags use vMAJOR.MINOR.PATCH.

License

This project is licensed under GPL-3.0-or-later. See LICENSE.