Apertis skills for your coding agent
You can now give Claude Code, Cursor, Codex and other agents four Apertis skills from one public repository: a verified first call, an API reference, a model picker and an OpenAI migration.
With four skills installed, your coding agent walks you to a verified first call, answers from an API reference, picks a model for a task, and moves an OpenAI SDK codebase over to Apertis. One command installs them from apertis-ai/apertis-skills, and they work with Claude Code, Cursor, Codex and other agents.
Install the skills
Both routes install the same four skills.
| Tool | Command |
|---|---|
| Any agent that supports the Agent Skills format (Cursor, GitHub Copilot, Codex, Gemini CLI and others) | npx skills add apertis-ai/apertis-skills |
| Claude Code | /plugin marketplace add apertis-ai/apertis-skills, then /plugin install apertis-skills@apertis-skills |
To see what the repository holds before installing anything, add --list:
npx skills add apertis-ai/apertis-skills --list
The Claude Code route works because the repository publishes a plugin marketplace named apertis-skills with one plugin of the same name.
Pick the skill for the job
Each skill is a SKILL.md under skills/<name>/.
| Skill | What it makes the agent able to do | Triggers on |
|---|---|---|
apertis-quickstart | Walk you to a verified first call: check APERTIS_API_KEY, call https://api.apertis.ai/v1/chat/completions, confirm that :web returns a top-level web_sources array, and diagnose a 401, a wrong base URL, model_not_found, empty web_sources, a 429 and quota errors. | Getting started, setting up, a first call, a first call that fails |
apertis-api | Answer from a reference of auth, the documented endpoints, model families, the :web suffix and the Vercel AI SDK provider @apertis/ai-sdk-provider. | Calling or integrating the Apertis API |
apertis-model-picker | Recommend a model by task (coding, long context, fast chat, web search, vision, reasoning, cost) and call GET /v1/recommend for a current pick. | Which model to use for a task |
apertis-migrate | Move an OpenAI SDK codebase over: set base_url to https://api.apertis.ai/v1, rename OPENAI_API_KEY to APERTIS_API_KEY, update .env.example. Covers Python, TypeScript, curl, LangChain and the Vercel AI SDK. | Switching from OpenAI to Apertis |
All four are at the same version, which each SKILL.md states in its front matter:

Make your first call with the quickstart skill
The quickstart skill makes two real requests with your own key: a chat completion with max_tokens 32, then a :web request with max_tokens 256. It is written to use only your key, to stay read-only, and never to print the full key. It cannot create a key for you; sign up at apertis.ai, open API Keys, and export it:
export APERTIS_API_KEY="sk-..."Pay-as-you-go keys start with sk-, subscription keys with sk-sub_. Prompts that activate the skill include "Set up Apertis" and "Make my first Apertis API call."