Skip to content

spur-skills

spur-skills is a uv tool managing the installation and updating of our agent-skills.

Quick start

spur-skills is distributed as a uv tool.

To get started, just point your favorite agent at the install section, e.g.

with Codex:

codex --dangerously-bypass-approvals-and-sandbox "Install spur-skills by following https://github.com/spatial-spur/spur-skills#install, then inspect the spatial-analysis skill and provide the user with a very short two-section overview: 1) how to apply the spur procedure using the spur() Python wrapper as minimal example, 2) an itemized list of what the applied tests actually do. focus on clarity and brevity"

with Claude Code:

claude --dangerously-skip-permissions "Install spur-skills by following https://github.com/spatial-spur/spur-skills#install, then inspect the spatial-analysis skill and provide the user with a very short two-section overview: 1) how to apply the spur procedure using the spur() Python wrapper as minimal example, 2) an itemized list of what the applied tests actually do. focus on clarity and brevity"

After installation, ask your agent anything about the ecosystem and it should know where to find the answer.

Install

Of course, you can also install the tool yourself in a few steps:

If you haven't already, first install uv with:

# macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

If you run into issues setting up uv, you may want to check the uv installation instructions.

Then, install spur-skills from PyPI with:

uv tool install spur-skills
spur-skills install

After install, you will see a short summary like this:

╭─────── spur-skills installed ───────╮
│ Installed skills: spatial-analysis  │
│ In harnesses: claude, codex, hermes │
│ Reference: ~/.spur-skills/skills    │
╰─────────────────────────────────────╯

The listed harnesses are only an example. The actual summary depends on which supported agent homes already exist locally.

Shipped Skills

spur-skills currently packages two skills:

  • spatial-analysis: core reference for the agent to know its way around the packages' functions
  • spur-skills: reference for the agent to know how to use the spur-skills tool itself
  • spur-issues: reference for the agent to help create issues and PRs across the spur repositories

Useful commands

One of the skills spur-skills installs tells the agent all about interacting with the tool so you don't have to. Should you want to manually use it anyway, here are the core commands:

Install skills into all supported agent folders that already exist:

spur-skills install

Install and auto-accept overwrites:

spur-skills install --yes

To fetch the latest version of the skill and tool:

spur-skills update

Update and auto-accept overwrites:

spur-skills update --yes

Remove installed skill entries from all supported agent folders and remove the shared skill folder:

spur-skills uninstall

Remove installed skill entries only from selected agents:

spur-skills uninstall codex claude

Then uninstall the tool with:

uv tool uninstall spur-skills

Supported agents

  • codex
  • claude
  • hermes
  • agents
  • opencode

Next steps: