Spine Research Skill

Spine Research Skill

Delegate heavy research and deliverable generation to the Spine API. Spine is a multi-agent research API (api.getspine.ai) that produces synthesized answers and downloadable artifacts.

When to use this skill

Invoke Spine when the user asks for:

• Multi-source research with citations (competitive landscapes, market analyses, regulatory scans)
• Polished deliverables: reports (.docx), spreadsheets (.xlsx), slide decks (.pptx), web apps (.html), images (.png)
• Any task that would require assembling 10+ manual tool calls (web searches, table construction, citation threading)

Do not use Spine for simple lookups, code edits, or anything you can answer directly.

Authentication

Read the API key from SPINE_API_KEY. If unset, ask the user to set it:

export SPINE_API_KEY="sk_spine_..."

Keys are created at platform.getspine.ai/keys.

Two-step pattern

Step 1 — Create a run

curl -s -X POST https://api.getspine.ai/v1/run \
  -H "X-API-KEY: $SPINE_API_KEY" \
  -F "prompt=<the user's request>" \
  -F "template=<auto|deep_research|report|slides|memo|excel|app|landing_page>"

Pick the template that best fits the deliverable type. Use auto if unsure.

Optionally attach files with -F "files=@path/to/file".

Response shape:

{
  "success": true,
  "data": {
    "run_id": "…",
    "canvas_id": "…",
    "status": "running",
    "poll_url": "/v1/run/…",
    "estimated_duration_ms": 60000
  }
}

Read data.run_id for polling.

Step 2 — Poll until complete

curl -s https://api.getspine.ai/v1/run/<run_id> \
  -H "X-API-KEY: $SPINE_API_KEY"

Poll every 15–30 seconds. Runs average 10–20 minutes and can take up to 2 hours for complex research.

For long runs, prefer webhooks over polling. See Webhooks.

When data.status is completed:

• data.result.final_output — synthesized answer text
• data.result.artifacts[] — downloadable files with download_url, name, type
• data.metadata.credits_consumed — cost

Terminal states also include partial and failed. On failed, inspect data.errors[] for the reason; a common one is Insufficient credits to complete this operation. Please purchase more credits to continue. (reload_not_eligible).

Presenting results

1. Show the user final_output
2. Render each artifact as a clickable download link: [name](download_url)
3. Note credits_consumed

Templates

Template	Output
auto	Agent picks best block types
deep_research	Research memo with citations
report	Report (.docx)
slides	Slide deck (.pptx)
memo	Memo (.docx)
excel	Spreadsheet (.xlsx)
app	Interactive web application (.html)
landing_page	Landing page (.html)

Full API docs

docs.getspine.ai/api-reference/overview