> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getspine.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Install a Claude Code skill that delegates research and deliverable generation to Spine.

Drop a single skill file into Claude Code and it learns when and how to call the Spine API — no prompt engineering on your part.

## Install

<Warning>
  Claude Code 2.1+ loads skills from installed plugins. Loose files at
  `~/.claude/skills/*.md` are no longer auto-scanned — you must install the skill
  as a plugin, or inject it into individual sessions with
  `--append-system-prompt-file`.
</Warning>

<Tabs>
  <Tab title="Plugin (recommended)">
    Install the `spine` plugin from the Spine marketplace:

    ```shell theme={"theme":{"light":"github-light","dark":"tokyo-night"}}
    /plugin marketplace add Spine-AI/claude-plugins
    /plugin install spine@spine-marketplace
    ```

    The plugin exposes the skill `spine:research`, which Claude Code
    auto-discovers at session start and invokes on research/deliverable prompts.
  </Tab>

  <Tab title="Per-invocation (fallback)">
    If you can't install plugins (sandbox, policy, etc.), download the skill
    file and inject it into a single session:

    ```bash theme={"theme":{"light":"github-light","dark":"tokyo-night"}}
    curl -o ~/.claude/skills/spine.skill.md \
      https://docs.getspine.ai/static/agent-files/spine.skill.md

    claude -p "Your research task" \
      --append-system-prompt-file ~/.claude/skills/spine.skill.md
    ```
  </Tab>

  <Tab title="Local development">
    Clone the plugin repo and point Claude Code at it directly:

    ```bash theme={"theme":{"light":"github-light","dark":"tokyo-night"}}
    git clone https://github.com/Spine-AI/claude-plugins
    claude --plugin-dir ./claude-plugins/plugins/spine
    ```
  </Tab>
</Tabs>

<Card title="Download skill file" icon="download" href="/static/agent-files/spine.skill.md">
  `spine.skill.md` — used by the per-invocation fallback tab above
</Card>

## Set your API key

```bash theme={"theme":{"light":"github-light","dark":"tokyo-night"}}
export SPINE_API_KEY="sk_spine_..."
```

Create a key at [platform.getspine.ai/keys](https://platform.getspine.ai/keys) if you don't have one.

## What it does

Once installed, Claude Code will automatically delegate to Spine when you ask for tasks like:

* "Produce a competitive analysis of AI coding tools"
* "Create a Q1 sales report from this CSV"
* "Build a slide deck on European market expansion"

Claude calls `POST /v1/run`, polls until complete, and presents the synthesized output plus download links for any generated artifacts.

## Example session

```
You: Produce a competitive analysis of the top 5 AI research APIs

Claude: I'll delegate this to the Spine API using the deep_research template.

[Creates run → polls → completed in 13m 04s]

Here's the analysis:
- final_output: [competitive analysis text...]
- Artifacts:
  - Competitive_Analysis.docx (download: https://...)
  - Market_Data.xlsx (download: https://...)
- Credits consumed: 32
```

## How the skill works

The skill file teaches Claude Code:

1. **When** to use Spine (multi-source research, deliverable generation — not simple lookups)
2. **How** to authenticate (`SPINE_API_KEY` env var)
3. **The two-step pattern** — `POST /v1/run` → poll `GET /v1/run/{run_id}`
4. **How to pick a template** based on the deliverable type
5. **How to present results** — show `final_output` + artifact download links