Overview
Skills are reusable instruction sets that extend your AI coding assistant with APIMatic know-how. Drop a skill into Claude Code, Cursor, or Codex, and your agent gains step-by-step guidance for tasks like scaffolding a developer portal, wiring up API Copilot, or configuring LLMs.txt, all without leaving your editor.
Skills follow the open Agent Skills specification. Each skill ships as a SKILL.md file that the agent loads automatically when it detects a matching task.
Why use APIMatic skills
- Guided setup. Describe what you want; the agent runs the right APIMatic CLI commands, edits configuration files, and starts a local development server.
- No context-switching. Skip hopping between docs, terminal, and configuration files. The skill walks the agent through every step.
- Consistent results. Skills encode proven configurations for theming, navigation, API Copilot, SEO, CI builds, and more.
Available skills
| Skill | What it does | When to use |
|---|---|---|
apimatic-portal | Build, configure, and publish APIMatic Docs as Code developer portals | Creating, serving, or deploying a portal; configuring theme, navigation, API Copilot, LLMs.txt, SEO, custom pages, dynamic configurations, context plugins, header/footer customization, or API recipes |
More skills are on the way, covering SDK generation, OpenAPI optimization and MCP server generation.
Prerequisites
Before installing a skill, confirm you have:
- Node.js 20 or higher, and npm
- An APIMatic account (sign up free at app.apimatic.io)
- The APIMatic CLI installed globally:
npm install -g @apimatic/cli
Verify the CLI works:
apimatic --version
Install a skill
You have two options. Pick whichever fits your workflow.
Option 1: Install with the skills CLI (recommended)
The skills CLI installs any APIMatic skill into your agent's skills directory with one command:
# Install a specific skill
npx skills add apimatic/skills --skill apimatic-portal
The CLI detects which agents you have installed (Claude Code, Cursor, Codex, and others) and places the skill files in the correct directory.
Option 2: Ask your agent to install it
Paste this prompt into your agent:
Install the APIMatic skills from https://github.com/apimatic/skills.
1. Clone or download the repository.
2. Copy each skill folder under skills/ into the correct skills directory for this agent.
3. Confirm which skills were installed and where.
Option 3: Manual copy
Clone the apimatic/skills repository, then copy the skill folder into your agent's skills directory:
| Agent | Project-level path | Global path |
|---|---|---|
| Claude Code | .claude/skills/ | ~/.claude/skills/ |
| Cursor | .cursor/skills/ | ~/.cursor/skills/ |
| ChatGPT Codex | — | ~/.codex/skills/ |
For example, to install the portal skill for Claude Code globally:
git clone https://github.com/apimatic/skills
cp -r skills/skills/apimatic-portal ~/.claude/skills/
Use a skill
Once installed, the agent picks the right skill automatically based on your request. No special invocation needed. For example:
"Set up an APIMatic developer portal for the OpenAPI spec in ./spec.yaml."
The agent detects the apimatic-portal skill and guides you through authentication, project scaffolding, theming, and running a local development server.