Agent skill

Openagents API

by OpenAgentsInc in OpenAgentsInc/openagents

Call the OpenAgents API (Open Responses and Chat Completions, many models, one key) and read its docs.

Apache-2.0Auto-check passedAI & LLM Engineering

Install Openagents API

skills CLI
$ npx skills add OpenAgentsInc/openagents --skill openagents-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install OpenAgentsInc/openagents openagents-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/OpenAgentsInc/openagents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/crates/openagents-web/content/skills/openagents-api .claude/skills/openagents-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
openagents-api
GitHub stars
455
Token cost
~430 tokens
SKILL.md length
161 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
Apache-2.0

At a glance

Call the OpenAgents API (Open Responses and Chat Completions, many models, one key) and read its docs.

  • Works in 4 steps: Read the key from OPENAGENTS_API_KEY. If… → Send a request → With an OpenAI SDK, set base_url to… → …
  • A task needs a model through OpenAgents
  • SKILL.md covers Steps and Reading the docs as tools
  • Calls curl; reaches openagents.com and api.openagents.com; needs OPENAGENTS_API_KEY

What it does

Openagents API is an agent skill from OpenAgentsInc/openagents. Call the OpenAgents API (Open Responses and Chat Completions, many models, one key) and read its docs. Use when a task needs a model through OpenAgents, or asks what OpenAgents models cost.

Its SKILL.md is about 430 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering LLM API integration. The licence is Apache-2.0.

When your agent uses it

  • A task needs a model through OpenAgents
  • Asks what OpenAgents models cost

Example prompts

  • “/openagents-api”

Requirements

  • A credential in OPENAGENTS_API_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Read the key from OPENAGENTS_API_KEY. If it is missing, tell the person
  2. Send a request
  3. With an OpenAI SDK, set base_url to https://api.openagents.com/v1 and
  4. On 429, wait for Retry-After. On 402, the balance is too low; tell

What it can do on your machine

Read from SKILL.md and the folder at commit f3e551c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • openagents.com
    • api.openagents.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OPENAGENTS_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Openagents API loads about 430 tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 161 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~430

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenAgentsInc/openagents at commit f3e551c, republished under its Apache-2.0 licence (© OpenAgentsInc). 161 words, ~430 tokens.

Download SKILL.mdSave it as .claude/skills/openagents-api/SKILL.md (or your agent's skills folder).
name
openagents-api
description
Call the OpenAgents API (Open Responses and Chat Completions, many models, one key) and read its docs. Use when a task needs a model through OpenAgents, or asks what OpenAgents models cost.

OpenAgents API

One API for many models. It speaks Open Responses and the OpenAI Chat Completions API, so OpenAI SDKs work with two changes. Beta.

Base URLhttps://api.openagents.com/v1 (also https://openagents.com/api/v1)
KeyAuthorization: Bearer $OPENAGENTS_API_KEY (an oak_ key)
Docshttps://openagents.com/docs/api.md
Priceshttps://openagents.com/docs/api/models.md
Getting a keyhttps://openagents.com/auth.md

Steps

  1. Read the key from OPENAGENTS_API_KEY. If it is missing, tell the person to make one at https://openagents.com/settings/api-keys; never ask for it in chat or write it to a file.

  2. Send a request:

    sh
    curl https://api.openagents.com/v1/responses \
      -H "Authorization: Bearer $OPENAGENTS_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{"model": "openagents/chat", "input": "Say hello."}'

    openagents/chat lets OpenAgents pick the model. Name one (see the prices page) to choose it yourself.

  3. With an OpenAI SDK, set base_url to https://api.openagents.com/v1 and pass the key as the API key.

  4. On 429, wait for Retry-After. On 402, the balance is too low; tell the person. Every answer has an x-request-id to quote when asking for help.

Reading the docs as tools

The docs MCP server at https://openagents.com/mcp/docs (Streamable HTTP, no key) has list_docs, search_docs, read_doc, and list_models.

© OpenAgentsInc, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in crates/openagents-web/content/skills/openagents-api of OpenAgentsInc/openagents.

Open the folder on GitHubat commit f3e551c

Compare with similar skills

Openagents API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Openagents API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Openagents API this skillOpenAgentsInc/openagents455—~430Automated safety check: PassApache-2.0
Dingo VerifyMigoXLab/dingo757—~833Automated safety check: PassApache-2.0
Agnes Free Textkangarooking/agnes-free-model-skills199—~630Automated safety check: PassMIT
Openai Docstheowenyoung/home1151 repos~1.4kAutomated safety check: PassApache-2.0
AIbutterbase-ai/butterbase-skills534—~1.1kAutomated safety check: PassMIT
Building Streamlit Chat UIiusztinpaul/designing-real-world-ai-agents-workshop512—~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Dingo Verify

    MigoXLab/dingo

    A skill your agent uses when the user wants to fact-check an article or verify factual claims in a document.

    757 GitHub stars~833 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Agnes Free Text

    kangarooking/agnes-free-model-skills

    Call the free Agnes text model API for chat completions, streaming answers, coding help, tool-calling experiments, and OpenAI-compatible text generation.

    199 GitHub stars~630 tokensUpdated 4 mo ago
    AI & LLM EngineeringAuto-check passed
  • Openai Docs

    theowenyoung/home

    A skill your agent uses for Codex models/pricing, scheduled tasks, skills, settings, setup, troubleshooting, customization, automations, and self-knowledge—including 'you,' 'your,' 'this app,' or…

    115 GitHub starsUsed in 1 repo~1.4k tokens
    AI & LLM EngineeringAuto-check passed
  • AI

    butterbase-ai/butterbase-skills

    A skill your agent uses when calling the app's AI gateway from agent tools — chat completions, embeddings, listing models, configuring defaults or BYOK, reading token/cost usage

    534 GitHub stars~1.1k tokensUpdated 4 days ago
    AI & LLM EngineeringAuto-check passed
  • Building Streamlit Chat UI

    iusztinpaul/designing-real-world-ai-agents-workshop

    Building chat interfaces in Streamlit. An agent skill from iusztinpaul/designing-real-world-ai-agents-workshop.

    512 GitHub stars~1.4k tokensUpdated 4 mo ago
    AI & LLM EngineeringAuto-check passed
  • Instructor Structured LLM Outputs

    Orchestra-Research/AI-Research-SKILLs

    Shows how to pull validated, typed data out of LLM responses with Instructor and Pydantic models, including retries on failure and partial streaming.

    13k GitHub starsUsed in 6 repos~4.2k tokens
    AI & LLM EngineeringAuto-check passed

More from OpenAgentsInc/openagents

  • Typesafe AI

    OpenAgentsInc/openagents

    Build AI-powered software with TypeSafe: small units of AI intelligence you can use like programming primitives.

    455 GitHub starsUsed in 9 repos~2.5k tokens
    Auto-check passed
  • Decision API

    OpenAgentsInc/openagents

    Call the OpenAgents decision API: authenticate with an oak bearer key, post state + typed questions to POST /v1/systemone, read Noul, Choice, and Score answers with their probabilities, and handle…

    455 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Google Developer Style

    OpenAgentsInc/openagents

    Apply the Google Developer Documentation Style Guide to user-facing docs, READMEs, AGENTS.md, and commit messages.

    455 GitHub stars~630 tokensUpdated today
    Auto-check passed
  • Openagents Decision API

    OpenAgentsInc/openagents

    Authenticate to and call the OpenAgents decision API — typed decisions, batch classification, durable jobs, and the bundled documentation — through the oak CLI, the oak-mcp server, or raw HTTP.

    455 GitHub stars~680 tokensUpdated today
    Auto-check passed
  • Nostr

    OpenAgentsInc/openagents

    How Nostr works in this repository: the three NIP lanes under nips/, the wire protocol (NIP-01), relay authentication (NIP-42), payload encryption (NIP-44), the Block agent NIPs the relay serves…

    455 GitHub stars~6.2k tokensUpdated today
    Auto-check passed

Questions about Openagents API

What does Openagents API do?

Call the OpenAgents API (Open Responses and Chat Completions, many models, one key) and read its docs. Openagents API is an agent skill from OpenAgentsInc/openagents. Call the OpenAgents API (Open Responses and Chat Completions, many models, one key) and read its docs.

When should I use Openagents API?

Openagents API fits situations like: A task needs a model through OpenAgents; asks what OpenAgents models cost.

How do I install Openagents API in Claude Code?

Run `npx skills add OpenAgentsInc/openagents --skill openagents-api -a claude-code`. Or copy the skill folder (crates/openagents-web/content/skills/openagents-api in OpenAgentsInc/openagents) into .claude/skills/openagents-api in your project. Claude Code loads it when a task matches its description.

How do I install Openagents API in Codex?

Run `npx skills add OpenAgentsInc/openagents --skill openagents-api -a codex`. Or copy the skill folder (crates/openagents-web/content/skills/openagents-api in OpenAgentsInc/openagents) into .agents/skills/openagents-api in your project. Codex loads it when a task matches its description.

Can I use Openagents API in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OpenAgentsInc/openagents --skill openagents-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/openagents-api, .gemini/skills/openagents-api, .github/skills/openagents-api and .opencode/skills/openagents-api in your project.

What does Openagents API need to run?

Going by SKILL.md and its folder, Openagents API needs the command-line tools its instructions call (curl) and credentials named OPENAGENTS_API_KEY. Our summary lists: A credential in OPENAGENTS_API_KEY.

Does Openagents API access the network?

SKILL.md names 2 domains. In commands or code: openagents.com and api.openagents.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Openagents API safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Openagents API use?

Openagents API is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Openagents API use?

About 430 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Openagents API?

Skills that share tags, products or a category with Openagents API: Dingo Verify (MigoXLab/dingo, 757 stars), Agnes Free Text (kangarooking/agnes-free-model-skills, 199 stars), Openai Docs (theowenyoung/home, 115 stars) and AI (butterbase-ai/butterbase-skills, 534 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Openagents API?

OpenAgentsInc (a GitHub organization) maintains it in OpenAgentsInc/openagents, which has 455 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 10, 2026.

Source: OpenAgentsInc/openagents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.