Skip to content
← Changelog
2.2.124
Feature

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.

ToolCommand
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
Terminal output of npx skills add with the list flag, showing the four Apertis skills and their descriptions

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>/.

SkillWhat it makes the agent able to doTriggers on
apertis-quickstartWalk 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-apiAnswer 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-pickerRecommend 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-migrateMove 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:

Terminal output of grep over the four SKILL.md files, each reporting version 1.4.0

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."