# Apertis Changelog: 2.2.124 — Feature Added

Canonical page: https://apertis.ai/changelog/2.2.124
Markdown mirror: https://apertis.ai/changelog/2.2.124.md
Version: 2.2.124
Title: Feature Added
Published: 2026-11-14
Category: feature

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.

## Details

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](https://github.com/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`:

```bash
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](/changelog-media/2.2.124/skills-list.jpg "demo: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:

![Terminal output of grep over the four SKILL.md files, each reporting version 1.4.0](/changelog-media/2.2.124/skills-versions.jpg)

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

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