The agent skill
Add the Shed agent skill.
Optional. It teaches your coding agent to write a SHED file and run the CLI.
What the skill does
An agent that has never seen Shed will guess: SHED file keys that do not exist, CLI flags that were never added. The skill is what it reads before it acts.
It is plain files on disk following the Agent Skills specification. No service, no API key. Claude Code, Cursor, and Codex read the same copy.
It does not install the CLI. The skill teaches an agent to drive shed; the binary still has to be there. Everything works without the skill, your agent just needs more hand-holding.
Choose a scope
One installer, two places it can put the skill. Unlike curl and npm, this choice changes the result.
- This machineOne clone in
~/.shed/skills, symlinked into every agent in your home directory. Every project you touch on this laptop sees it, and one command updates all of them. It does not travel to anyone else. - This projectA copy inside the repo, at
.claude/skills/shed. It is committed, so teammates and CI agents get it by cloning. It only applies to that one project, and updating it is a per-repo job.
Running both is fine and common. When an agent works inside a repo that carries its own copy, that copy is the one it reads.
This machine
The default, so there is no flag to pass. git is the only requirement.
curl -fsSL https://raw.githubusercontent.com/shed-sh/cli/main/install-skills.sh | sh- It clones once, then linksThe skill is cloned into
~/.shed/skillsand symlinked into~/.claude/skills/shed, plus~/.cursorand~/.codexwhen those directories already exist. An agent you install next month will not be linked until you run the script again. - Check it worked
ls ~/.claude/skills/shedshould list the skill files. Your agent picks it up on its next session, not the current one. - Rerun it to updateEvery agent points at the same clone, so a single
git pullupdates all of them at once. Rerunning the installer does that pull for you.
This project
Same installer, run from the project root with --local.
curl -fsSL https://raw.githubusercontent.com/shed-sh/cli/main/install-skills.sh | sh -s -- --local- Run it from the project root
--localgoes aftersh -s --, which is how the pipe passes an argument through to the script. To target a directory other than the current one, add--dir <path>. - Check what it wroteA copy at
.claude/skills/shed, and at.cursor/skills/shedand.codex/skills/shedwhen those directories already exist. A real copy rather than a symlink, which is what lets it survive a clone. - Commit itCommit
.claude/skills/shedso teammates get the skill when they clone. Rerun the installer to pull in a newer version, and commit that too.