Installation

Last updatedView as Markdown

The installer is a zero-dependency Node script published as @linchpinagency/skills. It requires Node 18 or newer and needs no global install of its own.

Install into a project

Run it from the repository you want the skills available in.

Install into the current project bash
npx @linchpinagency/skills

By default this targets Claude Code and writes to .claude/skills in the current directory, alongside the vendored base layer.

Install globally

Install for every project on this machine bash
npx @linchpinagency/skills --global

Global is the usual choice, and the only one that works in tools like Conductor that give each workspace its own checkout.

Check what you have

npx @linchpinagency/skills --list
List what is available, install a single skill, or skip the base layer.

Then start a new session and ask "what kind of project is this?". It should load project-context.

Choose an agent

--agent selects which directories the installer writes to. Pass all to install for every supported agent at once.

Agent--agentProject scopeGlobal scope
Claude Codeclaude-code (default).claude/skills.claude/skills
GitHub Copilotgithub-copilot.agents/skills, .github/skills.copilot/skills
Codexcodex.codex/skills.codex/skills
Cursorcursor.cursor/skills.cursor/skills
npx @linchpinagency/skills
The same library, written to whichever directories that agent reads.

Project and global scope collide

An agent reads both scopes. A skill installed in both is listed twice in every session, and its description is paid for twice in the agent's context.

Audit every scope this agent reads bash
npx @linchpinagency/skills --check

Update safely

Re-running the installer plans an update: it compares installed versions against the package and shows what would change. Nothing to change exits early.

  1. Preview

    Run with --dry-run to see the diff and write nothing.

  2. Apply

    Re-run without the flag and confirm at the prompt, or pass --yes to skip it.

  3. Verify

    Run --list to confirm the installed set and versions.

The confirmation prompt is implied when the process is not attached to a terminal, so CI does not hang.

Offline and air-gapped installs

The base layer is fetched from GitHub at install time. If that fetch fails, the Linchpin skills still install and the installer warns. Re-run when online, or pass --skip-upstream to silence it and install the Linchpin layer only.

Have a question about this page?

Linchpin assistant

Was this helpful?