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

# Claude Code skill

> Use the 0xArchive SKILL.md workflow package inside Claude Code when a reusable local skill is the right surface.

Claude Code Skill guidance should be specific to Claude Code setup, not a generic Skill chooser. This page keeps that older search path useful without blurring the rest of the tooling docs.

A Skill is a local `SKILL.md` workflow package. It teaches a compatible host how to choose 0xArchive route families, make bounded HTTP calls, inspect JSON, and preserve request IDs. It is not MCP, not CLI, and not a coding agent. Claude Code is the host.

## Claude Code Fit

Use the 0xArchive Skill in Claude Code when the workflow benefits from reusable instructions and shell-backed request patterns. Use MCP Server instead when Claude Code should call typed MCP tools. Use CLI when a repeatable terminal command is enough. Use OpenAPI and SDKs when Claude is generating application code.

| Need                               | Better surface                        |
| ---------------------------------- | ------------------------------------- |
| Reusable route-selection procedure | Skill                                 |
| Typed tool calls in Claude Code    | [MCP server](/mcp-server)             |
| One-off shell or CI command        | [CLI](/cli)                           |
| Generated app client               | [OpenAPI](/openapi) and [SDKs](/sdks) |
| Concept or citation context        | Markdown docs and `llms.txt`          |

## Setup Checklist

<Steps>
  <Step title="Install or place the Skill package">
    Put the 0xArchive `SKILL.md` package in the Claude Code skill location used by your environment.
  </Step>

  <Step title="Set the API key">
    Keep `OXARCHIVE_API_KEY` in the shell or project environment Claude Code uses.
  </Step>

  <Step title="Start with route selection">
    Ask Claude to name the venue family and route before running a request.
  </Step>

  <Step title="Keep requests bounded">
    Require one symbol, one route, one small window, and `meta.request_id` logging before widening.
  </Step>
</Steps>

## Prompt Shape

<Prompt>
  Use the 0xArchive Skill to check whether Hyperliquid Spot `HYPE-USDC` has fresh trade data, then show one bounded request and the fields I should log.
</Prompt>

<Prompt>
  Use the 0xArchive Skill for HIP-3 `km:US500`. Choose the route family, run a small freshness or trades check, and keep the request ID.
</Prompt>

## Claude Task Checklist

For Claude Code, write the request as a small local task instead of a broad research prompt.

| Field           | Good checklist                                                                   |
| --------------- | -------------------------------------------------------------------------------- |
| Route decision  | "Use Hyperliquid Spot trades for `HYPE-USDC`; cite the route before calling it." |
| Request bound   | "Run one freshness check or one page before adding loops."                       |
| Credential path | "Read `OXARCHIVE_API_KEY` from the shell; do not print it."                      |
| Output shape    | "Return the route, status, key fields, and `meta.request_id`."                   |
| Stop rule       | "Ask before exports, dependency installs, or wider market pulls."                |

## Safety Boundaries

The Skill should not install arbitrary packages, mutate unrelated files, or run broad exports by default. It should teach Claude Code to choose the route family, use `X-API-Key`, inspect freshness, parse the response envelope, and stop when the prompt lacks venue, symbol, or time-window information.

## Next Step

Use [Skill](/skill) for the full surface description and [MCP Claude setup](/mcp-claude) if the Claude workflow should use MCP instead.