@rallycry/conveyor-skills

Shared Claude Code skills for projects managed with Conveyor. Installing this package and linking it once gives every Claude Code session in your repo the Conveyor workflow skills (/conveyor-plan, /conveyor-local-loop, …), and updates arrive through normal dependency bumps — no git submodules, no manual syncing.

Skills

| Skill | Invoke | What it does | | --- | --- | --- | | conveyor-workflows | auto-triggers on Conveyor questions | The guide: connect/repair the MCP, create and classify cards, packs, builds, the two PR paths, review flows, reliability gotchas | | conveyor-plan | /conveyor-plan <idea> | Research an idea into a context-free, immediately-buildable Conveyor card | | conveyor-local-loop | /loop /conveyor-local-loop | Run this machine as a serial local agent: claim Open cards, build to PR, repeat |

Install (once per repo)

bun add -d @rallycry/conveyor-skills     # or: pnpm add -D / npm i -D
bunx conveyor-skills link                # or: pnpm exec / npx conveyor-skills link

Then make it stick:

1. Add the link step to your root package.json prepare script so every install refreshes the links (new skills in a version bump appear automatically; prepare runs at the end of every bun install — nobody ever runs it by hand):

   { "scripts": { "prepare": "conveyor-skills link" } }

   If you already have a prepare script, chain it: "husky && conveyor-skills link".

2. Commit the symlinks it created in .claude/skills/. They point into node_modules, so on a fresh clone they are briefly broken — Claude Code silently ignores broken symlinks — and come alive as soon as the first install finishes. Committing them means CI agents and teammates get the skills with zero extra setup.

How updates flow

Skill content is read live from node_modules, so any dependency bump (bun update @rallycry/conveyor-skills, Renovate/Dependabot, a ^ range refresh) updates the skills with no further action. Re-linking is only needed when a version adds or removes a skill — which the prepare hook already covers.

What link does (and won't do)

conveyor-skills link writes one relative symlink per skill into <repo>/.claude/skills/, pointing at the stable node_modules/@rallycry/conveyor-skills/skills/<name> path. It is idempotent and safe:

• It only ever replaces or prunes symlinks it owns (target contains conveyor-skills/skills/).
• A real directory or a foreign symlink with the same name is left alone with a warning — your local skills always win.
• conveyor-skills link --check verifies the links without changing anything (exit 1 when out of date) — useful in CI.

Versioning

Versions are cut automatically from git tags on the Conveyor repo's main branch (conveyor-skills-v<semver>); every shipped-source change publishes a patch release. Consume with a ^ range and bump like any other dependency.