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:

curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash

Or skip the selector and target a specific tool directly:

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

Claude Code

Via the installer (global):

curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --claude

Or project-local:

curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --claude --project

Or via the plugin marketplace (inside Claude Code):

/plugin marketplace add HerodotusDev/ai-skills
/plugin install herodotus-skills@herodotus

Or via the Claude CLI:

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

Cursor

Skills are installed under a herodotus/ folder. Install globally or per-project:

# 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:

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

Codex

Skills are installed under a herodotus/ folder. Install globally or per-project:

# 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

Google Gemini / Jules

Google tools read AGENTS.md from the project root:

curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --google

Or manually:

curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/AGENTS.md -o AGENTS.md

Antigravity

Skills are installed under a herodotus/ folder in ~/.gemini/antigravity/skills/ (global) or .agent/skills/ (per-project):

# 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:

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

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:

curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/plugins/herodotus-skills/skills/atlantic-api/SKILL.md \
  -o atlantic-api-SKILL.md

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

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