---
title: "RunAPI Skills — Install AI Models into Any Agent Runtime"
url: "https://runapi.ai/skills.md"
canonical: "https://runapi.ai/skills"
locale: "en"
---

# RunAPI Skills

A skill bundles everything an agent needs to call an AI model — install, docs, JSON schema, and runtime adapter. One command, one API key, 50+ agent runtimes.

## What is a model skill?

A skill is a self-contained package that bundles an AI model into an installable artifact for agent runtimes. It includes the install mechanism, typed JSON schema for tool calls, documentation, and a runtime adapter. Install once and the agent picks up the docs, the schema, and everything it needs to call the model.

## Why Skills

- **One auth, every provider** — A single RunAPI API key unlocks 18 providers. No separate accounts, no credential juggling — authenticate once and call any model.
- **Schema-first tool calls** — Each skill ships a typed JSON schema. Tool calls validate before the wire so bad requests never hit production.
- **Predictable cost & latency** — Per-call or per-unit metered pricing — see exactly what each call costs before you run it. Failed generations are not charged.

## Install

```bash
# Install a skill globally (works with Claude Code, Codex, Gemini CLI, Cursor, and 50+ agents)
npx skills add runapi-ai/suno -g

# Or via RunAPI CLI
runapi agent install-skill --target claude
```

## How It Works

1. **Install** — One command installs the skill globally. The agent runtime discovers it automatically.
2. **Authenticate** — Run runapi login to sign in, or set RUNAPI_API_KEY in your environment.
3. **Use** — Ask your agent to generate an image, video, or music. It finds the skill, validates the schema, and calls the API.

## FAQ

### What is a model skill?

A skill is a self-contained package that bundles an AI model into an installable artifact for agent runtimes. It includes the install mechanism, typed JSON schema for tool calls, documentation, and a runtime adapter.

### Which agent runtimes do skills support?

Skills work with Claude Code, Codex, Gemini CLI, Cursor, Windsurf, Roo Code, OpenClaw, Hermes Agent, and 50+ more agent runtimes that support the skills protocol.

### Do I need a separate account per provider?

No. A single RunAPI API key unlocks all 18 providers. You do not need separate accounts with Anthropic, OpenAI, Google, or any other provider.

### Are skills free?

Yes. Skills are free and open-source. API usage is billed through your RunAPI account with pay-as-you-go pricing. No subscriptions or minimum spend. Failed generations are not charged.

### Where do I report a broken skill?

Open an issue on the skill's GitHub repository at github.com/runapi-ai/<model-slug>, or contact support@runapi.ai.

### Can I use skills alongside the MCP server and CLI?

Yes. Skills, the MCP server, and the CLI all share the same RunAPI API key and account. A skill installed in Claude Code can call the same models you access through the MCP server or CLI. Tasks appear in the same dashboard regardless of which interface created them.

### How many models have installable skills?

RunAPI publishes skills for every model in the catalog — over 130 models across 18 providers covering image, video, music, audio, and LLM generation. Each skill includes typed input schema, pricing metadata, and a SKILL.md with usage examples.


## Links

- [Model catalog](https://runapi.ai/models)
- [MCP Server](https://runapi.ai/mcp)
- [CLI](https://runapi.ai/cli)
- [SDKs](https://runapi.ai/sdk)
- [Pricing](https://runapi.ai/pricing)
- [API docs](https://runapi.ai/docs)