herodotus

Herodotus AI Skills

Vendor-neutral AI skill playbooks for building with Herodotus Cloud Services. These skills provide architecture patterns, implementation workflows, anti-hallucination guardrails, and reference examples for every Herodotus product.

Quick Install

Run the installer and pick the tools you use from an interactive selector (auto-detects what's installed):

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

Or skip the selector and install for specific tools directly:

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

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

# Codex / Gemini CLI (both use .agents/skills standard)
curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --codex

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

# Google Antigravity
curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --antigravity

# Cursor into current project (instead of global)
curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --cursor --project

# Codex into current project (instead of global)
curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --codex --project

# Antigravity into current project (instead of global)
curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --antigravity --project

Per-Tool Setup

Claude Code

Uses the native plugin marketplace:

# In Claude Code CLI
/plugin marketplace add HerodotusDev/ai-skills
/plugin install herodotus-skills@herodotus

Then invoke any skill:

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

Cursor

Skills are installed as SKILL.md files under a herodotus/ folder. The installer places them in ~/.cursor/skills/herodotus/ (global) or .cursor/skills/herodotus/ (per-project).

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

Or manually copy any skill:

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 / Gemini CLI

Both Codex and Gemini CLI read skills from the .agents/skills/ standard path. One install covers both tools.

Skills are installed under ~/.agents/skills/herodotus/ (global) or .agents/skills/herodotus/ (per-project).

curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --codex
# or equivalently:
curl -fsSL https://raw.githubusercontent.com/HerodotusDev/ai-skills/main/install.sh | bash -s -- --gemini-cli

Or install into the current project:

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

Or manually copy any skill:

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

Google Jules

Downloads an AGENTS.md file into your project root:

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

Or copy it manually:

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

Google Antigravity

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

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

Or install into the current project:

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

Or manually copy any skill:

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

Download any individual skill directly: