Skip to main content

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.

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

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

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.
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