跳转到主要内容
Venice Skills 是面向 Venice API 的 Agent Skills 的权威集合。每个 skill 是一个自包含文件夹，其中包含 SKILL.md，LLM agent 按需加载它，以便正确操作 API 的特定表面。

GitHub: veniceai/skills

19 个 skill，覆盖完整的 Venice API。MIT 许可。与公开的 swagger.yaml 保持同步。

19 个 Skill

每个 Venice API 表面对应一个

运行时无关

可用于 Claude Code、Cursor、Codex、OpenCode、Hermes、Cline 以及任何其他 Agent Skills 宿主

与规范同步

源自 Venice 的 OpenAPI 规范，并通过 CI 检查漂移

​
为何需要 skills？

没有 skills，您的 agent 就只能费力地自行发现 Venice 的怪癖：venice_parameters、模型类型枚举、402 需付款流程、视频 queue/retrieve 生命周期、character slug 等等。Skills 将这些知识打包到聚焦、按需的文件中，使 agent 只为当前任务加载所需内容。 每个 SKILL.md 包含：
  • 它所覆盖的端点
  • 必需的请求头、参数和响应结构
  • 一个 curl 示例加上一个最小化 SDK 示例
  • 包含真实集成者常踩坑点的”陷阱”小节

​
Skill 目录

Skill覆盖范围
venice-api-overviewBase URL、认证模式、响应头、定价模型、版本管理
venice-authBearer API 密钥 + Sign-In-With-X / x402 钱包身份验证
venice-chat/chat/completions 配合 venice_parameters、多模态、tools、推理、流式
venice-responses/responses，OpenAI 兼容的 Responses API（Alpha）
venice-embeddings/embeddings 模型、编码格式、维度
venice-image-generate/image/generate、/images/generations、/image/styles
venice-image-edit/image/edit、/image/multi-edit、/image/upscale、/image/background-remove
venice-audio-speech/audio/speech TTS 模型、voice、格式、流式
venice-audio-music/audio/quote、/audio/queue、/audio/retrieve、/audio/complete
venice-audio-transcription配合 Whisper、Parakeet、Scribe、Wizper、xAI STT 的 /audio/transcriptions
venice-video/video/* 生成 + 转录
venice-models/models、/models/traits、/models/compatibility_mapping
venice-characters/characters* + venice_parameters.character_slug
venice-api-keysCRUD /api_keys、速率限制、Web3 密钥生成
venice-billing/billing/balance、/billing/usage、/billing/usage-analytics
venice-x402/x402/* 钱包额度，Base 或 Solana 上的 USDC
venice-crypto-rpc/crypto/rpc/* JSON-RPC 代理，1×/2×/4× 定价
venice-augment/augment/text-parser、/augment/scrape、/augment/search
venice-errors错误结构、402 需付款、422 内容政策、429 速率限制、重试策略

​
安装

每个 skill 只是一个包含 SKILL.md 的文件夹，开头是 YAML frontmatter： 
---
name: venice-chat
description: When the agent should load this skill and what's in it
---
将 skills/ 文件夹（或任意子集）放入您的运行时所监视的路径。
项目本地：
git clone https://github.com/veniceai/skills.git
cp -r skills/skills/* .claude/skills/
或全局，为机器上每个项目使用：
git clone https://github.com/veniceai/skills.git ~/src/venice-skills
ln -s ~/src/venice-skills/skills ~/.claude/skills/venice

​
路径参考

运行时项目本地全局
Claude Code.claude/skills/~/.claude/skills/
Codex.codex/skills/~/.codex/skills/（或 $CODEX_HOME/skills/）
OpenCode.opencode/skills/（也包括 .claude/skills/、.agents/skills/）~/.config/opencode/skills/
Hermes Agent$HERMES_OPTIONAL_SKILLS_DIR~/.hermes/skills/
Cursor.cursor/skills/~/.cursor/skills/
Cline.clinerules/skills/n/a
其他运行时.agents/skills/（约定）~/.agents/skills/
定义额外 frontmatter 字段（version、platforms、metadata.*、compatibility 等）的运行时，规范要求其忽略未知字段，因此同一个 skill 文件可在各处工作而无需分叉。

​
作为 git 子模块

如果您希望在自己的仓库中锁定版本： 
git submodule add https://github.com/veniceai/skills.git vendor/venice-skills
然后将所需子集 symlink 或复制到您 agent 的 skill 路径中。

​
Agent 如何加载

agent 通过每个 SKILL.md 的 frontmatter name 和 description 发现它。当用户提出与某 skill 用途匹配的内容时，agent 只将该文件加载到上下文中（而不是整个目录），因此 prompt 保持精简，回答保持准确。 例如，需要生成音乐的 agent 将加载 venice-audio-music 并立即知道：
  • 音乐通过 queue/retrieve/complete 生命周期，而不是同步端点
  • 哪些模型可用以及它们的每分钟定价
  • 如何先调用 /audio/quote 进行成本估算
  • 轮询退避应该是什么样
没有 skill，agent 可能会尝试为音乐调用 /audio/speech 并得到无用的响应。

​
编写新 skill

  1. 将 template/ 复制到 skills/<your-skill>/。
  2. 填写 frontmatter 和正文。description 要具体，因为它是 agent 决定何时加载 skill 的依据。
  3. 在底部链接相关 skill，便于交叉导航。
  4. 向 veniceai/skills 提交 PR。
风格约定请参阅仓库的 CONTRIBUTING.md（简短首段、明确的端点表格、curl + 一个 SDK 示例、“陷阱”小节、≤ 500 行）。

​
资源

GitHub

源代码、贡献指南和 skill 模板

Venice MCP Server

将 skill 与官方 MCP 服务器搭配以获得运行时工具访问

Agent Skills 规范

了解底层格式

Venice API 规范

这些 skill 所派生的 OpenAPI 单一来源