Agent Skills

Personal skills and workflows for Codex and other Agent Skills-compatible tools.

Skills

• minimize-pr-diff - Minimize pull request diffs and GitHub review views.

Install

Install a skill by passing its GitHub directory URL to $skill-installer:

$skill-installer install https://github.com/swkeever/skills/tree/main/skills/minimize-pr-diff

Restart Codex after installing a new skill.

Layout

Each skill lives under skills/<skill-name>/ and follows the Agent Skills format:

• SKILL.md - required instructions and metadata
• agents/openai.yaml - optional Codex UI metadata
• scripts/ - optional non-interactive helper scripts
• references/ - optional reference material loaded on demand
• assets/ - optional templates and static resources

Validate

Validate an individual skill:

npx -y skills-ref validate skills/minimize-pr-diff

Check bundled shell scripts:

find skills -path '*/scripts/*.sh' -print -exec bash -n {} \;

Pull requests run the same checks in GitHub Actions.

Contributing

See CONTRIBUTING.md for contribution guidance and SECURITY.md for vulnerability reporting.

License

Released under the MIT License.