skill-tree

skill-tree

Operate and repair the agent skills you already have installed — across Claude Code, Codex CLI, and Gemini CLI.

Skills accumulate, and across multiple installers they break in ways no single tool surfaces: stale plugin-cache versions, symlink rot, parallel registries with version skew, lock-file drift. skill-tree audits every skill registry on your machine, diagnoses why a given skill won't load, and documents how the skill system actually works on each platform — every load-path and frontmatter claim cited to that platform's official docs. That cross-installer operations layer is the core of the tool, and nothing native or otherwise covers it today.

It also includes a provisioner that narrows a project to a small, committable skill set — but be honest about when you need it. Recent Claude Code handles the basic case natively: the skill prelude is auto-capped (~1% of context, least-invoked descriptions dropped first), and skillOverrides / paths hide or scope individual skills with no copy, manifest, or sync. The provisioner earns its keep where that doesn't reach: large catalogs across multiple installers (native per-skill toggles don't affect plugin skills), and team/CI/multi-machine setups that want a reproducible, hash-pinned skill set committed to the repo. For a single-installer setup under the prelude budget, the native settings are simpler — reach for the provisioner at scale.

This is about progressive disclosure and management — not skill discovery. For discovery, see Anthropic's claude-code-setup or ComposioHQ/awesome-claude-skills.

Early. Mostly used by me. Tested on macOS, not Linux. Issues and PRs welcome.

Commands

Operate & repair — the core, and the part with no native substitute:

Command	What it does
/skill-tree:audit	Walk every skill registry on this machine. Report what's broken and the fix command per installer.
/skill-tree:diagnose <symptom>	"My new skill isn't appearing." "I get 'skill not found' for X." Match the symptom to a known failure-mode signature in docs/ecosystem-map.md and point at the fix.
/skill-tree:check	Health check on the manifest graph.

Provision & sync — useful at scale (large multi-installer catalogs, teams/CI); for a single-installer setup, native skillOverrides/paths are simpler — see the note above:

Command	What it does
/skill-tree:provision	Pick a small set of skills that fit the current project and copy them into <project>/.claude/skills/ as a committable, hash-pinned set.
/skill-tree:sync	Reconcile project skill copies after upstream library changes.
/skill-tree:fetch <url>	Download a skill from GitHub with security checks. New skills are sandboxed (disable-model-invocation: true) until you enable them.

Install

Requires Python 3.11+ and uv.

Claude Code

claude plugin marketplace add danielbrodie/skill-tree
claude plugin install skill-tree@skill-tree

Gemini CLI

gemini extensions install https://github.com/danielbrodie/skill-tree

Codex CLI

# Clone somewhere stable, then register the repo root as a local marketplace
git clone https://github.com/danielbrodie/skill-tree ~/.codex/marketplaces/skill-tree
codex plugin marketplace add ~/.codex/marketplaces/skill-tree
# Enable the plugin in ~/.codex/config.toml
echo '[plugins."skill-tree@danielbrodie"]' >> ~/.codex/config.toml

Verified against codex-cli 0.130.0. Codex doesn't have a plugin install subcommand — registering the marketplace plus the [plugins."..."] block in config.toml is the activation. See docs/codex.md for caveats (no SessionStart hook surface, ${CLAUDE_PLUGIN_ROOT} is Claude-specific).

OpenClaw

openclaw plugins install ./openclaw

Per-project manifest

<project>/.claude/.skilltree.json records which skills got copied in and why:

{
  "version": "1.0",
  "sourceLibrary": "~/.claude/skills",
  "syncedAt": "...",
  "skills": {
    "tdd": {
      "source": "~/.claude/skills/tdd",
      "reason": "Python+pytest repo",
      "syncedAt": "...",
      "sourceHash": "..."
    }
  },
  "auditLog": [...]
}

Skills are copied, not symlinked, so your project edits won't fight upstream library changes. /skill-tree:sync reconciles drift when you want it.