Hesperan

(Agents)

Agents

A free skill that teaches your coding agent when and how to use Hesperan — in Claude Code, Codex, Cursor, Gemini CLI and every agent that reads Agent Skills. Pick one of three ways.

  1. 01

    Give it to your agent

    Paste this into Claude Code, Codex or any agent. It downloads and installs the skill itself.

    Prompt
    Install the Hesperan agent skill for yourself. Download https://hesperan.com/skill/hesperan.zip and unpack it so that the folder "hesperan" sits in your skills directory — for example ~/.claude/skills/hesperan (Claude Code), ~/.codex/skills/hesperan (Codex) or ~/.agents/skills/hesperan (shared by many agents).

If you can run shell commands, "curl -fsSL https://hesperan.com/install-skill.sh | sh" does the same for every agent on this machine.

Then read hesperan/SKILL.md, tell me where you installed it, and remind me to create an API key at https://hesperan.com/console/keys and set it as HESPERAN_API_KEY.
  2. 02

    Or one line in the terminal

    Installs the skill for every agent found on this machine. It only copies files — read it first if you like.

    Shell
    curl -fsSL https://hesperan.com/install-skill.sh | sh
    View the script →
  3. 03

    Or download it

    Unzip the folder hesperan into your agent's skills directory.

    Download hesperan.zipRead SKILL.md →

What your agent learns

  • — When a typed judgment beats prompting a chat model and parsing its text, and when it does not.
  • — The request format, the three judgment types and how to write good questions and options.
  • — Acting on probabilities: thresholds, and handing uncertain cases to a person.
  • — Errors, retries and billing — and how to ask Hesperan itself before a risky step.

Where it is installed

Claude Code
~/.claude/skills/hesperan
Codex
~/.codex/skills/hesperan
Cursor
~/.cursor/skills/hesperan
Gemini CLI
~/.gemini/skills/hesperan
OpenCode
~/.config/opencode/skills/hesperan
Other agents (shared)
~/.agents/skills/hesperan

The skill is free and MIT-licensed. Calls to the API use your plan or balance.

Get an API key →Quick start