Community生产力与协作github.com

OpenAI 文档技能

当用户询问如何构建 OpenAI 产品或 API,需要带引用的最新官方文档,或需要选择最新模型、模型升级、提示词升级指导时使用;优先使用 OpenAI 文档 MCP 工具,仅将捆绑引用作为辅助上下文,并将任何回退浏览限制在 OpenAI 官方域名内。

OpenAI 文档技能 是什么?

这项技能用于在用户询问如何基于 OpenAI 产品或 API 进行开发时,提供权威、实时且可引用的官方文档支持。它特别适用于以下场景:需要为特定用例推荐最新模型、在模型升级期间提供迁移指导,或者需要对现有提示词进行优化升级。技能的核心流程是优先通过 MCP 工具调用 OpenAI 官方文档,以获取最准确、最新的信息,并能够附带源引用。只有当 MCP 工具无法满足需求时,才允许回退到网络浏览,但浏览范围严格限定在 `openai.com` 等官方域名内。内置的捆绑参考数据仅作为辅助上下文,在查询官方文档时提供补充理解。该技能支持在 Claude Code、Cursor 等主流 AI 代理平台使用,旨在确保开发者和用户始终基于第一手官方资料进行决策。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/openai/skills/tree/main/skills/openai-docs

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

OpenAI 文档技能 是做什么的?

当用户询问如何构建 OpenAI 产品或 API,需要带引用的最新官方文档,或需要选择最新模型、模型升级、提示词升级指导时使用;优先使用 OpenAI 文档 MCP 工具,仅将捆绑引用作为辅助上下文,并将任何回退浏览限制在 OpenAI 官方域名内。

使用场景

  • 用户询问如何使用 OpenAI API(如 Chat Completions、Embeddings、Fine-tuning 等)
  • 用户需要为某个任务选择最合适的模型(如 GPT-4o、o1、GPT-4 Turbo)
  • 用户正在从旧模型升级到新模型,需要了解变更和迁移步骤
  • 用户希望优化或升级现有的提示词以获得更好效果
  • 用户要求提供带有引文或官方来源的技术指导

工作流程

  1. 分析用户意图:识别用户是否需要文档、模型选择、升级指导或提示词优化。
  2. 优先使用 MCP 工具:首先尝试调用 OpenAI 文档 MCP 工具(如 openai_docs_search、openai_docs_get_page)来获取官方文档。
  3. 处理 MCP 结果:
    • 如果 MCP 工具成功返回结果且包含用户所需信息,使用这些数据生成答案并附上原文引用。
    • 如果 MCP 工具返回的结果不完整或信息不足,可以将捆绑参考数据作为辅助上下文来补充解释,但核心信息仍需以 MCP 官方数据为准。
  4. 回退到浏览:仅在 MCP 工具完全无法获取所需信息,且用户明确需要最新官方文档时才进行回退。回退浏览必须限制在以下 OpenAI 官方域名:
    • platform.openai.com
    • openai.com
    • help.openai.com
    • community.openai.com
    • cookbook.openai.com
  5. 整理回答:始终优先引用官方来源,并明确标注引用出处。如果用户要求提示词升级,在提供官方建议的同时,给出具体的提示词修改示例。

限制说明

  • 不要随意浏览非 OpenAI 官方域名的网站。
  • 不要编造官方文档中不存在的 API 功能或参数。
  • 如果用户询问的内容在官方文档中没有明确记录,应如实告知,并在能力范围内提供基于现有知识的参考建议。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

openai/aspnet-core

Build, review, refactor, or architect ASP.NET Core web applications using current official guidance for .NET web development. Use when working on Blazor Web Apps, Razor Pages, MVC, Minimal APIs, controller-based Web APIs, SignalR, gRPC, middleware, dependency injection, configuration, authentication, authorization, testing, performance, deployment, or ASP.NET Core upgrades.

openai/chatgpt-apps

Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI. Use when Codex needs to design tools, register UI resources, wire the MCP Apps bridge or ChatGPT compatibility APIs, apply Apps SDK metadata or CSP or domain settings, or produce a docs-aligned project scaffold. Prefer a docs-first workflow by invoking the openai-docs skill or OpenAI developer docs MCP tools before generating code.

openai/cli-creator

Build a composable CLI for Codex from API docs, an OpenAPI spec, existing curl examples, an SDK, a web app, an admin tool, or a local script. Use when the user wants Codex to create a command-line tool that can run from any repo, expose composable read/write commands, return stable JSON, manage auth, and pair with a companion skill.

openai/cloudflare-deploy

Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.

openai/develop-web-game

Use when Codex is building or iterating on a web game (HTML/JS) and needs a reliable development + testing loop: implement small changes, run a Playwright-based test script with short input bursts and intentional pauses, inspect screenshots/text, and review console errors with render_game_to_text.

openai/doc

Use when the task involves reading, creating, or editing `.docx` documents, especially when formatting or layout fidelity matters; prefer `python-docx` plus the bundled `scripts/render_docx.py` for visual checks.

openai/figma

Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.

openai/figma-code-connect-components

Connects Figma design components to code components using Code Connect mapping tools. Use when user says "code connect", "connect this component to code", "map this component", "link component to code", "create code connect mapping", or wants to establish mappings between Figma designs and code implementations. For canvas writes via `use_figma`, use `figma-use`.

openai/figma-create-design-system-rules

Generates custom design system rules for the user's codebase. Use when user says "create design system rules", "generate rules for my project", "set up design rules", "customize design system guidelines", or wants to establish project-specific conventions for Figma-to-code workflows. Requires Figma MCP server connection.

openai/figma-create-new-file

Create a new blank Figma file. Use when the user wants to create a new Figma design or FigJam file, or when you need a new file before calling use_figma. Handles plan resolution via whoami if needed. Usage — /figma-create-new-file [editorType] [fileName] (e.g. /figma-create-new-file figjam My Whiteboard)

openai/figma-generate-design

Use this skill alongside figma-use when the task involves translating an application page, view, or multi-section layout into Figma. Triggers: 'write to Figma', 'create in Figma from code', 'push page to Figma', 'take this app/page and build it in Figma', 'create a screen', 'build a landing page in Figma', 'update the Figma screen to match code'. This is the preferred workflow skill whenever the user wants to build or update a full page, screen, or view in Figma from code or a description. Discovers design system components, variables, and styles via search_design_system, imports them, and assembles screens incrementally section-by-section using design system tokens instead of hardcoded values.

openai/figma-generate-library

Build or update a professional-grade design system in Figma from a codebase. Use when the user wants to create variables/tokens, build component libraries, set up theming (light/dark modes), document foundations, or reconcile gaps between code and Figma. This skill teaches WHAT to build and in WHAT ORDER — it complements the `figma-use` skill which teaches HOW to call the Plugin API. Both skills should be loaded together.

openai/figma-implement-design

Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions "implement design", "generate code", "implement component", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.

openai/figma-use

**MANDATORY prerequisite** — you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context — e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

openai/frontend-skill

Use when the task asks for a visually strong landing page, website, app, prototype, demo, or game UI. This skill enforces restrained composition, image-led hierarchy, cohesive content structure, and tasteful motion while avoiding generic cards, weak branding, and UI clutter.

openai/gh-address-comments

Help address review/issue comments on the open GitHub PR for the current branch using gh CLI; verify gh auth first and prompt the user to authenticate if not logged in.

openai/gh-fix-ci

Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions; use `gh` to inspect checks and logs, summarize failure context, draft a fix plan, and implement only after explicit approval. Treat external providers (for example Buildkite) as out of scope and report only the details URL.

openai/hatch-pet

Create, repair, validate, visually QA, and package Codex-compatible animated pets and pet spritesheets from character art, generated images, company or prospect brand cues, or visual references. Use when a user wants a lightweight-worker Codex pet workflow, a non-pixel custom pet style, a prospect or company mascot pet, or a full 8x9 animated pet atlas with transparent unused cells, QA contact sheets, and pet.json packaging. This skill composes the installed $imagegen system skill for visual generation and uses bundled scripts for deterministic spritesheet assembly.

openai/imagegen

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established icon or logo system, or building the visual directly in HTML/CSS/canvas.

openai/jupyter-notebook

Use when the user asks to create, scaffold, or edit Jupyter notebooks (`.ipynb`) for experiments, explorations, or tutorials; prefer the bundled templates and run the helper script `new_notebook.py` to generate a clean starting notebook.

相关技能