███████ ██████  ██    ██ ██████        ███████ ██   ██ ██ ██      ██      ███████ 
██      ██   ██ ██    ██ ██   ██       ██      ██  ██  ██ ██      ██      ██      
███████ ██████  ██    ██ ██████  █████ ███████ █████   ██ ██      ██      ███████ 
     ██ ██      ██    ██ ██   ██            ██ ██  ██  ██ ██      ██           ██ 
███████ ██       ██████  ██   ██       ███████ ██   ██ ██ ███████ ███████ ███████ 
                                                                                  

SPUR-Skills

This repo contains

1. installable skills for the spur-family of packages.
2. A uv tool for installing, updating, and uninstalling the skills.

Quick start

To get started, just point your agent at the install section:

codex --dangerously-bypass-approvals-and-sandbox "Install spur-skills by following https://github.com/spatial-spur/spur-skills#install"

claude --dangerously-skip-permissions "Install spur-skills by following https://github.com/spatial-spur/spur-skills#install"

Install

If you haven't already, 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

Update tool and skills:

spur-skills update

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    │
╰─────────────────────────────────────╯

Supported Agents

• codex
• claude
• hermes
• opencode
• other agents reading from agents