Improve skill discovery metadata

Author: gaoguobin

.codex-plugin/plugin.json

@@ -0,0 +1,49 @@
+{
+  "name": "codex-fast-proxy",
+  "version": "0.1.0",
+  "description": "Codex App Fast/Priority proxy for third-party OpenAI-compatible Responses API providers.",
+  "author": {
+    "name": "gaoguobin",
+    "url": "https://github.com/gaoguobin"
+  },
+  "homepage": "https://github.com/gaoguobin/codex-fast-proxy#readme",
+  "repository": "https://github.com/gaoguobin/codex-fast-proxy",
+  "license": "MIT",
+  "keywords": [
+    "agent-skills",
+    "codex",
+    "openai-codex",
+    "codex-skill",
+    "skills",
+    "ai-agents",
+    "responses-api",
+    "fast-mode",
+    "service-tier",
+    "openai-compatible-api"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Codex Fast Proxy",
+    "shortDescription": "Fast/Priority proxy for Codex App with third-party APIs.",
+    "longDescription": "Manage a local, safety-bounded proxy and Agent Skill so Codex App users on third-party OpenAI-compatible API providers can enable, verify, benchmark, update, and uninstall the Fast/Priority path.",
+    "developerName": "gaoguobin",
+    "category": "Developer Tools",
+    "capabilities": [
+      "Local workflow",
+      "Proxy management",
+      "Benchmark"
+    ],
+    "websiteURL": "https://github.com/gaoguobin/codex-fast-proxy",
+    "privacyPolicyURL": "https://github.com/gaoguobin/codex-fast-proxy#safety-model",
+    "termsOfServiceURL": "https://github.com/gaoguobin/codex-fast-proxy/blob/main/LICENSE",
+    "defaultPrompt": [
+      "Enable Codex Fast proxy.",
+      "Show Codex Fast proxy status.",
+      "Run Codex Fast proxy benchmark."
+    ],
+    "brandColor": "#10A37F",
+    "screenshots": [
+      "./docs/assets/dashboard.png"
+    ]
+  }
+}

README.md

@@ -11,7 +11,7 @@ proxy fills only that missing field, keeps streaming untouched, and gives users
 a read-only dashboard to verify real traffic and benchmark whether their
 provider actually benefits from the priority lane.
 
-[Chinese](#chinese) · [Install](#install) · [Dashboard](#dashboard) · [Benchmark](#benchmark) · [Change Upstream](#change-upstream) · [Update](#update) · [Uninstall](#uninstall) · [Safety](#safety-model) · [Sponsor](#sponsor)
+[Chinese](#chinese) · [Agent Skill](#agent-skill-and-discovery) · [Install](#install) · [Dashboard](#dashboard) · [Benchmark](#benchmark) · [Change Upstream](#change-upstream) · [Update](#update) · [Uninstall](#uninstall) · [Safety](#safety-model) · [Sponsor](#sponsor)
 
 ![Codex Fast Proxy dashboard](docs/assets/dashboard.png)
 
@@ -44,6 +44,35 @@ the proxy.
   `service_tier="priority"`.
 - PackyAPI Fast / priority has been verified end to end.
 
+## Agent Skill and Discovery
+
+This repository includes an Agent Skill for Codex:
+
+- Skill name: `codex-fast-proxy`
+- Skill path: `skills/codex-fast-proxy/SKILL.md`
+- Primary use case: let Codex App users on third-party OpenAI-compatible API providers enable,
+  verify, benchmark, update, and uninstall the Fast / Priority path.
+- Safety boundary: the proxy only handles `POST /v1/responses`, injects
+  `service_tier="priority"` only when that field is absent, and leaves `model`, `reasoning`,
+  `tools`, `input`, request bodies, and streaming SSE frames otherwise unchanged.
+- Benchmark: run `python -m codex_fast_proxy benchmark` or ask Codex to run the A/B benchmark.
+  The dashboard shows the latest saved redacted benchmark summary.
+
+Tools that index public GitHub repositories for Agent Skills can discover the skill at the path
+above. This project does not claim to be listed on SkillsMP or any other marketplace, and it is not
+an official OpenAI plugin or official marketplace project.
+
+## Plugin Readiness
+
+Codex documentation describes Skills as the reusable workflow authoring format and Plugins as the
+installable distribution unit for reusable skills and apps. This repository now includes
+`.codex-plugin/plugin.json` metadata that points to `./skills/` so future Codex plugin tooling can
+identify the bundled skill.
+
+Current supported installation is still the Codex-managed flow in [Install](#install). The plugin
+metadata is preparatory discovery/packaging metadata only; it does not install hooks, change
+provider config, start the proxy, or imply an official marketplace listing.
+
 ## Install
 
 Paste this into Codex:
@@ -309,6 +338,31 @@ Codex App 发送 `POST /v1/responses` 时可能没有 `service_tier` 字段，
 由 Codex 读取自己的 provider 配置，proxy 只补缺失的 Fast 参数，并通过本地只读 dashboard 展示
 状态、最近请求和 benchmark 结果，方便确认 App 是否真的走到了 priority 通道。
 
+### Agent Skill 和可发现性
+
+这个仓库包含一个 Codex Agent Skill：
+
+- Skill 名称：`codex-fast-proxy`
+- Skill 路径：`skills/codex-fast-proxy/SKILL.md`
+- 用途：让使用第三方 OpenAI-compatible API provider / 中转站的 Codex App 用户，也能启用、检查、
+  benchmark、更新和卸载 Fast / Priority 路径。
+- 安全边界：proxy 只处理 `POST /v1/responses`，只在缺失 `service_tier` 时注入
+  `service_tier="priority"`，不改 `model`、`reasoning`、`tools`、`input`，也不改 SSE 流。
+- Benchmark：运行 `python -m codex_fast_proxy benchmark`，或直接让 Codex 跑 A/B benchmark。
+  dashboard 会只读展示最近一次已保存的脱敏 benchmark 摘要。
+
+会索引公开 GitHub 仓库中 Agent Skills 的工具，可以通过上面的路径发现这个 skill。本项目不声称
+已经被 SkillsMP 或其它 marketplace 收录，也不声称是 OpenAI 官方 plugin 或官方 marketplace 项目。
+
+### Plugin readiness
+
+Codex 官方文档把 Skill 定义为可复用 workflow 的 authoring format，把 Plugin 定义为可安装的分发单元。
+当前仓库已经包含 `.codex-plugin/plugin.json` 元数据，并指向 `./skills/`，方便后续按 Codex plugin
+分发格式整理。
+
+当前正式支持的安装方式仍然是下面的 Codex-managed 安装流程。这个 plugin metadata 只是为发现和后续
+打包做准备，不会安装 hook、不会改 provider config、不会启动 proxy，也不代表已经进入官方 marketplace。
+
 ### 快速安装
 
 把这句话贴给 Codex：

pyproject.toml

@@ -5,18 +5,36 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "codex-fast-proxy"
 version = "0.1.0"
-description = "Local Codex App proxy that injects service_tier=priority for Responses API calls."
+description = "Codex App Fast/Priority proxy for third-party OpenAI-compatible Responses API providers."
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = []
 license = { text = "MIT" }
+keywords = [
+    "agent-skills",
+    "codex",
+    "openai-codex",
+    "codex-skill",
+    "skills",
+    "ai-agents",
+    "responses-api",
+    "fast-mode",
+    "service-tier",
+    "openai-compatible-api",
+]
 classifiers = [
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
     "Operating System :: OS Independent",
 ]
 
+[project.urls]
+Homepage = "https://github.com/gaoguobin/codex-fast-proxy#readme"
+Repository = "https://github.com/gaoguobin/codex-fast-proxy"
+Issues = "https://github.com/gaoguobin/codex-fast-proxy/issues"
+Documentation = "https://github.com/gaoguobin/codex-fast-proxy#readme"
+
 [project.scripts]
 codex-fast-proxy = "codex_fast_proxy.manager:main"
 

skills/codex-fast-proxy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: codex-fast-proxy
-description: Installs, enables, checks, benchmarks, changes upstream URL, stops, or uninstalls Codex App Fast proxy. Use when the user asks for Codex App Fast, priority service_tier, PackyAPI Fast, provider acceleration, Fast/Priority A/B benchmark, or says phrases like "启用 Codex Fast proxy", "让 Codex App 使用 Fast", "跑 Fast proxy benchmark", "验证供应商是否支持 Fast", "把 Codex Fast proxy 的上游切到", "查看 Fast proxy 状态", or "停止 Codex Fast proxy".
+description: Codex App Fast proxy for third-party OpenAI-compatible APIs. Enables, checks, benchmarks, changes upstream, stops, or uninstalls a local Responses API proxy that injects priority service_tier.
 ---
 
 Use this skill when the user wants Codex to manage the local Fast proxy for Codex App.