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 只是一个包含SKILL.md 的文件夹，开头是 YAML frontmatter：
skills/ 文件夹（或任意子集）放入您的运行时所监视的路径。
- Claude Code
- Cursor
- Codex
- OpenCode
- Hermes Agent
- Cline
项目本地：或全局，为机器上每个项目使用：
路径参考
作为 git 子模块
如果您希望在自己的仓库中锁定版本：Agent 如何加载
agent 通过每个SKILL.md 的 frontmatter name 和 description 发现它。当用户提出与某 skill 用途匹配的内容时，agent 只将该文件加载到上下文中（而不是整个目录），因此 prompt 保持精简，回答保持准确。
例如，需要生成音乐的 agent 将加载 venice-audio-music 并立即知道：
- 音乐通过 queue/retrieve/complete 生命周期，而不是同步端点
- 哪些模型可用以及它们的每分钟定价
- 如何先调用
/audio/quote进行成本估算 - 轮询退避应该是什么样
/audio/speech 并得到无用的响应。
编写新 skill
- 将
template/复制到skills/<your-skill>/。 - 填写 frontmatter 和正文。
description要具体，因为它是 agent 决定何时加载 skill 的依据。 - 在底部链接相关 skill，便于交叉导航。
- 向
veniceai/skills提交 PR。
CONTRIBUTING.md（简短首段、明确的端点表格、curl + 一个 SDK 示例、“陷阱”小节、≤ 500 行）。
资源
GitHub
源代码、贡献指南和 skill 模板
Venice MCP Server
将 skill 与官方 MCP 服务器搭配以获得运行时工具访问
Agent Skills 规范
了解底层格式
Venice API 规范
这些 skill 所派生的 OpenAPI 单一来源