Agent Skill · AI 工具

validate-openapi-spec（验证 openapi 规范）

用于辅助 API 设计、接口文档、请求响应结构和服务集成说明。它适合让 Agent 梳理 endpoint、生成 OpenAPI 草稿、检查字段命名、整理错误码或辅助前后端联调。使用时需要确认真实业务语义、鉴权方式、分页和错误处理规则；涉及生成接口文档时，应避免凭空补字段，最好从现有代码、schema 或接口样例中提取事实。

validate-openapi-spec 是AI 工具类 Agent Skill，可用宿主为 Codex、Claude、Cursor、Gemini CLI，通过GitHub 仓库获取，权限为需要联网；许可证为 MIT，暂无第三方扫描结果，按安装量在AI 工具类的 2,536 个 Skill 里排第 2,423。

总安装 212周安装 9GitHub Stars 11下载 74核验 2026-05-01

AI 工具需要联网 GitHub 仓库未标认证来源可访问许可证明确审计未展示Codex Claude Cursor Gemini CLI

安装说明

本站只整理中文说明，不托管安装包，也不代用户安装。

GitHub

许可证: MIT

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手，先确认命令和权限，再让它执行。

请帮我安装这个 Agent Skill：validate-openapi-spec（验证 openapi 规范）
来源仓库：https://github.com/speakeasy-api/agent-skills
仓库路径：skills/validate-openapi-spec
安装命令：
npx skills add https://github.com/speakeasy-api/agent-skills --skill validate-openapi-spec
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

复制命令到本机终端执行。不同来源提供的安装方式可能略有差异；本站展示可直接复制的安装命令，安装前请核对来源页面。

skills.shnpx skills

npx skills add https://github.com/speakeasy-api/agent-skills --skill validate-openapi-spec

这个 Skill 是做什么的

AI 工具类 Skill 用来扩展助手本身的能力，例如接模型、接检索、接外部服务。

validate-openapi-spec 校验 OpenAPI 规范文件的语法和结构正确性。适用于前后端协作开发中统一接口定义的标准化流程。可检测必填字段缺失、引用错误或版本兼容性问题。规范版本差异可能导致误报，建议使用对应版本的校验器。

适用宿主包括 Codex、Claude、Cursor、Gemini CLI，接入前应确认版本、权限和运行环境要求。

来源仓库内路径：skills/validate-openapi-spec

上手步骤

4 步

1
确认自己的宿主工具
公开资料标注支持 Codex、Claude、Cursor、Gemini CLI；先确认自己用的是其中之一，再按对应工具的 Skills 目录放置。
2
拿到安装命令
可以直接复制的命令是 npx skills add https://github.com/speakeasy-api/agent-skills --skill validate-op…；命令里的占位符换成自己的路径或密钥再执行。
3
安装后重启宿主
命令执行完要完全退出宿主工具再打开，让新装的 Skill 被重新扫描到，否则列表里可能看不到。
4
按最小权限试用
它需要需要联网，先在测试目录或测试账号里跑，确认没问题再放到正式项目。

常见问题

6 条

validate-openapi-spec 怎么安装？

在终端执行 npx skills add https://github.com/speakeasy-api/agent-skills --skill validate-openapi-spec。装完完全退出宿主工具再打开，让它重新扫描本地 Skill。

validate-openapi-spec 支持哪些 AI 工具？

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录，一般也能手动放进去，但要自己确认触发方式是否一致。

validate-openapi-spec 需要什么权限？

权限级别是需要联网。该 Skill 可能需要联网访问来源站点、仓库或外部 API；具体网络访问范围需要结合源码和 README 复核。

validate-openapi-spec 是免费的吗？

来源标注的许可证是 MIT。本站不代收任何费用，也不托管安装包；能否商用、要不要署名，以许可证原文为准。

validate-openapi-spec 用的人多吗？

公开数据是累计安装 212 次，近一周安装 9 次，下载 74 次，GitHub 11 星。这些数字来自第三方目录统计，只能当作热度参考，不代表质量或安全性。

validate-openapi-spec 安全吗？

没有查到第三方扫描结果，安全性无法从公开资料判断，安装前请自行审查源码、依赖和命令行为。

值得选的地方和要先想清楚的地方

值得选的地方

同时适配 4 种工具，换客户端不用重新找替代品。
3 个目录同时收录，说明这个 Skill 流传比较广。
许可证明确为 MIT，商用和分发边界好判断。

先想清楚的地方

没有第三方扫描结果，安全性只能靠自己读源码判断。
第三方目录整理，版本更新和行为细节以来源仓库为准。

适不适合你

更适合

已经在用 Codex，想直接扩展它能力的人。
需要处理AI 工具类任务、又不想每次都手写提示词的人。

不太适合

要求有安全扫描结论才肯安装的团队。
需要厂商级技术支持和 SLA 的生产系统。

AI 工具类 Skill 对比

6 个同类

Skill	总安装	GitHub 星	权限	许可证	扫描
executing-plans 执行计划 · Codex、Claude	1,515,336	173,110	只读	MIT	通过
verification-before-completion 完成前的验证 · Codex、Claude	1,319,472	173,121	权限未标注	MIT	通过
subagent-driven-development 子 Agent 驱动开发 · Codex、Claude	1,312,416	173,138	只读	MIT	通过
copy-editing 复制编辑 · Codex、Claude	1,209,576	25,632	只读	MIT	通过
paywall-upgrade-cro 付费专区升级 cro · Codex、Claude	1,030,176	25,617	只读	MIT	通过
validate-openapi-spec 验证 openapi 规范 · 本页	212	11	需要联网	MIT	未收录

按安装量取同分类前几名；数字来自第三方目录统计，只作热度参考，不代表质量结论。

SKILL.md 原文

validate-openapi-spec

Use speakeasy lint to check for errors and warnings in your OpenAPI spec.

When to Use

Checking if a spec is valid before generation
Identifying errors blocking SDK generation
User says: "validate spec", "lint spec", "is my spec valid"

Inputs

Input	Required	Description
OpenAPI spec	Yes	Path to spec file (`-s`)

Outputs

Output	Description
Errors	Issues that block SDK generation
Warnings	Issues that may cause problems
Hints	Best practice suggestions

Command

speakeasy lint openapi --non-interactive -s <path-to-spec>

Output Categories

Severity	Meaning	Action
Error	Blocks SDK generation	Must fix
Warning	May cause issues	Should fix
Hint	Best practice suggestion	Consider fixing

Common Validation Issues

Issue	Solution
Missing operationId	Add operationId or use `speakeasy suggest operation-ids`
Invalid $ref	Fix the reference path
Missing response schema	Add response schema definitions
Duplicate operationId	Make operation IDs unique

AI-Friendly Output

For commands with large outputs, pipe to grep or tail to reduce context:

speakeasy lint openapi --non-interactive -s ./openapi.yaml 2>&1 | grep -E "(error|warning)"

What NOT to Do

Do NOT fix errors one-by-one without understanding root cause
Do NOT ignore warnings - they often indicate real problems
Do NOT modify the source spec without asking if it's externally managed

Troubleshooting

Error	Cause	Solution
"file not found"	Invalid spec path	Check the file path exists
Many duplicate errors	Shared schema issues	Fix the root schema, not each reference
"$ref not found"	Broken reference	Check the reference path matches actual location

Related Skills

diagnose-generation-failure - When lint errors cause generation to fail
fix-validation-errors-with-overlays - Fix issues without modifying source spec
get-ai-suggestions - Get AI-powered suggestions for improvements

平台分布

Claude Code

28.18%

按下载量换算21

Antigravity

22.22%

按下载量换算16

Codex

18%

按下载量换算13

OpenCode

13%

按下载量换算10

windsurf

9.13%

按下载量换算7

Gemini CLI

3.68%

按下载量换算3

安全审计

暂无安全审计结果可展示。

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API；具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。

继续浏览同类 Skills

更多AI 工具 Skills（2,536）返回 Skills 目录

上一个 Skill

utm-parameter-generator（utm 参数生成器）

onewave-ai/claude-skills

utm-parameter-generator 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息，适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

下一个 Skill

varg-video-generation（Varg 视频生成）

varghq/skills

用于辅助视频生成、动画合成、脚本化剪辑或 Remotion 等视频项目开发。它适合让 Agent 组织镜头、生成素材说明、维护合成代码或排查渲染问题。使用时需要确认分辨率、时长、素材路径和导出格式；涉及外部素材、人物肖像或商业发布时，应先核对版权授权和内容审核要求。