Composable agent skills for working on codebases: verifying public surfaces, enforcing codebase rules, taking pull requests to ready, reading GitHub evidence, and inspecting the files it contains.
A skill is one callable capability. It can invoke another skill with a $name reference, and that
child can invoke children of its own. Composite skills coordinate several capabilities; focused skills
do one job.
This is closer to functions calling functions than a fixed level hierarchy. Categories organize the source tree only. Installing a composite resolves its full dependency graph automatically.
monitor-pr
├── push-pr-stack
├── resolve-pr-thread
└── read-github-pr
├── read-github-issue
├── read-github-resource
├── read-image
├── read-text-file
├── transcribe-audio
└── read-video
├── read-image
└── transcribe-audio
Start with a composite for an end-to-end outcome, or choose a focused skill for one capability.
Every skill here has a check-only mode that reports each area's status with evidence, without changing anything.
| Skill | Type | Purpose |
|---|---|---|
audit-agent-guardrails |
Composite | Find which written rules no check enforces |
enforce-codebase-constraint |
Focused | Make one known bad pattern fail automatically |
protect-gh-repo |
Focused | Protect merges with checks already seen |
setup-gh-checks |
Focused | Run local checks in GitHub Actions |
verify-surfaces |
Focused | Pin every public surface to its exact behavior |
| Skill | Type | Purpose |
|---|---|---|
monitor-pr |
Composite | Take a PR or Stack through checks and review |
push-pr-stack |
Focused | Push rewritten pull request Stack branches safely |
read-github-issue |
Focused | Read one exact GitHub issue conversation |
read-github-pr |
Focused | Read one exact pull request, reviews, changed files |
read-github-resource |
Focused | Retrieve complete GitHub evidence through gh |
resolve-pr-thread |
Focused | Close one validated PR review conversation |
read-image does not teach the model to see. It makes that ability dependable for composition by
verifying the source, routing formats safely, covering animations, and reporting gaps.
| Skill | Type | Purpose |
|---|---|---|
read-image |
Focused | Inspect raster images, animations, and safe SVGs |
read-text-file |
Focused | Read bounded text and structured-data files |
read-video |
Composite | Inspect a video's visual and audio lanes |
transcribe-audio |
Focused | Transcribe audio with explicit temporal coverage |
Requires Bun.
git clone https://github.com/caiopizzol/skills.git
cd skills
bun install --production
bun run install:skills -- ~/.agents/skills read-videoUse ~/.agents/skills for Codex or ~/.claude/skills for Claude Code. The installer adds required
child skills automatically, so installing read-video also installs read-image and
transcribe-audio. Omit the skill name to install the full catalog.
Installation uses symlinks and is supported on macOS and Linux. Existing destinations are never overwritten.
Image and video inspection use ImageMagick and FFmpeg when available. Missing tools are reported, not installed or downloaded. Audio transcription uses local Whisper and sends nothing outside the runtime.
bun install
bun run checkThis validates the skill catalog, typechecks the workspace, and runs fixture-only tests without network access.
Committed fixtures use generated shapes, text tokens, and audio rather than customer or user data. They are covered by this repository's MIT license.
Licensed under the MIT License.