remigius42/skill-graft

Copyright 2026 Andreas Remigius Schmidt
Graft agent skills from other people's repositories onto your own setup.
You name the skills you want. skill-graft follows their references to other skills and files, vendors the
whole graph, applies your renames and patches, and hands the result to APM
to deploy into Claude Code, opencode, and the other harnesses APM supports.
Skills call each other (/grilling, "call the Skill tool with domain-modeling"), so taking one skill means
taking every skill it reaches. Installing a whole collection is fine for a large model, but on a smaller one the
full skill set crowds the context, and taking only a subset by hand means tracing those calls yourself, skill by
skill. skill-graft computes that hull, the skills you ask for plus every skill they call, and deploys only those
skills. Renames come with it: a skill named like a harness built-in (code-review) shadows it or is shadowed by it,
and renaming one skill by hand misses the other skills that call it by name.
Status: beta.
## Installation
skill-graft needs Python 3.11 or later. It is not on PyPI; install it from the repository with any of:
sh
uv tool install git+https://github.com/remigius42/skill-graft
pipx install --python python3.11 git+https://github.com/remigius42/skill-graft
pip install git+https://github.com/remigius42/skill-graft # into the active environment
pipenv install "skill-graft @ git+https://github.com/remigius42/skill-graft"
uv picks a suitable Python itself; pipx and pip use theirs, so point them at 3.11 or later. pipenv installs into
that project's environment: run it as pipenv run skill-graft.
These install the latest main. To install a release instead, append its tag to the URL,
git+https://github.com/remigius42/skill-graft@v ; the tags are listed under
releases. skill-graft --version names what is installed:
the version, and for these installs the commit, skill-graft 0.2.0 (e294a0e), with the tag or branch if you named
one.
skill-graft runs APM as a command, so apm must be on PATH as well, in version 0.33.0: the folders APM deploys
to were measured on it, and another version may deploy elsewhere. Install it the same way, e.g.
uv tool install apm-cli==0.33.0, pipx install apm-cli==0.33.0 or pip install apm-cli==0.33.0.
## Usage
Besides skill-graft and APM, you need a harness folder for APM to deploy into, such as ~/.claude/ for Claude Code.
To deploy the tdd skill of mattpocock/skills, and every skill it calls,
create your package:
sh
skill-graft init
init writes the package's config, ~/.apm/skill-graft/skill-graft.toml, all commented out. Add the repository
to it as a source, a new table after the comments (the commented [sources.mp] there is only an example):
toml
[sources.mp]
git = "https://github.com/mattpocock/skills.git"
Then:
sh
skill-graft update mp # set the source's ref to its branch tip
skill-graft add mp/tdd # ask for the skill
skill-graft tree # see the hull: mp/tdd and every skill it calls
skill-graft build # vendor the hull and deploy it through APM
tdd and the skills it calls are now in ~/.claude/skills/. To share skills through a project instead, see
A package for one project; to deploy them under other names, [rename] and prefix