agent-skills

This repository is a shared collection of workflow files, called skills, that coding agents can install and reuse across many projects. Instead of copying the same instructions into every separate codebase, you write them once here and point any project at this central source. The result is that all your agents stay consistent without anyone needing to keep multiple copies in sync.

Two skills ship in the repo right now. The first is called autoreview, which provides a structured workflow for closing out code reviews. The second is called crabbox, which handles remote validation, meaning it runs checks that confirm your code behaves correctly in a broader environment or matches what a continuous integration system would see.

Installing the skills is a short command-line process. You clone the repo, then run the included install script, optionally naming only the skills you want. The script creates symbolic links by default so that any update you pull into this checkout is automatically visible to your agents. If you need a portable or locked-down setup, you can tell the script to copy files instead of linking them. The README covers specific instructions for two popular agents: Codex and Claude Code.

For projects where contributors might not want to install anything extra, the README describes a vendoring approach. A project can store a generated snapshot of a skill inside its own directory. That snapshot is treated as a read-only distribution artifact, not an editable source, and the README is clear that edits should happen here first and then be synchronized downstream.

The repository structure is straightforward: a top-level skills folder holds one subfolder per skill, each containing a required SKILL.md file and any helper scripts. A validate-skills script checks that every skill has proper metadata. The project is released under the MIT license.