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
Claude Code
Cursor
Codex
Google Gemini / Jules
Antigravity
Manual Download
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
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
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 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
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
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