Agent skill

Codex Proxy RS Gateway Plugin Development

by zyycn in zyycn/codex-proxy-rs

Guides building, debugging or packaging a standalone gateway plugin for Codex Proxy RS, kept separate from the host runtime, installer or any Vue frontend plugin work.

Apache-2.0Auto-check passedDevelopment

SKILL.md written in Chinese; this summary is our English description.

Install Codex Proxy RS Gateway Plugin Development

skills CLI
$ npx skills add zyycn/codex-proxy-rs --skill cpr-plugin-dev -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install zyycn/codex-proxy-rs cpr-plugin-dev --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/zyycn/codex-proxy-rs.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/cpr-plugin-dev .claude/skills/cpr-plugin-dev && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cpr-plugin-dev
GitHub stars
738
Token cost
~449 tokens
SKILL.md length
55 words
Files
5 (incl. references)
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

Guides building, debugging or packaging a standalone gateway plugin for Codex Proxy RS, kept separate from the host runtime, installer or any Vue frontend plugin work.

  • Writing or debugging a Codex Proxy RS gateway plugin in its own project
  • SKILL.md covers 范围与合同, 按当前步骤读取 and 交付
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Checking a plugin's manifest against the host's compatibility list

What it does

The skill scopes plugin work to its own project, implemented through the public SDK rather than adding dedicated logic to the host's own business modules. It first confirms the plugin's purpose, where it lives, and which host version and platform it targets, checking the SDK version and the host's plugin compatibility list separately from which CLI the plugin assumes.

A manifest declares what the plugin contributes and which bindings control where it mounts and what it matches, but a successful install does not mean the feature works. The current manifest format rejects a permissions field, so an installer fully trusts the plugin: a process marked trustedProcess gets no OS sandbox or access isolation from the host.

Rather than reading every reference up front, the skill routes to one section at a time based on the current step: capability selection, manifest and Rust handler implementation, frontend pages, project setup, build and packaging, verification, and distribution each point to their own reference file or section. Delivery reports only source and artifact locations, compatibility, capabilities actually implemented, and real verification results, and modifying source code does not by itself authorize installing, enabling or publishing it on a real instance.

When your agent uses it

  • Writing or debugging a Codex Proxy RS gateway plugin in its own project
  • Checking a plugin's manifest against the host's compatibility list
  • Packaging or preparing a gateway plugin for distribution

Example prompts

  • “Scaffold a new gateway plugin for Codex Proxy RS and check SDK compatibility.”
  • “Debug why my plugin's manifest fails to activate on the target host version.”
  • “Package this gateway plugin and list what still needs manual verification.”

Requirements

  • A Codex Proxy RS checkout with the gateway-plugin SDK

What it can do on your machine

Read from SKILL.md and the folder at commit f174320. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Codex Proxy RS Gateway Plugin Development loads about 449 tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 26 tokens; SKILL.md has 55 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~26
When it runs · the whole SKILL.md, loaded when a task matches
~449
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from zyycn/codex-proxy-rs at commit f174320, republished under its Apache-2.0 licence (© zyycn). 55 words, ~449 tokens.

Download SKILL.mdSave it as .claude/skills/cpr-plugin-dev/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
cpr-plugin-dev
description
开发、排查或打包 Codex Proxy RS 独立网关插件;仅改宿主 Runtime、安装器或管理端时使用 cpr-dev-guide,不适用于 Codex 插件或 Vue 插件

网关插件开发

插件在独立项目中通过公开 SDK 实现业务,不向宿主业务模块添加专属流程

同时使用 cpr-dev-guide的对应任务分支,已加载则复用,不递归重读

范围与合同

  • 确认用途、工程位置、目标宿主版本与平台,沿用已有工程;位置无法推断时只补齐该信息,不把插件源码塞进宿主 workspace
  • 核对运行宿主、SDK 版本、宿主支持清单及所用 CLI,清单、进程和能力版本分别判断
  • contributes 声明处理器,bindings 选择挂载与匹配范围;安装成功不等于功能生效。当前清单拒绝 permissions,安装者完整信任插件,trustedProcess 不提供操作系统沙箱或访问域隔离,见完整信任
  • 涉及 Codex 时按参考仓库优先级先查官方 Codex 源码,三方仓库仅作参考;宿主能力以目标版本的 SDK 为准

按当前步骤读取

只读取命中行与链接的指定章节,长文档先列标题再截取;不预读全部 SDK、示例、前端和打包资料

当前工作入口
选择能力或确认能力缺口能力与方法、所需能力章节、插件职责边界
清单与 Rust 处理器实现参考、所用 SDK 类型;只有修改清单字段时读清单对应章节
创建或修改页面页面参考,不需要页面的插件不创建前端
准备工程或联调依赖工程与依赖,需要示例时再读复用示例
构建或打包构建与打包
实际验收验证与交付,按实现范围验证
分发插件发布与安装来源,不自动进入宿主发版流程
修改插件文档文档检查,只写当前用法、合同和限制,不附修复过程

交付

说明源码与产物位置、兼容范围、能力与绑定、实际验证及缺口,只报告真正生成的安装包或完成的业务验证

修改源码不默认授权在目标实例安装启用、调用真实上游或发布,沿用用户当前授权判断后续动作

PR 任务才使用 cpr-github-pr,文档检查按开发入口收尾执行

© zyycn, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in .agents/skills/cpr-plugin-dev of zyycn/codex-proxy-rs.

  • SKILL.md
  • agents/openai.yaml
  • references/development.md
  • references/frontend.md
  • references/implementation.md

Open the folder on GitHubat commit f174320

Compare with similar skills

Codex Proxy RS Gateway Plugin Development next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Codex Proxy RS Gateway Plugin Development compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codex Proxy RS Gateway Plugin Development this skillzyycn/codex-proxy-rs738—~449Automated safety check: PassApache-2.0
Pnpm Engineteambit/bit18k—~1.9kAutomated safety check: PassCustom licence
Guarded Git Commit and Pushjerrywu001/cc-sessions-viewer394—~603Automated safety check: NotesMIT
Code Review Excellenceandrew-yangy/gru-ai155—~1.7kAutomated safety check: NotesMIT
Add Tauri Commanddevlint/GitWand180—~1.5kAutomated safety check: PassMIT
Playwright Component Testingmellowagain/gitarena1141 repos~2.6kAutomated safety check: PassMIT

Similar skills

  • Pnpm Engine

    teambit/bit

    Work on the pnpm Rust engine (@pnpm/napi, the pacquet crates) that bit install runs through.

    18k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Guarded Git Commit and Push

    jerrywu001/cc-sessions-viewer

    Commits and pushes only on an explicit request, pulling first, running the project's CI checks locally, and stopping cold on any conflict or failure.

    394 GitHub stars~603 tokensUpdated today
    DevelopmentAuto-check: notes
  • Code Review Excellence

    andrew-yangy/gru-ai

    Provides comprehensive code review guidance for React 19, Vue 3, Rust, TypeScript, Java, Python, and C/C++.

    155 GitHub stars~1.7k tokensUpdated 7 mo ago
    DevelopmentAuto-check: notes
  • Add Tauri Command

    devlint/GitWand

    A skill your agent uses when the user wants to expose a Rust feature to the Vue frontend, add a Tauri IPC command, invoke something from a Vue component, or wire up any backend/frontend…

    180 GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Playwright Component Testing

    mellowagain/gitarena

    Set up component testing with Playwright using a story gallery — scaffold stories and a gallery dev page driven by the built-in mount fixture, no dedicated component-testing runtime.

    114 GitHub starsUsed in 1 repo~2.6k tokens
    Testing & QAAuto-check passed
  • Position Encoding

    pikax/verter

    Position encoding, span types, coordinate systems, path normalization tables for Verter's multi-layer architecture (OXC, Rust, LSP, FFI, VS Code)

    112 GitHub stars~4.6k tokensUpdated today
    DatabasesAuto-check passed

More from zyycn/codex-proxy-rs

  • Drafts, files, supplements and replies to GitHub issues for bugs, feature ideas and project rules, using the target repository's own templates and etiquette.

    738 GitHub stars~484 tokensUpdated yesterday
    Auto-check passed
  • Routes development, troubleshooting, review and documentation tasks on the Codex Proxy RS repository to the right section of its docs, instead of loading the whole architecture or contributing guide.

    738 GitHub stars~618 tokensUpdated yesterday
    Auto-check passed
  • Prepares, creates, updates and reviews GitHub PRs for the codex-proxy-rs repository, including replying to discussions, with a mode-based reading flow and a fixed reply tone.

    738 GitHub stars~450 tokensUpdated yesterday
    Auto-check passed
  • Codex Proxy RS Release

    zyycn/codex-proxy-rs

    Plans versions, writes release notes, publishes stable or pre-release builds and recovers from failed releases for Codex Proxy RS, without covering deploys or tag cleanup.

    738 GitHub stars~327 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Codex Proxy RS Gateway Plugin Development

What does Codex Proxy RS Gateway Plugin Development do?

Guides building, debugging or packaging a standalone gateway plugin for Codex Proxy RS, kept separate from the host runtime, installer or any Vue frontend plugin work. The skill scopes plugin work to its own project, implemented through the public SDK rather than adding dedicated logic to the host's own business modules. It first confirms the plugin's purpose, where it lives, and which host version and platform it targets, checking the SDK version and the host's plugin compatibility list separately from which CLI the plugin assumes.

When should I use Codex Proxy RS Gateway Plugin Development?

Codex Proxy RS Gateway Plugin Development fits situations like: writing or debugging a Codex Proxy RS gateway plugin in its own project; checking a plugin's manifest against the host's compatibility list; packaging or preparing a gateway plugin for distribution.

How do I install Codex Proxy RS Gateway Plugin Development in Claude Code?

Run `npx skills add zyycn/codex-proxy-rs --skill cpr-plugin-dev -a claude-code`. Or copy the skill folder (.agents/skills/cpr-plugin-dev in zyycn/codex-proxy-rs) into .claude/skills/cpr-plugin-dev in your project. Claude Code loads it when a task matches its description.

How do I install Codex Proxy RS Gateway Plugin Development in Codex?

Run `npx skills add zyycn/codex-proxy-rs --skill cpr-plugin-dev -a codex`. Or copy the skill folder (.agents/skills/cpr-plugin-dev in zyycn/codex-proxy-rs) into .agents/skills/cpr-plugin-dev in your project. Codex loads it when a task matches its description.

Can I use Codex Proxy RS Gateway Plugin Development in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add zyycn/codex-proxy-rs --skill cpr-plugin-dev -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cpr-plugin-dev, .gemini/skills/cpr-plugin-dev, .github/skills/cpr-plugin-dev and .opencode/skills/cpr-plugin-dev in your project.

What does Codex Proxy RS Gateway Plugin Development need to run?

SKILL.md names no scripts, command-line tools or credentials: Codex Proxy RS Gateway Plugin Development is instructions for the agent only. Our summary lists: A Codex Proxy RS checkout with the gateway-plugin SDK.

Does Codex Proxy RS Gateway Plugin Development access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Codex Proxy RS Gateway Plugin Development safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Codex Proxy RS Gateway Plugin Development use?

Codex Proxy RS Gateway Plugin Development is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Codex Proxy RS Gateway Plugin Development use?

About 449 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.7k tokens, read only when the agent opens those files.

What are the alternatives to Codex Proxy RS Gateway Plugin Development?

Skills that share tags, products or a category with Codex Proxy RS Gateway Plugin Development: Pnpm Engine (teambit/bit, 18k stars), Guarded Git Commit and Push (jerrywu001/cc-sessions-viewer, 394 stars), Code Review Excellence (andrew-yangy/gru-ai, 155 stars) and Add Tauri Command (devlint/GitWand, 180 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Codex Proxy RS Gateway Plugin Development?

zyycn (a GitHub user) maintains it in zyycn/codex-proxy-rs, which has 738 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 6, 2026.

Source: zyycn/codex-proxy-rs on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.