> ## Documentation Index
> Fetch the complete documentation index at: https://docs.portkey.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agentic Usage

> Add Prisma AIRS AI Gateway SDK skills to your AI coding assistant

Give your AI coding assistant the knowledge to work with AI Gateway SDKs by installing our official skills. This enables AI agents to understand the AI Gateway's APIs, patterns, and best practices when helping you write code.

## Quick Start

Run this command in your project directory:

```bash theme={"system"}
npx add-skill portkey-ai/skills
```

This installs AI Gateway SDK skills, which teach your AI assistant how to use the SDKs effectively.

### Install a Specific Skill

<Tabs>
  <Tab title="Python SDK">
    ```bash theme={"system"}
    npx add-skill portkey-ai/skills --skill portkey-python-sdk
    ```
  </Tab>

  <Tab title="TypeScript SDK">
    ```bash theme={"system"}
    npx add-skill portkey-ai/skills --skill portkey-typescript-sdk
    ```
  </Tab>
</Tabs>

## Supported AI Coding Assistants

The skills work with any AI coding assistant that supports the Agent Skills format:

| Assistant                                                     | Status    |
| ------------------------------------------------------------- | --------- |
| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | Supported |
| [Cursor](https://cursor.com)                                  | Supported |
| [OpenCode](https://opencode.ai)                               | Supported |
| [GitHub Copilot](https://github.com/features/copilot)         | Supported |
| [Codex](https://openai.com/index/openai-codex)                | Supported |
| [Amp](https://amp.dev)                                        | Supported |
| [Roo Code](https://roo.dev)                                   | Supported |

## What the Skills Provide

Once installed, your AI coding assistant will have knowledge of:

* **SDK Installation & Setup** — How to install and configure AI Gateway SDKs in Python and TypeScript projects
* **Chat Completions** — Making LLM calls with full streaming support
* **Observability & Tracing** — Adding trace IDs, metadata, and custom tags for debugging
* **Caching** — Semantic and simple caching to reduce costs and latency
* **Fallbacks** — Automatic failover when a provider fails
* **Load Balancing** — Distribute traffic across multiple providers or API keys
* **Multi-Provider Routing** — Route requests to 3,000+ LLMs through a unified API
* **Error Handling** — Proper retry logic and error handling patterns
* **Framework Integrations** — Working with LangChain, LlamaIndex, Strands, and Google ADK

## Example Usage

After installing the skills, your AI assistant can help you with tasks like:

**"Help me set up the AI Gateway with OpenAI fallback to Anthropic"**

The assistant will know to use:

**"Add request tracing to my AI Gateway calls"**

The assistant understands the observability API:

<Tabs>
  <Tab title="Python">
    ```python theme={"system"}
    response = client.with_options(
        trace_id="unique-trace-id",
        metadata={
            "user_id": "user-123",
            "session_id": "session-456",
            "environment": "production"
        }
    ).chat.completions.create(
        model="@openai/gpt-4o",
        messages=[{"role": "user", "content": "Summarize this document..."}]
    )
    ```
  </Tab>

  <Tab title="TypeScript">
    ```typescript theme={"system"}
    const response = await client.chat.completions.create({
      model: '@openai/gpt-4o',
      messages: [{ role: 'user', content: 'Summarize this document...' }]
    }, {
      traceId: 'unique-trace-id',
      metadata: {
        userId: 'user-123',
        sessionId: 'session-456',
        environment: 'production'
      }
    });
    ```
  </Tab>
</Tabs>

**"Enable semantic caching for my LLM requests"**

## Installation Options

### List Available Skills

```bash theme={"system"}
npx add-skill portkey-ai/skills --list
```

### Project-Level Installation (Default)

Installs skills to your current project directory:

```bash theme={"system"}
npx add-skill portkey-ai/skills
```

### Global Installation

Installs skills globally so they're available across all your projects:

```bash theme={"system"}
npx add-skill portkey-ai/skills --global
```

### Target Specific Agent

Install for a specific AI coding assistant only:

```bash theme={"system"}
npx add-skill portkey-ai/skills --agent cursor
npx add-skill portkey-ai/skills --agent claude
```

## Manual Installation

If you prefer to install manually, copy the skill files to your project's skills directory:

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={"system"}
    mkdir -p .claude/skills/portkey-python-sdk
    curl -o .claude/skills/portkey-python-sdk/SKILL.md \
      https://raw.githubusercontent.com/portkey-ai/skills/main/skills/portkey-python-sdk/SKILL.md
    ```
  </Tab>

  <Tab title="Cursor">
    ```bash theme={"system"}
    mkdir -p .cursor/skills/portkey-python-sdk
    curl -o .cursor/skills/portkey-python-sdk/SKILL.md \
      https://raw.githubusercontent.com/portkey-ai/skills/main/skills/portkey-python-sdk/SKILL.md
    ```
  </Tab>
</Tabs>

## Updating the Skills

To get the latest SDK documentation, re-run the install command:

```bash theme={"system"}
npx add-skill portkey-ai/skills
```

The skills are automatically updated when new SDK versions are released.

## Repository

The skill source is available at: [github.com/portkey-ai/skills](https://github.com/portkey-ai/skills)

Contributions and feedback are welcome.

<CardGroup cols={2}>
  <Card title="Skills Repository" icon="github" href="https://github.com/portkey-ai/skills">
    View the skills source on GitHub
  </Card>
</CardGroup>


## Related topics

- [Conductor](/docs/aigw/integrations/libraries/conductor.md)
- [Claude Code](/docs/aigw/integrations/libraries/claude-code.md)
- [Open Responses](/docs/aigw/product/ai-gateway/responses-api.md)
- [Palo Alto Networks Prisma AIRS](/docs/aigw/integrations/guardrails/palo-alto-panw-prisma.md)
- [Enterprise Gateway](/docs/aigw/changelog/enterprise.md)