Skip to content

Repository files navigation

Skills

Composable agent skills for gathering context, inspecting local files, monitoring pull requests, and working with YouTube videos.

Release Checks License

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.

summarize-youtube
├── download-youtube-video
└── 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.

Context

Skill Type Purpose
read-discord-conversation Focused Read one exact Discord message, thread, or forum post
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
read-linear-issue Focused Read one exact Linear issue and its relationships
read-slack-thread Focused Read one Slack thread and selected supported files

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

Media

Skill Type Purpose
download-youtube-video Focused Download one accessible video as an exact local file
summarize-youtube Composite Summarize spoken and visual evidence from YouTube

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 comes from the agent runtime and may use a hosted service.

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.

About

Agent skills and deterministic tools for file inspection and developer experience

Resources

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages