macOS desktop app · open source · local-first

SkillBox

Local skill manager for AI agents.

Keep Codex-style, Claude, and project-local skills organized from one local store. Review GitHub-backed imports and updates before they touch your runtime folders.

Download for macOS View on GitHub Watch demo

~/.skillbox source of truth

Review first imports and remote updates

Symlink deploy runtime targets stay replaceable

30-second overview

See the workflow before installing.

The demo shows scattered skills becoming one managed library, then walks through review, update, usage history, and the GitHub release flow.

SkillBox keeps local skills manageable without turning runtime folders into the only copy.

Library

One library for local and remote skills

User skills and GitHub-backed remote skills live under a managed store, so agent folders are deployment targets instead of hidden state.

SkillBox dashboard with local and remote skill cards

Review

Review before import. Preview before update.

Scan candidates are classified before copying. Remote updates are inspected as diffs, then applied or left alone.

SkillBox import review dialog with selected skill candidates

Deploy

Deploy to agent runtimes without losing your source of truth

SkillBox deploys managed SKILL.md skills into Codex-style, Claude, and project-local runtime folders through explicit workspace targets.

~/.skillbox

~/.codex/skills

~/.agents/skills

~/.claude/skills

project/.codex/skills

Trust boundaries

Built for local-first skill management.

Runtime folders, GitHub URLs, downloaded archives, and existing skills are treated as untrusted input.

Local source of truth `~/.skillbox` holds managed copies, versions, metadata, and backups.

Signed macOS releases GitHub Releases publish signed and notarized DMGs with updater artifacts.

Version history GitHub sources stay linked to immutable skill versions for preview and rollback.

No silent overwrite Existing runtime content is reviewed instead of being replaced behind your back.

FAQ

Questions people search before installing.

Short answers for developers evaluating SkillBox as their local-first skill manager.

What is SkillBox?

SkillBox is a local-first macOS app and CLI for organizing AI agent skills from one managed library. It focuses on Codex skills, Claude skills, and other SKILL.md-based workflows that need safer import, update, and deployment controls.

Where does SkillBox store skills?

SkillBox stores managed user skills and GitHub-backed remote skills under ~/.skillbox. Runtime folders are treated as deployment targets instead of the only source of truth.

Which agent runtimes does SkillBox target?

SkillBox targets local SKILL.md runtime folders such as .codex/skills, .agents/skills, .claude/skills, and project-local skill roots. The product is built around explicit workspace targets so a single skill library can deploy to the runtimes you use.

How are GitHub-backed skill updates reviewed?

GitHub-backed remote skills stay linked to their source and version history. SkillBox previews remote diffs before applying changes, so imports and updates can be reviewed before they touch runtime folders.

Is SkillBox available beyond macOS?

macOS is the current release target. SkillBox is open source, but the packaged desktop app and signed releases are currently focused on macOS.

Install

Get the current macOS release.

SkillBox currently targets macOS. Download the latest signed DMG or install the cask from the project tap.

GitHub Releases Download for macOS Latest signed and notarized DMG

brew tap santosli/tap
brew install --cask skillbox