Skills

Composable agent skills for working on codebases: setting up GitHub repositories, taking pull requests to ready, reading GitHub evidence, and inspecting the files it contains.

How skills compose

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

Skill catalog

Start with a composite for an end-to-end outcome, or choose a focused skill for one capability.

Codebase

Every setup skill has a check-only mode that reports each area as ready, gap, not-applicable, or unverified with evidence, without changing anything.

Skill	Type	Purpose
config-gh-repo	Focused	Check or change GitHub merge settings
create-gh-repo	Focused	Check, create, or connect a GitHub repository
protect-gh-repo	Focused	Protect merges with checks already seen
setup-cubic	Focused	Check or configure Cubic review
setup-gh-checks	Focused	Run local checks in GitHub Actions
setup-gh-repo	Composite	Set up merge settings, CI, review, and protection

Development

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

Files

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

Install

Requires Bun.

git clone https://github.com/caiopizzol/skills.git
cd skills
bun install --production
bun run install:skills -- ~/.agents/skills read-video

Use ~/.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.

Tooling

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.

Development

bun install
bun run check

This 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.

Licensing

Licensed under the MIT License.