Agent Skills | Clarifai Docs

Supercharge AI coding assistants with deep Clarifai knowledge

Clarifai Skills are specialized prompt templates that transform AI coding assistants — Claude Code, Cursor, Codex, and more — into Clarifai platform experts.

You don't need to explain APIs from scratch. Just describe what you want in plain language — such as "list my apps" — and your assistant finds the right skill and gets to work.

Built on the open Agent Skills standard, Clarifai Skills work out of the box across 30+ agent platforms.

Available Skills

Prerequisites

Set Up an AI Coding Assistant

You need an AI coding assistant — such as Claude Code, Cursor, GitHub Copilot, OpenAI Codex, or Gemini — installed and configured on your machine.

Install the Clarifai Python SDK

• Bash

pip install --upgrade clarifai

Log in via the CLI

Log in to Clarifai and authenticate your connection with your PAT (Personal Access Token).

• CLI

clarifai login

Install Skills

Option A: Clarifai CLI (Recommended)

Run the skills installer. If no agent flag is specified, it auto-detects installed agents. If no skill name is given, it installs all available skills.

• CLI

clarifai skills install                         # all skills, auto-detect agents
clarifai skills install --claude                # all skills for Claude Code
clarifai skills install clarifai-cli --claude   # one skill for Claude Code
clarifai skills install --claude --cursor       # all skills, multi-agent
clarifai skills install --local                 # project-level install

Scope flags

• --claude — Target Claude Code
• --codex — Target OpenAI Codex
• --cursor — Target Cursor
• --copilot — Target GitHub Copilot
• --gemini — Target Gemini
• --all-agents — Target all supported agents
• --global — Install globally (~/) (default)
• --local — Install at project level (./)
• --force — Overwrite existing skills
• --source PATH — Install or update from a local skills repo clone instead of GitHub

Option B: Claude Code Plugin

If you use Claude Code, you can install Clarifai skills directly via the plugin marketplace:

• Bash

claude plugin marketplace add Clarifai/skills   # Register the Clarifai skills repo
claude plugin install clarifai-skills            # Install all skills as a single plugin

Managing Skills

• CLI

clarifai skills list --remote           # browse available skills (shorthand: ls)
clarifai skills list --installed        # see what's installed
clarifai skills update                  # update all (auto-detect agents)
clarifai skills update --claude         # update for Claude only
clarifai skills remove clarifai-cli --claude    # remove one skill from Claude Code
clarifai skills remove --all                    # remove all Clarifai skills

How It Works

Each skill is a folder containing a SKILL.md file with YAML frontmatter and markdown documentation, plus optional references/ and examples/ subdirectories.

• CLI

clarifai-cli/
  SKILL.md        ← instructions loaded by the agent
  references/     ← detailed reference docs
  examples/       ← working code examples

When you install skills, they are placed in a central location and symlinked per agent:

• CLI

~/.agents/skills/           # one copy of each skill
  clarifai-cli/
  clarifai-model-upload/
  ...
~/.claude/skills/           # symlinks for Claude Code
  clarifai-cli -> ~/.agents/skills/clarifai-cli
  ...

Skills activate when your request matches their description. Depending on your AI assistant, you can trigger them:

• By asking naturally — describe what you want and the assistant picks the right skill:

"How do I run inference on a Clarifai model?"
"Deploy a vLLM model to Clarifai"
"Train an image classifier on my dataset"

• Via slash commands (supported in assistants like Claude Code):

/clarifai-inference
/clarifai-cli
/clarifai-model-upload

• By pasting skill context — in assistants like Cursor or Codex, you can paste a skill's prompt directly into your system prompt or context window to activate its guidance.

Example Usage

Run Inference

Tell your assistant: "Run inference on Claude Sonnet 4 with the prompt: Hello world".

The clarifai-inference skill guides the assistant to generate code like:

• Python

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.clarifai.com/v2/ext/openai/v1",
    api_key=os.environ['CLARIFAI_PAT'],
)

response = client.chat.completions.create(
    model="https://clarifai.com/anthropic/completion/models/claude-sonnet-4",
    messages=[{"role": "user", "content": "Hello world"}],
)
print(response.choices[0].message.content)

Or, run it directly from the terminal:

• CLI

clarifai model predict anthropic/completion/models/claude-sonnet-4 "Hello world"

Deploy a Model

Tell your assistant: "Deploy Qwen3-0.6B with vLLM".

The clarifai-cli and clarifai-model-upload skills guide the assistant to run:

• CLI

clarifai model init ./qwen --toolkit vllm --model-name "Qwen/Qwen3-0.6B"
clarifai model serve ./qwen    # test locally
clarifai model deploy ./qwen   # deploy to cloud

More Examples

Here are more prompts you can use with your assistant:

• "Create a FastMCP server with a web search tool and deploy it to Clarifai"
• "Upload my COCO-format dataset to Clarifai with detection annotations"
• "My deployment is stuck — help me debug it"
• "Train an image classifier on my dataset"
• "Show me how to run inference on a Clarifai-hosted LLM using the OpenAI-compatible API"

Build your next AI app, test and tune popular LLMs models, and much more.