firstbitelabsllc/skillbox

<img src="docs/cover.png" width="1280" alt="Skillbox — One skill folder. Every tool."

Skillbox

One skill folder. Every tool.

Link your skills into Claude Code, Codex, and Cursor. Edit the source once. Each tool reads the same files.

Watch the Claude Code demo · Command reference · MIT license

See it with your coding agent

Clone Skillbox into a disposable workspace, open that workspace in Claude Code or Codex, and give it this prompt:

Show me how Skillbox shares one skill with Claude Code and Codex. Use isolated example folders, edit the source, and prove both tools see the change.

The useful proof is concrete: one source SKILL.md, links in temporary Claude Code and Codex skill folders, then one source edit visible through both links. Keep the manifest and state directory inside the example folder via SKILLBOXMANIFEST and SKILLBOXSTATEDIR; this leaves your installed skills and configuration untouched. Skillbox creates the links—it does not start or configure either coding agent.

Preview the linking behavior

Python 3.11 or later, on macOS or Linux.

git clone https://github.com/firstbitelabsllc/skillbox.git
cd skillbox
python3 examples/demo.py

This local preview creates one skill and links it into two temporary folders. It checks that both links read the same file, edits that file, and checks that both see the new instruction. The temporary folders are removed when it finishes. SOURCE-NOT-GIT is expected because its temporary source is a plain folder; use a Git clone for skills you want to version and share.

For the full command reference, read docs/reference.md.

Use your own skills

Add the command to your PATH. Installation links to this clone, so keep it in place.

mkdir -p ~/.local/bin ~/.skillbox
ln -s "$PWD/bin/skillbox.py" ~/.local/bin/skillbox
export PATH="$HOME/.local/bin:$PATH"

Create or edit ~/.skillbox/skills.toml with the folders you use: