skilltree

A skill manager for AI coding agents — organize, tag, and link skills across projects.

Install, manage, and link reusable skills for Claude Code and Codex — from GitHub or locally, via CLI or TUI.

Quick Start

BASH

npm i -g @steadymoka/skilltree   # install
skilltree init                    # set up ~/.skilltree/ (migrates from .claude/.codex/.agents)
skilltree add owner/repo          # install a skill from GitHub
skilltree link <tags...>          # link skills to your project
skilltree                         # launch TUI

Build from source

BASH

git clone https://github.com/steadymoka/skilltree.git
cd skilltree
cargo build --release

TUI

Run skilltree with no arguments to launch the interactive terminal UI.

Switch between three screens with 1, 2, and 3. The focused panel is highlighted while the other panel dims automatically.

Screen 1 — Skills, Tags & Projects

Organize your skills with tags and see which projects each skill is linked to. Three panels: skills on the left, tags in the middle, linked projects on the right.

 Skill Tree   12 skills  5 tags           1:Skills  2:Claude  3:Codex
+- Skills --------------------+ +- Tags --------+ +- Projects --------+
| > auth-middleware [api,sec] | |   [x] api     | |   my-api      C·X |
|   db-migrations   [db]     | |   [ ] db       | |   web-app     C   |
|   error-handling  [api]    | |   [ ] frontend | |   Global      C   |
|   graphql-setup            | |   [x] sec      | |                   |
|   react-patterns  [front]  | |   [ ] testing  | |                   |
|   test-helpers    [testing]| |                | |                   |
+-----------------------------+ +----------------+ +-------------------+
 1/2/3:screen  <->:focus  up/dn:select  Space:toggle  a:new tag  d:delete  Esc:quit

The Projects panel shows where the selected skill is linked, with tool indicators: C = Claude, X = Codex. Press Space on a linked project to open an unlink modal where you can choose which tool to unlink.

Screen 2/3 — Claude / Codex Projects

Link skills to projects per agent. Select a project on the left, then toggle skills or entire tag groups on the right.

 Skill Tree   12 skills  5 tags       1:Skills  2:Claude  3:Codex
+- Projects -----------------------+ +- Skills by Tag --------------------+
| > my-api         3 linked        | | v [x] api                    2    |
|   web-app        1 linked        | |     [x] auth-middleware            |
|   mobile-app     0 linked        | |     [x] error-handling             |
|                                  | | > [ ] db                     1    |
|                                  | | v [-] sec                    1    |
|                                  | |     [x] auth-middleware            |
|                                  | | -- no tag --                       |
|                                  | |     [ ] graphql-setup              |
+----------------------------------+ +--------------------------------------+
 1/2/3:screen  <->:focus  up/dn:select  Space:link/unlink  Enter:fold  q:quit

Keybindings

Key	Action
`1` `2` `3`	Switch screen
`Left` `Right`	Switch panel focus
`Up` `Down` `j` `k`	Navigate
`Space`	Toggle tag / link / unlink
`Enter`	Fold/unfold tag group
`a`	Add new tag
`d`	Delete skill
`Esc`	Close modal / Quit

CLI Commands

Skill Management

BASH

skilltree add <owner/repo>            # Install a skill from GitHub
skilltree add <owner/repo> --skill <path>  # Install a specific skill within a repo
skilltree search <query>              # Search for skills on GitHub
skilltree update [skill]              # Update skill(s) to latest
skilltree remove <name>               # Remove an installed skill
skilltree info <name>                 # Show skill details
skilltree tag <skill> <tags...>       # Set tags for a skill

Linking

BASH

skilltree link <tags...>              # Link skills by tags
skilltree link --skill <name>         # Link a single skill
skilltree unlink <name>               # Unlink a skill
skilltree unlink --all                # Unlink all skills

Other

BASH

skilltree init                        # Initialize ~/.skilltree/
skilltree tree                        # Print skill tree (alias: list)
skilltree doctor                      # Check health & detect issues
skilltree doctor --fix                # Auto-fix all detected issues
skilltree serve                       # Open web dashboard

Common Flags

Flag	Description
`--path <dir>`	Target project path (default: cwd)
`--tool claude\|codex`	Target agent (default: `claude`)

How It Works

~/.skilltree/               Central skill repository
├── skills.yaml             Skill → tag mapping
├── .skill-lock.json        Source & version metadata
├── auth-middleware/         Skill directory (local or from GitHub)
│   └── SKILL.md
├── db-migrations/
└── ...

<project>/.claude/skills/   Symlinks (per-project, auto-created)
├── auth-middleware → ~/.skilltree/auth-middleware
└── error-handling → ~/.skilltree/error-handling

Skills live in one place (~/.skilltree/). Projects reference them via symlinks — no duplication, always up to date. Install skills from GitHub with skilltree add, or create your own locally. Tags let you group related skills and link them in bulk.

Doctor

skilltree doctor checks the health of your setup:

Ghost entries — skills.yaml references a skill directory that doesn't exist
Unregistered directories — skill directory exists but isn't in skills.yaml
Lock orphans — .skill-lock.json references a removed skill
Unmanaged skills — real directories or external symlinks in ~/.claude/skills/, ~/.codex/skills/, or ~/.agents/skills/ that aren't managed by skilltree
Broken symlinks — dead symlinks in project skill directories

Run skilltree doctor --fix to auto-fix all detected issues. Unmanaged skills are adopted into ~/.skilltree/ and replaced with symlinks.

Development

BASH

cargo run          # Run CLI
cargo test         # Run tests

cd web && pnpm install && pnpm dev   # Web dashboard

License

MIT