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

# How to Use AI Skills

> Install and apply Herodotus AI skills in Claude Code, Cursor, Codex, Gemini, and other AI coding tools. Includes per-tool setup, skill selection guide, and multi-skill composition patterns.

Use this guide to install and apply Herodotus skills in your AI coding tools.

## Quick Install

Run the installer — it auto-detects your tools and lets you pick which ones to set up:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash
```

Or skip the selector and target a specific tool directly:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --claude
curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --cursor
curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --codex
curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --google
curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --antigravity
```

## Per-Tool Setup

<Tabs>
  <Tab title="Claude Code">
    **Via the installer (global):**

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --claude
    ```

    **Or project-local:**

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --claude --project
    ```

    **Or via the plugin marketplace (inside Claude Code):**

    ```bash theme={null}
    /plugin marketplace add HerodotusDev/ai-skills
    /plugin install herodotus-skills@herodotus
    ```

    **Or via the Claude CLI:**

    ```bash theme={null}
    claude plugin marketplace add HerodotusDev/ai-skills
    claude plugin install herodotus-skills@herodotus
    ```

    Then invoke any skill by name:

    ```
    /herodotus-skills:herodotus           # start here — full stack overview
    /herodotus-skills:atlantic-api
    /herodotus-skills:data-processor
    /herodotus-skills:storage-proof-api
    ```
  </Tab>

  <Tab title="Cursor">
    Skills are installed under a `herodotus/` folder. Install globally or per-project:

    ```bash theme={null}
    # Global (all projects)
    curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --cursor

    # Current project only
    curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --cursor --project
    ```

    Or install a single skill manually:

    ```bash theme={null}
    mkdir -p .cursor/skills/herodotus/atlantic-api
    curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/plugins/herodotus-skills/skills/atlantic-api/SKILL.md \
      -o .cursor/skills/herodotus/atlantic-api/SKILL.md
    ```
  </Tab>

  <Tab title="Codex">
    Skills are installed under a `herodotus/` folder. Install globally or per-project:

    ```bash theme={null}
    # Global (~/.codex/skills/herodotus/)
    curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --codex

    # Current project only
    curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --codex --project
    ```
  </Tab>

  <Tab title="Google Gemini / Jules">
    Google tools read `AGENTS.md` from the project root:

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --google
    ```

    Or manually:

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/AGENTS.md -o AGENTS.md
    ```
  </Tab>

  <Tab title="Antigravity">
    Skills are installed under a `herodotus/` folder in `~/.gemini/antigravity/skills/` (global) or `.agent/skills/` (per-project):

    ```bash theme={null}
    # Global (all projects)
    curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --antigravity

    # Current project only
    curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --antigravity --project
    ```

    Or install a single skill manually:

    ```bash theme={null}
    mkdir -p .agent/skills/herodotus/atlantic-api
    curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/plugins/herodotus-skills/skills/atlantic-api/SKILL.md \
      -o .agent/skills/herodotus/atlantic-api/SKILL.md
    ```
  </Tab>

  <Tab title="Manual Download">
    Use the `Copy Full Skill` or `Download Skill` buttons on each skill page to get the raw markdown content. Then paste it into your agent config, prompt library, or project files.

    Or download directly via curl:

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/plugins/herodotus-skills/skills/atlantic-api/SKILL.md \
      -o atlantic-api-SKILL.md
    ```
  </Tab>
</Tabs>

## Skill selection guide

* Use `Herodotus Full Stack AI Skill` when you're new or need the AI to understand the full stack and pick the right products.
* Use `Atlantic API AI Skill` for proving job submission, lifecycle, and artifact handling.
* Use `Data Processor AI Skill` for HDP module design and soundness-focused execution.
* Use `Data Processor API AI Skill` for module/task orchestration through HTTP endpoints.
* Use `Storage Proof API AI Skill` for proof requests and Satellite readback flows.
* Use `Satellite Contracts AI Skill` for on-chain integration and contract-side read patterns.
* Use `Data Structure Indexer API AI Skill` for accumulator/remapper discovery and proof-support data planning.

## Recommended workflow

```text theme={null}
1) Discovery and planning
2) Apply the relevant skill page
3) Implement from embedded reference example
4) Validate against canonical sources and OpenAPI
5) Add retries/observability/fail-closed behavior
```

## Multi-skill composition patterns

* **HDP + Indexer + Satellite:** use indexer for candidate discovery, HDP for constrained validation, Satellite for trusted consumption.
* **Storage Proof + Satellite:** submit proof jobs, wait for terminal success, then read via safe Satellite methods.
* **Data Processor API + Atlantic:** use API orchestration for queued jobs, Atlantic for proving lifecycle and artifacts.

## Safe usage rules

* Treat OpenAPI as source of truth for request/response shapes.
* Do not infer undocumented statuses, fields, chain support, or addresses.
* Keep chain/environment explicit in every workflow.
* Use safe-read methods and fail-closed policies for business decisions.

## GitHub Repository

All skills are open source. Contributions welcome:

[github.com/HerodotusDev/ai-skills](https://github.com/HerodotusDev/ai-skills)