Usage for Agents | OpenRouter Agent SDK

Give your AI coding assistant the knowledge to work with the OpenRouter Agent SDK by installing our official openrouter-typescript-sdk skill from the OpenRouterTeam/skills repository. The skill covers both the Agent SDK (@openrouter/agent) and the Client SDKs (@openrouter/sdk). When working with the Agent SDK, your AI assistant will focus on the agent features: callModel, tool() definitions, stop conditions, streaming, and multi-turn conversations.

Quick Start

Claude Code

/plugin marketplace add OpenRouterTeam/skills
/plugin install openrouter@openrouter

Cursor

Add via Settings > Rules > Add Rule > Remote Rule (Github) with OpenRouterTeam/skills.

GitHub CLI

Requires GitHub CLI v2.90.0+. Works with Claude Code, Cursor, OpenCode, Codex, Gemini CLI, Windsurf, and many more agents:

gh skill install OpenRouterTeam/skills openrouter-typescript-sdk

Supported AI Coding Assistants

The skill works with any AI coding assistant that supports the Agent Skills standard:

Assistant	Status
Claude Code	Supported
Cursor	Supported
OpenCode	Supported
GitHub Copilot	Supported
Codex	Supported
Amp	Supported
Roo Code	Supported
Antigravity	Supported

What the Skill Provides

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

callModel API - The recommended approach for making AI model calls with full type safety and streaming support
Tool Definitions - Creating tools with the tool() helper and Zod schemas
Stop Conditions - Controlling agent loop termination with stepCountIs, maxCost, and more
Streaming - Real-time token output within agent steps
Multi-turn Conversations - Managing conversation state across turns
Dynamic Parameters - Changing model, temperature, or tools between turns

Example Usage

After installing the skill, your AI assistant can help you with tasks like: “Help me set up an OpenRouter agent” The assistant will know to use:

import { OpenRouter } from '@openrouter/agent';

const openrouter = new OpenRouter({
  apiKey: process.env.OPENROUTER_API_KEY,
});

const result = openrouter.callModel({
  model: 'anthropic/claude-sonnet-4',
  messages: [
    { role: 'user', content: 'Hello!' }
  ]
});

const text = await result.getText();

“Add a tool to my agent” The assistant understands the tool pattern:

import { OpenRouter, tool } from '@openrouter/agent';
import { z } from 'zod';

const openrouter = new OpenRouter({
  apiKey: process.env.OPENROUTER_API_KEY,
});

const searchTool = tool({
  name: 'search',
  description: 'Search the web',
  inputSchema: z.object({ query: z.string() }),
  execute: async ({ query }) => {
    return { results: ['...'] };
  },
});

const result = openrouter.callModel({
  model: 'anthropic/claude-sonnet-4',
  messages: [{ role: 'user', content: 'Search for TypeScript best practices' }],
  tools: [searchTool],
});

const text = await result.getText();

Repository

The skill source is available at: github.com/OpenRouterTeam/skills Contributions and feedback are welcome.

​Quick Start

​Claude Code

​Cursor

​GitHub CLI

​Supported AI Coding Assistants

​What the Skill Provides

​Example Usage

​Repository