Installing skills

Skills install through the shipmoor CLI: no separate download, no manual file editing. One command writes the whole bundle into your agent’s instruction file as a single managed block, and one command removes it cleanly.

The command surface

shipmoor skills list                 # the catalog + your entitlement state
shipmoor skills install claude       # write the managed block into CLAUDE.md
shipmoor skills install all          # every supported agent
shipmoor skills status               # what's installed where
shipmoor skills uninstall claude     # remove only the managed block
shipmoor skills install claude --json

Supported agents: claude, codex, cursor, aider.

What install writes

A marker-wrapped, idempotent managed block into the agent’s own instruction file, and never anywhere else:

Three guarantees worth knowing before you run it on a repo with existing agent config:

• Idempotent. Re-running install is byte-identical, so it is safe to put in a setup script.
• Content-preserving. Everything outside the managed block, including your own instructions, is untouched.
• Reversible. uninstall removes only the managed block and restores your file.

If the Agent Harness is also installed, the two coexist: each owns its own marker-wrapped block and only ever touches its own.

Verifying an install

--json is the canonical signal (shipmoor.skills.install.v1); script against it rather than grepping the rendered file:

shipmoor skills install claude --json

{
  "schema_version": "shipmoor.skills.install.v1",
  "entitlement_state": "free_active",
  "results": [
    {
      "agent": "claude",
      "action": "installed",
      "target": "CLAUDE.md",
      "skills": [
        { "name": "shipmoor-review", "tier": "free", "enabled": true },
        { "name": "shipmoor-agent-guard", "tier": "free", "enabled": true },
        { "name": "shipmoor-intent-contract", "tier": "free", "enabled": true },
        { "name": "shipmoor-fix", "tier": "free", "enabled": true },
        { "name": "shipmoor-pr-preflight", "tier": "free", "enabled": true }
      ],
      "warnings": []
    }
  ]
}

Availability and command allowances

Agent Skills is unlimited on Free and Pro. The installation must be authorized to an account.

• The full skill bundle installs without consuming an allowance.
• A Skill that invokes a metered top-level command consumes the corresponding Free command allowance.

Pro-only standalone repair capabilities remain entitlement-controlled. Repair guidance included inside an admitted Free Claim Check remains available as part of that invocation. See Capabilities, entitlements & allowances.

Next

• The five skills: what each behavior actually does.
• Using skills with your agent: per-agent specifics and a worked loop.
• Agent Harness: the runtime that complements these behaviors.