Skip to content

feat(openai-docs): add OpenAI Docs plugin #253

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
amondnet wants to merge 4 commits into
base: main
Choose a base branch
from
Open

feat(openai-docs): add OpenAI Docs plugin #253

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
e6441aa
feat(openai-docs): add OpenAI Docs plugin
amondnet Jul 7, 2026
858b6a1
fix(openai-docs): validate CLI-supplied path in latest-model resolver
amondnet Jul 7, 2026
f188a6d
chore(openai-docs): exclude vendored openai-docs skill from Codacy
amondnet Jul 7, 2026
3e5417a
chore(openai-docs): apply AI code review suggestions
amondnet Jul 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions .agents/plugins/marketplace.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -556,6 +556,18 @@
},
"category": "Tooling"
},
{
"name": "openai-docs",
"source": {
"source": "local",
"path": "./plugins/openai-docs"
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Tooling"
},
{
"name": "semble",
"source": {
Expand Down
20 changes: 20 additions & 0 deletions .claude-plugin/marketplace.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -761,6 +761,26 @@
"tags": ["mcp", "web"],
"source": "./plugins/fetch"
},
{
"name": "openai-docs",
"description": "Authoritative, current guidance from official OpenAI developer docs, model selection, and model/prompt migration — backed by the OpenAI Developer Docs MCP server.",
"category": "tooling",
"keywords": ["openai", "docs", "mcp", "model-selection", "api"],
"tags": ["mcp", "docs"],
"source": "./plugins/openai-docs",
"relevance": {
"topic": "OpenAI docs",
"signals": {
"hosts": ["developers.openai.com", "platform.openai.com", "api.openai.com"],
"manifestDeps": [
{
"file": "[/\\\\]package\\.json$",
"pattern": "\"openai\"\\s*:"
}
]
}
}
},
{
"name": "claude-code-docs",
"description": "Fetch Claude Code docs as markdown - rewrites code.claude.com/docs page URLs to their .md source before WebFetch runs",
Expand Down
1 change: 1 addition & 0 deletions .codacy.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,5 @@
# so exclude it from Codacy static analysis.
exclude_paths:
- "plugins/skillopt-sleep/skillopt_sleep/**"
- "plugins/openai-docs/skills/openai-docs/**"
- "external-plugins/**"
5 changes: 5 additions & 0 deletions .cursor-plugin/marketplace.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -194,6 +194,11 @@
"source": "./plugins/fetch",
"description": "Fetch web content in multiple formats - HTML, JSON, plain text, Markdown, readable articles, and YouTube transcripts"
},
{
"name": "openai-docs",
"source": "./plugins/openai-docs",
"description": "Authoritative, current guidance from official OpenAI developer docs, model selection, and model/prompt migration — backed by the OpenAI Developer Docs MCP server."
},
{
"name": "semble",
"source": "./plugins/semble",
Expand Down
1 change: 1 addition & 0 deletions .release-please-manifest.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,7 @@
"plugins/claude-md-management": "1.1.0",
"plugins/cubic": "1.1.0",
"plugins/fetch": "1.2.0",
"plugins/openai-docs": "1.0.0",
"plugins/java-development": "1.1.0",
"plugins/mcp-dev": "1.1.0",
"plugins/vercel-sandbox": "1.2.0",
Expand Down
6 changes: 6 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -382,6 +382,12 @@ Fetch web content in multiple formats - HTML, JSON, plain text, Markdown, readab

**Install:** `/plugin install fetch@pleaseai` | **Source:** [plugins/fetch](https://github.com/pleaseai/claude-code-plugins/tree/main/plugins/fetch)

#### OpenAI Docs

Authoritative, current guidance from official OpenAI developer docs, model selection, and model/prompt migration - backed by the OpenAI Developer Docs MCP server.

**Install:** `/plugin install openai-docs@pleaseai` | **Source:** [plugins/openai-docs](https://github.com/pleaseai/claude-code-plugins/tree/main/plugins/openai-docs)

#### Java Development
[![tessl](https://img.shields.io/endpoint?url=https%3A%2F%2Fapi.tessl.io%2Fv1%2Fbadges%2Fpleaseai%2Fjava-development)](https://tessl.io/registry/pleaseai/java-development)

Expand Down
25 changes: 25 additions & 0 deletions plugins/openai-docs/.claude-plugin/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
{
"name": "openai-docs",
"version": "1.0.0",
"description": "Authoritative, current guidance from official OpenAI developer docs, model selection, and model/prompt migration — backed by the OpenAI Developer Docs MCP server.",
"author": {
"name": "OpenAI",
"url": "https://github.com/openai/codex"
},
"homepage": "https://developers.openai.com",
"repository": "https://github.com/openai/codex",
"license": "Apache-2.0",
"keywords": [
"openai",
"docs",
"mcp",
"model-selection",
"api"
],
"mcpServers": {
"openaiDeveloperDocs": {
"type": "http",
"url": "https://developers.openai.com/mcp"
}
}
}
Comment on lines +1 to +25

@coderabbitai coderabbitai Bot Jul 7, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Wire the new skill bundle into the Claude manifest.

skills/openai-docs/SKILL.md is added, but this manifest never sets skills, so the multi-format pipeline won't surface the skill in downstream manifests. Add the skills/openai-docs entry here before regenerating the derived files. Based on learnings from scripts/multi-format.ts, skills is the input the generator uses to emit the downstream skill path.

🤖 Prompt for AI Agents 
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/openai-docs/.claude-plugin/plugin.json` around lines 1 - 25, The
Claude manifest for openai-docs is missing the skills entry, so the new skill
bundle will not be included in generated downstream manifests. Update the plugin
manifest in the openai-docs plugin to add the skills/openai-docs path in the
skills list, using the existing manifest structure and the multi-format
generator expectations from scripts/multi-format.ts, then regenerate the derived
files so the new SKILL.md is surfaced correctly.

34 changes: 34 additions & 0 deletions plugins/openai-docs/.codex-plugin/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
{
"name": "openai-docs",
"version": "1.0.0",
"description": "Authoritative, current guidance from official OpenAI developer docs, model selection, and model/prompt migration — backed by the OpenAI Developer Docs MCP server.",
"author": {
"name": "OpenAI",
"url": "https://github.com/openai/codex"
},
"interface": {
"displayName": "Openai Docs",
"shortDescription": "Authoritative, current guidance from official OpenAI developer docs, model selection, and model/prompt migration — backed by the OpenAI Developer Docs MCP se...",
"longDescription": "Authoritative, current guidance from official OpenAI developer docs, model selection, and model/prompt migration — backed by the OpenAI Developer Docs MCP server.",
"developerName": "OpenAI",
"category": "Tooling",
"capabilities": [
"Tool"
],
"defaultPrompt": [
"Use Openai Docs for my current task."
],
"websiteURL": "https://developers.openai.com"
},
"homepage": "https://developers.openai.com",
"repository": "https://github.com/openai/codex",
"license": "Apache-2.0",
"keywords": [
"openai",
"docs",
"mcp",
"model-selection",
"api"
],
"mcpServers": "./.mcp.json"
}
30 changes: 30 additions & 0 deletions plugins/openai-docs/.cursor-plugin/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
{
"name": "openai-docs",
"displayName": "Openai Docs",
"description": "Authoritative, current guidance from official OpenAI developer docs, model selection, and model/prompt migration — backed by the OpenAI Developer Docs MCP server.",
"version": "1.0.0",
"author": {
"name": "OpenAI"
},
"category": "Tooling",
"homepage": "https://developers.openai.com",
"repository": "https://github.com/openai/codex",
"license": "Apache-2.0",
"keywords": [
"openai",
"docs",
"mcp",
"model-selection",
"api"
],
"tags": [
"mcp",
"docs"
],
"mcpServers": {
"openaiDeveloperDocs": {
"type": "http",
"url": "https://developers.openai.com/mcp"
}
}
}
8 changes: 8 additions & 0 deletions plugins/openai-docs/.mcp.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"mcpServers": {
"openaiDeveloperDocs": {
"type": "http",
"url": "https://developers.openai.com/mcp"
}
}
}
14 changes: 14 additions & 0 deletions plugins/openai-docs/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# openai-docs

Authoritative, current guidance from official OpenAI developer docs, model selection, and model/prompt migration — backed by the OpenAI Developer Docs MCP server (`https://developers.openai.com/mcp`).

**Install:** `/plugin install openai-docs@pleaseai`

## What's included

- **`openai-docs` skill** — activates on OpenAI docs questions, model-selection and "latest model" queries, and model/prompt upgrade requests. Prefers official OpenAI docs via MCP, with bundled fallback references.
- **`openaiDeveloperDocs` MCP server** — remote HTTP server exposing `search_openai_docs`, `fetch_openai_doc`, `list_openai_docs`, and `get_openapi_spec`.

## Notes

- The skill is adapted from OpenAI's `openai-docs` skill sample (Apache-2.0, see `skills/openai-docs/LICENSE.txt`). Codex-agent-specific content (the Codex manual helper and `codex mcp add` install steps) has been removed for Claude Code; the `openaiDeveloperDocs` MCP server is provided by this plugin, so no manual install is required.
8 changes: 8 additions & 0 deletions plugins/openai-docs/mcp_config.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"mcpServers": {
"openaiDeveloperDocs": {
"type": "http",
"url": "https://developers.openai.com/mcp"
}
}
}
19 changes: 19 additions & 0 deletions plugins/openai-docs/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
{
"name": "openai-docs",
"version": "1.0.0",
"description": "Authoritative, current guidance from official OpenAI developer docs, model selection, and model/prompt migration — backed by the OpenAI Developer Docs MCP server.",
"author": {
"name": "OpenAI",
"url": "https://github.com/openai/codex"
},
Comment thread
amondnet marked this conversation as resolved.
"homepage": "https://developers.openai.com",
"repository": "https://github.com/openai/codex",
"license": "Apache-2.0",
"keywords": [
"openai",
"docs",
"mcp",
"model-selection",
"api"
]
}
Loading
Loading