Validating OpenAI API Implementations by bbrowning/bbrowning-claude-marketplace
npx skills add https://github.com/bbrowning/bbrowning-claude-marketplace --skill 'Validating OpenAI API Implementations'此技能提供官方 OpenAI API 规范的综合知识,用于验证实现、回答 API 问题以及审查与 OpenAI 服务集成的代码。
在以下情况下调用此技能:
权威来源 : https://app.stainless.com/api/spec/documented/openai/openapi.documented.yml
此 OpenAPI 规范是所有 OpenAI API 详细信息的唯一真实来源。请务必检查规范中的版本号,以确保您使用的是最新信息。
基础 URL : https://api.openai.com/v1
身份验证 : 基于 API 密钥(Bearer 令牌),使用 ApiKeyAuth 安全方案
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
审查 OpenAI API 实现时,请验证:
Authorization: Bearer {API_KEY}
所有端点遵循以下模式:https://api.openai.com/v1/{category}/{action}
多个端点支持流式处理,用于实时数据交付
进行详细验证时:
OpenAPI YAML 规范是权威来源。最有效的方法是将其下载到本地并直接搜索。
这是搜索 OpenAI API 规范的最有效方法:
将规范下载到本地 :
curl -o openai-spec.yml https://app.stainless.com/api/spec/documented/openai/openapi.documented.yml
使用 Grep 查找 相关术语的所有出现位置:
# 不区分大小写搜索,显示行号和上下文
Grep pattern="MCP" path="openai-spec.yml" output_mode="content" -i=true
使用 Grep 结果中的行号 读取特定部分:
Read file_path="openai-spec.yml" offset=42619 limit=100
根据需要迭代优化搜索,无需网络开销
为何此方法更优:
何时使用此方法:
如果无法在本地下载规范,可以使用 WebFetch,但存在限制:
该规范使用标准的 OpenAPI 结构:
components/schemas/ : 所有类型定义(例如,MCPTool、ChatCompletion)paths/ : 端点定义和操作$ref 引用组件在提示中使用精确的技术术语:
对同一个规范 URL 尝试多个有针对性的提示:
信任权威来源:
避免以下无效模式:
使用以下有效模式:
无效方法:
有效方法:
curl -o openai-spec.yml https://app.stainless.com/api/spec/documented/openai/openapi.documented.ymlGrep pattern="MCP" path="openai-spec.yml" output_mode="content" -i=trueRead file_path="openai-spec.yml" offset=42619 limit=100authorization、headers、server_url 等审查 OpenAI 集成代码时:
要检查某个功能是否存在于 OpenAI API 中:
有关全面的端点详情、请求/响应模式和高级功能,请始终参考官方规范。此技能提供知识框架;规范提供确切的实现细节。
每周安装量
0
代码仓库
GitHub 星标数
1
首次出现时间
1970年1月1日
安全审计
This skill provides comprehensive knowledge of the official OpenAI API specification for validating implementations, answering API questions, and reviewing code that integrates with OpenAI services.
Invoke this skill when:
Authoritative Source : https://app.stainless.com/api/spec/documented/openai/openapi.documented.yml
This OpenAPI specification is the single source of truth for all OpenAI API details. Always check the version number in the specification to ensure you're working with current information.
Base URL : https://api.openai.com/v1
Authentication : API Key-based (Bearer token) using the ApiKeyAuth security scheme
When reviewing OpenAI API implementations, verify:
Authorization: Bearer {API_KEY}
All endpoints follow the pattern: https://api.openai.com/v1/{category}/{action}
Multiple endpoints support streaming for real-time data delivery
For detailed validation:
The OpenAPI YAML specification is the authoritative source. The most effective approach is to download it locally and search it directly.
This is the MOST EFFECTIVE method for searching the OpenAI API spec:
Download the spec locally :
curl -o openai-spec.yml https://app.stainless.com/api/spec/documented/openai/openapi.documented.yml
Use Grep to find all occurrences of relevant terms:
# Case-insensitive search with line numbers and context
Grep pattern="MCP" path="openai-spec.yml" output_mode="content" -i=true
Read specific sections using line numbers from Grep results:
Read file_path="openai-spec.yml" offset=42619 limit=100
Iteratively refine searches as needed without network overhead
Why this works better:
When to use this approach:
If you cannot download the spec locally, WebFetch can be used but has limitations:
The spec uses standard OpenAPI structure:
components/schemas/ : All type definitions (e.g., MCPTool, ChatCompletion)paths/ : Endpoint definitions and operations$ref to componentsUse precise technical terms in prompts:
Try multiple targeted prompts on the SAME spec URL:
Trust the authoritative source :
Avoid these ineffective patterns:
Use these effective patterns:
Ineffective approach:
Effective approach:
curl -o openai-spec.yml https://app.stainless.com/api/spec/documented/openai/openapi.documented.ymlGrep pattern="MCP" path="openai-spec.yml" output_mode="content" -i=trueRead file_path="openai-spec.yml" offset=42619 limit=100authorization, headers, server_url, etc.When reviewing OpenAI integration code:
To check if a feature exists in the OpenAI API:
For comprehensive endpoint details, request/response schemas, and advanced features, always reference the official specification. This skill provides the knowledge framework; the specification provides the exact implementation details.
Weekly Installs
0
Repository
GitHub Stars
1
First Seen
Jan 1, 1970
Security Audits
agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试
138,300 周安装
AI故事板创作指南:使用inference.sh CLI快速生成电影分镜与镜头脚本
7,500 周安装
SEO内容简报工具 - 数据驱动的内容策略与SERP分析指南
7,600 周安装
AI产品摄影指南:使用inference.sh CLI生成专业电商产品图片
7,500 周安装
AI新闻简报策划工具 - 使用inference.sh CLI自动化创建高质量行业简报
7,600 周安装
交互式编程助手 | 基于REPL的系统探索与修改工具 | GitHub Copilot增强插件
7,500 周安装
VS Code 扩展本地化工具 - 快速实现多语言支持(vscode-ext-localization)
7,600 周安装