OpenRouter 官方提供了 openrouter-typescript-sdk skill，安装到 AI 编程助手后，助手将了解 @openrouter/sdk Client SDK 的 SDK 安装配置、chat completions、streaming、embeddings、tool use、API key 管理和 OAuth PKCE 认证等功能。同一个 skill 也涵盖 Agent SDK（@openrouter/agent）。支持 Claude Code、Cursor、OpenCode、GitHub Copilot 等 8 种助手。

通过安装官方 openrouter-typescript-sdk skill（来自 OpenRouterTeam/skills 仓库），让 AI 编程助手获得 OpenRouter Client SDK 的完整使用知识。

该 skill 同时覆盖：

• Client SDK (@openrouter/sdk)：平台功能——模型列表、chat completions、credits、OAuth、API key 管理
• Agent SDK (@openrouter/agent)：agent 功能——多轮循环、工具、stop conditions

快速安装

Claude Code

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

Cursor

通过 Settings > Rules > Add Rule > Remote Rule (Github)，输入 OpenRouterTeam/skills 添加。

Skills CLI（通用）

npx skills add OpenRouterTeam/skills

支持的 AI 编程助手

该 skill 兼容所有支持 Agent Skills 标准的助手：

助手	状态
Claude Code	已支持
Cursor	已支持
OpenCode	已支持
GitHub Copilot	已支持
Codex	已支持
Amp	已支持
Roo Code	已支持
Antigravity	已支持

Skill 提供的知识范围

安装后，AI 编程助手将掌握：

• SDK 安装与配置 — 如何在 TypeScript 项目中安装和初始化 @openrouter/sdk
• Chat Completions — 使用 chat API 进行对话
• Embeddings — 生成 embeddings 用于语义搜索和 RAG
• 错误处理 — 正确的错误处理模式
• Streaming — 实时 streaming 响应
• Tool Use — 实现 function calling 和工具调用
• API Key 管理 — 程序化创建和管理 API key
• OAuth — 用户面向应用的 PKCE 认证流程

使用示例

安装后直接用自然语言描述需求：

"帮我在项目里配置 OpenRouter"

助手会生成：

import OpenRouter from '@openrouter/sdk';

const client = new OpenRouter();

const completion = await client.chat.send({
  model: 'anthropic/claude-sonnet-4',
  messages: [
    { role: 'user', content: 'Hello!' }
  ]
});

"给我的 OpenRouter 调用加上 streaming"

助手了解 streaming API：

import OpenRouter from '@openrouter/sdk';

const client = new OpenRouter();

const stream = await client.chat.send({
  model: 'anthropic/claude-sonnet-4',
  messages: [{ role: 'user', content: 'Tell me a story' }],
  stream: true
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? '');
}

需要更高级的 agent 功能（多轮循环、工具定义、stop conditions），请参阅 Agent SDK 文档。

Skill 仓库

Skill 源码：github.com/OpenRouterTeam/skills

欢迎提交贡献和反馈。

常见问题

Q: 这个 skill 和 Agent SDK 的 skill 是同一个吗？

A: 是的，openrouter-typescript-sdk skill 同时覆盖 Client SDK 和 Agent SDK。当你需要 Client SDK 功能时，助手会聚焦于 @openrouter/sdk 的平台 API；当你需要 agent 功能时，助手会使用 @openrouter/agent。

Q: skill 包含哪个版本的 SDK 文档？

A: skill 仓库会随 SDK 更新同步，重新运行安装命令可获取最新版本。

Q: Python 或 Go 的 Client SDK 有对应 skill 吗？

A: 目前官方 skill 主要覆盖 TypeScript。Python 和 Go SDK 可参考各自的官方文档，或直接询问助手相关 API 的使用方式。