Agent skill

API Endpoints

by overmind-core in overmind-core/overmind

End-to-end workflow for adding or changing a backend API endpoint — which module the serializer and view belong in, URL registration, OpenAPI client regeneration, and typed consumption from the…

AGPL-3.0Auto-check: notesBackend & APIs

Install API Endpoints

skills CLI

$ npx skills add overmind-core/overmind --skill api-endpoints -a claude-code

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

GitHub CLI

$ gh skill install overmind-core/overmind api-endpoints --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/overmind-core/overmind.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/api-endpoints .claude/skills/api-endpoints && 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/

Paste into Claude Code

Install the "api-endpoints" agent skill from https://github.com/overmind-core/overmind/tree/main/.agents/skills/api-endpoints into .claude/skills/api-endpoints/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-endpoints", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/overmind-core/overmind/tree/main/.agents/skills/api-endpoints

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add overmind-core/overmind --skill api-endpoints -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install overmind-core/overmind api-endpoints --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/overmind-core/overmind.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/api-endpoints .agents/skills/api-endpoints && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "api-endpoints" agent skill from https://github.com/overmind-core/overmind/tree/main/.agents/skills/api-endpoints into .agents/skills/api-endpoints/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-endpoints", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add overmind-core/overmind --skill api-endpoints -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install overmind-core/overmind api-endpoints --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/overmind-core/overmind.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/api-endpoints .cursor/skills/api-endpoints && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "api-endpoints" agent skill from https://github.com/overmind-core/overmind/tree/main/.agents/skills/api-endpoints into .cursor/skills/api-endpoints/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-endpoints", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/overmind-core/overmind.git --path .agents/skills/api-endpoints

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add overmind-core/overmind --skill api-endpoints -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install overmind-core/overmind api-endpoints --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/overmind-core/overmind.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/api-endpoints .gemini/skills/api-endpoints && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "api-endpoints" agent skill from https://github.com/overmind-core/overmind/tree/main/.agents/skills/api-endpoints into .gemini/skills/api-endpoints/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-endpoints", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install overmind-core/overmind api-endpoints

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add overmind-core/overmind --skill api-endpoints -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/overmind-core/overmind.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/api-endpoints .github/skills/api-endpoints && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "api-endpoints" agent skill from https://github.com/overmind-core/overmind/tree/main/.agents/skills/api-endpoints into .github/skills/api-endpoints/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-endpoints", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add overmind-core/overmind --skill api-endpoints -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install overmind-core/overmind api-endpoints --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/overmind-core/overmind.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/api-endpoints .opencode/skills/api-endpoints && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "api-endpoints" agent skill from https://github.com/overmind-core/overmind/tree/main/.agents/skills/api-endpoints into .opencode/skills/api-endpoints/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-endpoints", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: api-endpoints
GitHub stars: 597
Token cost: ~830 tokens
SKILL.md length: 332 words
Files: 1
Skills in repo: 20
Repo updated: Oct 8, 2026
First seen: Oct 7, 2026
Licence: AGPL-3.0

At a glance

End-to-end workflow for adding or changing a backend API endpoint — which module the serializer and view belong in, URL registration, OpenAPI client regeneration, and typed consumption from the…

Works in 5 steps: Serializer and view go in the surface's… → Register the route → Regenerate the client → …
Removing a DRF endpoint
SKILL.md covers 1. Serializer and view go in…, 2. Register the route, 3. Regenerate the client and 4. Register the API class in…, plus 2 more sections
Calls make and docker; needs MODAL_TOKEN_SECRET

What it does

API Endpoints is an agent skill from overmind-core/overmind. End-to-end workflow for adding or changing a backend API endpoint — which module the serializer and view belong in, URL registration, OpenAPI client regeneration, and typed consumption from the frontend. Use when adding, changing, or removing a DRF endpoint or serializer.

Its SKILL.md is about 830 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 Backend & APIs, covering REST APIs and OpenAPI specifications. It works with OpenAPI. The repository describes itself as: The platform for continuously improving AI agents. The licence is AGPL-3.0.

When your agent uses it

Removing a DRF endpoint
Tasks that involve REST APIs
Tasks that involve OpenAPI specifications

Example prompts

“/api-endpoints”

Requirements

Python 3
Docker
A credential in MODAL_TOKEN_SECRET

Workflow steps

5 steps, taken from the step headings in SKILL.md.

Serializer and view go in the surface's own module
Register the route
Regenerate the client
Register the API class in client.ts
Consume through the client, never raw fetch

What it can do on your machine

Read from SKILL.md and the folder at commit 3dec73c. 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:
- make
- docker
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use docker, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- MODAL_TOKEN_SECRET
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

API Endpoints loads about 830 tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 332 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteMentions a .env fileSKILL.md:34

efuse to load without Modal tokens when `.env` has none: prefix with `MODAL_TOKEN_ID=dummy MODAL_TOKEN_SECRET=dummy` — t

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 overmind-core/overmind at commit 3dec73c, republished under its AGPL-3.0 licence (© overmind-core). 332 words, ~830 tokens.

Download SKILL.mdSave it as .claude/skills/api-endpoints/SKILL.md (or your agent's skills folder).

name: api-endpoints
description: End-to-end workflow for adding or changing a backend API endpoint — which module the serializer and view belong in, URL registration, OpenAPI client regeneration, and typed consumption from the frontend. Use when adding, changing, or removing a DRF endpoint or serializer.

Adding or changing an API endpoint

The frontend consumes the backend exclusively through the generated typescript-fetch client at frontend/src/openapi/. Every API change runs the full loop below.

1. Serializer and view go in the surface's own module

overbae/api/ is one module per surface — eval_views.py/eval_serializers.py, datasets.py/dataset_serializers.py, optimizer.py, billing.py, otlp.py, and so on. views.py and serializers.py are the legacy monoliths; a new surface gets its own module rather than growing them.

Never return a raw dict from a view — request and response shapes are serializers. Keep business logic in services/ or on the model; annotate with @extend_schema where drf-spectacular needs help.

Expected input failures may use core.errors.InputValidationError with an authored public detail. Never build that detail from a caught exception, provider response or stored diagnostic. Return the authored detail for known failures; log unexpected exceptions server-side and return a fixed message. Apply the same boundary to MCP adapters.

2. Register the route

overbae/urls.py, on the DefaultRouter for viewsets:

python

router.register(r"widgets", WidgetViewSet, basename="widget")

or in urlpatterns for plain views.

3. Regenerate the client

bash

make generate_api_client

Settings refuse to load without Modal tokens when .env has none: prefix with MODAL_TOKEN_ID=dummy MODAL_TOKEN_SECRET=dummy — the schema step never talks to Modal.

Runs manage.py spectacular → dockerized openapi-generator-cli → rewrites frontend/src/openapi/{apis,models}.

The Compose frontend uses polling because Docker bind mounts can miss files recreated by generation. A method present on disk but missing at runtime can be a stale Vite transform: check the JavaScript served at /src/openapi/apis/<Api>.ts. Recreate the frontend with docker compose up -d --no-deps frontend after changing its watcher environment; restarting alone does not apply environment changes.

4. Register the API class in `client.ts`

typescript

import { WidgetsApi } from "./openapi";

export class API {
  widgets: WidgetsApi;
  constructor(private cfg: Configuration) {
    this.widgets = new WidgetsApi(this.cfg);
  }
}

5. Consume through the client, never raw fetch

typescript

import api from "@/client";
import type { Widget } from "@/openapi";

const widget: Widget = await api.widgets.widgetsRetrieve({ id });

Hardcoded URLs and bare fetch/axios bypass auth middleware and typing. Response types come from frontend/src/openapi/models/ — never redeclare a type that already exists there.

Rules

Never hand-edit anything under frontend/src/openapi/ — a hook blocks it under Claude Code, and the next regeneration would overwrite it anyway.
A DRF view docstring becomes the OpenAPI operation description, so editing one changes the generated client. Prefer an explicit @extend_schema(summary=...).

Files

Just SKILL.md in .agents/skills/api-endpoints of overmind-core/overmind.

Open the folder on GitHubat commit 3dec73c

Compare with similar skills

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

API Endpoints compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
API Endpoints this skillovermind-core/overmind	597	—	~830	Automated safety check: Notes	AGPL-3.0	today
API DesignerJeffallan/claude-skills	12k	2 repos	~2k	Automated safety check: Pass	MIT	5 days ago
OpenAPI to MCP Servermcp-use/mcp-use	11k	—	~5.2k	Automated safety check: Pass	Apache-2.0	today
Use Yaakmountain-loop/yaak	19k	—	~1.9k	Automated safety check: Pass	MIT	yesterday
Old Coder API DesignAmazingAng/old-coder	749	1 repos	~3.4k	Automated safety check: Pass	MIT	1 mo ago
API CallerNVIDIA/SkillEvaluator	548	1 repos	~1.1k	Automated safety check: Pass	Apache-2.0	yesterday

Similar skills

API Designer
Jeffallan/claude-skills
Designs REST and GraphQL APIs from resource modeling to an OpenAPI 3.1 contract, with versioning, pagination and RFC 7807 error handling.
12k GitHub starsUsed in 2 repos~2k tokens
Backend & APIsAuto-check passed
OpenAPI to MCP Server
mcp-use/mcp-use
Turns an OpenAPI or Swagger spec into an MCP server with the mcp-use TypeScript SDK, mapping each operation to a tool, wiring auth, testing and deploying.
11k GitHub stars~5.2k tokensUpdated today
Backend & APIsAuto-check passed
Use Yaak
mountain-loop/yaak
A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…
19k GitHub stars~1.9k tokensUpdated yesterday
Backend & APIsAuto-check passed
Old Coder API Design
AmazingAng/old-coder
Reviews or designs an HTTP/JSON API's endpoints, auth, pagination, versioning and deprecations, guarding against inventing a bespoke interface or silently breaking consumers.
749 GitHub starsUsed in 1 repo~3.4k tokens
Backend & APIsAuto-check passed
API Caller
NVIDIA/SkillEvaluator
Official
Call any REST API dynamically. An agent skill from NVIDIA/SkillEvaluator.
548 GitHub starsUsed in 1 repo~1.1k tokens
Backend & APIsAuto-check passed
API Generating
huangjia2019/claude-code-engineering
Generate API endpoint code and documentation from specifications.
1.1k GitHub starsUsed in 1 repo~379 tokens
Backend & APIsAuto-check passed

More from overmind-core/overmind

All 20 skills in this repo

Finetuning Model Onboarding
overmind-core/overmind
Rules for adding a new model or model family to the finetuning pipeline, or changing finetuning behavior for an existing one — engine-agnostic customization via family hooks instead of if/else in…
597 GitHub stars~3.2k tokensUpdated today
Auto-check passed
Frontend Design
overmind-core/overmind
Overmind Console design system — semantic tokens, shared primitives, geometry and icons, the border-contrast floor, the duplicated table implementations, and the verification scripts.
597 GitHub stars~1.8k tokensUpdated today
Auto-check passed
MCP
overmind-core/overmind
End-to-end workflow for adding or changing Overmind MCP tools, resources, prompts, authentication, or result contracts — server layers, catalog registration, MCP-impact classification, and required…
597 GitHub stars~4.3k tokensUpdated today
Auto-check passed
PR Etiquette
overmind-core/overmind
How to open a complete pull request on overmind-core/overmind — the CI gates, the cross-cutting surfaces a change must carry with it (MCP, blast radius, the docs repo), gh pr edit being broken here…
597 GitHub stars~1.5k tokensUpdated today
Auto-check passed
Seed Demo Data
overmind-core/overmind
Run or modify the seeddemo management command (the one-project Support Copilot demo) without breaking the beat-safety invariants that keep celery workers from re-driving seeded rows.
597 GitHub stars~973 tokensUpdated today
Auto-check passed
Overmind Agent
overmind-core/overmind
Inspect an Overmind project's agent map, capabilities, behaviour contracts, repository provenance and evaluation coverage.
597 GitHub stars~797 tokensUpdated today
Auto-check passed

Works with

OpenAPI

Questions about API Endpoints

What does API Endpoints do?

End-to-end workflow for adding or changing a backend API endpoint — which module the serializer and view belong in, URL registration, OpenAPI client regeneration, and typed consumption from the…. API Endpoints is an agent skill from overmind-core/overmind. End-to-end workflow for adding or changing a backend API endpoint — which module the serializer and view belong in, URL registration, OpenAPI client regeneration, and typed consumption from the frontend.

When should I use API Endpoints?

API Endpoints fits situations like: removing a DRF endpoint; tasks that involve REST APIs; tasks that involve OpenAPI specifications.

How do I install API Endpoints in Claude Code?

Run `npx skills add overmind-core/overmind --skill api-endpoints -a claude-code`. Or copy the skill folder (.agents/skills/api-endpoints in overmind-core/overmind) into .claude/skills/api-endpoints in your project. Claude Code loads it when a task matches its description.

How do I install API Endpoints in Codex?

Run `npx skills add overmind-core/overmind --skill api-endpoints -a codex`. Or copy the skill folder (.agents/skills/api-endpoints in overmind-core/overmind) into .agents/skills/api-endpoints in your project. Codex loads it when a task matches its description.

Can I use API Endpoints 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 overmind-core/overmind --skill api-endpoints -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/api-endpoints, .gemini/skills/api-endpoints, .github/skills/api-endpoints and .opencode/skills/api-endpoints in your project.

What does API Endpoints need to run?

Going by SKILL.md and its folder, API Endpoints needs the command-line tools its instructions call (make and docker) and credentials named MODAL_TOKEN_SECRET. Our summary lists: Python 3; Docker; A credential in MODAL_TOKEN_SECRET.

Does API Endpoints access the network?

SKILL.md contains no URLs. Its commands use docker, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is API Endpoints safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does API Endpoints use?

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

How many tokens does API Endpoints use?

About 830 tokens (SKILL.md is roughly 3.3k 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 API Endpoints?

Skills that share tags, products or a category with API Endpoints: API Designer (Jeffallan/claude-skills, 12k stars), OpenAPI to MCP Server (mcp-use/mcp-use, 11k stars), Use Yaak (mountain-loop/yaak, 19k stars) and Old Coder API Design (AmazingAng/old-coder, 749 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains API Endpoints?

overmind-core (a GitHub organization) maintains it in overmind-core/overmind, which has 597 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 8, 2026.

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

Install API Endpoints

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Adding or changing an API endpoint

1. Serializer and view go in the surface's own module

2. Register the route

3. Regenerate the client

4. Register the API class in client.ts

5. Consume through the client, never raw fetch

Rules

Files

Compare with similar skills

Similar skills

More from overmind-core/overmind

Related

Questions about API Endpoints

4. Register the API class in `client.ts`