Agent skill

Codex Proxy RS Development Guide

by zyycn in zyycn/codex-proxy-rs

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.

Apache-2.0Auto-check passedDevelopment

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

Install Codex Proxy RS Development Guide

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

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

GitHub CLI
$ gh skill install zyycn/codex-proxy-rs cpr-dev-guide --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-dev-guide .claude/skills/cpr-dev-guide && 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-dev-guide
GitHub stars
738
Token cost
~618 tokens
SKILL.md length
82 words
Files
4 (incl. references)
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

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.

  • Works in 4 steps: 确认工作区、任务范围与已有改动,先定位事实归属、同类实现和调用链,再修改;编码前只… → 自审完整差异,处理本次引入的职责越界、重复规则、冗余状态与无依据分支;仅审查时报告… → 按变更范围读取验证,区分通过、失败、跳过与未执行;提交时补读提交约定 → …
  • Starting development, troubleshooting or a code review on the Codex Proxy RS repository
  • SKILL.md covers 加载边界, 按任务读取, 参考仓库的优先级 and 执行与收尾, plus 2 more sections
  • Calls rg

What it does

This is a navigation skill for a Rust-based self-hosted Codex proxy gateway. A table maps the current task, such as development and troubleshooting, a module or call-chain change, Rust work, page development, API or deployment work, SDK or plugin work, or documentation changes, to the specific sections of CONTRIBUTING.md, docs/architecture.md, docs/theme.md or docs/api.md that actually need reading, rather than the whole file. It tells the agent to locate section boundaries with a regex search before reading a range, and not to assume a document's mention of Rust, Vue, plugins or releases means that whole workflow must be loaded.

It also sets priorities for reference material: when a question touches Codex's own behavior or protocol, the official openai/codex source for the matching version comes first, and a third-party repository only offers investigation clues, never a substitute for official behavior. Closing steps require a self-review of the diff for scope creep and duplicate rules, reading only the verification section that matches the change, and writing a short Chinese file-header comment on every Rust file describing its responsibility.

Documentation edits follow a hard rule that ordinary docs describe the current state only, never a change history, and PR, issue and release tasks route to their own separate skills.

When your agent uses it

  • Starting development, troubleshooting or a code review on the Codex Proxy RS repository
  • Deciding which part of the architecture or contributing docs to read for a given change
  • Writing a Rust file-header comment that follows the repository's convention
  • Checking whether a documentation edit should describe history or only current state

Example prompts

  • “I'm fixing a bug in the account rotation module; tell me which docs sections to read first.”
  • “Review this Rust file and write the required file-header comment for it.”
  • “I changed the API surface; find the matching sections in docs/api.md and the verification commands to run.”

Requirements

  • A checkout of the codex-proxy-rs repository with its AGENTS.md and docs

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. 确认工作区、任务范围与已有改动,先定位事实归属、同类实现和调用链,再修改;编码前只读项目约定的对应条目
  2. 自审完整差异,处理本次引入的职责越界、重复规则、冗余状态与无依据分支;仅审查时报告,不自行修复
  3. 按变更范围读取验证,区分通过、失败、跳过与未执行;提交时补读提交约定
  4. 交付说明实际结果与验证缺口;页面证据和后端生命周期检查按上表执行,不把构建通过当作行为验收

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

    Shell commands in SKILL.md call:

    • rg

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    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 Development Guide loads about 618 tokens when it runs, and up to ~1.4k if it reads all its reference files. Until then it costs about 20 tokens; SKILL.md has 82 words of instructions outside code blocks.

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

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). 82 words, ~618 tokens.

Download SKILL.mdSave it as .claude/skills/cpr-dev-guide/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
cpr-dev-guide
description
Codex Proxy RS 仓库的开发、修复、排障、代码审查和文档修改入口;PR、Issue、插件创作与发版按任务另用对应技能

开发指南

加载边界

  • 遵守已提供的 AGENTS.md,上下文已有的规则不重复读取
  • 下表是条件导航,不是必读清单,只加载当前任务命中的技能与章节,进入新阶段再补读
  • 文档链接带 #章节 不代表读取工具会自动截取内容,先用 rg -n '^#{1,4} ' 文件 找边界,再按范围读取;常规定位不整份加载 CONTRIBUTING、架构、API、主题或全部 references,确需全文审查时再展开
  • 每次补读先明确要解决的未知项,已有资料足够就继续工作;文档提及 Rust、Vue、插件或发布,不等于要加载对应开发流程

按任务读取

当前任务必读的相关部分
开发、排障、代码审查问题与方案依据,需要定位代码时按 AGENTS 的 CodeGraph 约定执行
模块或调用链变更Workspace 边界及所属模块章节,不通读整份架构
Rust 开发或审查$rust-best-practices、所属模块、后端自审,验证时读命令
页面开发$frontend-design、前端职责、文案与信息层级、界面验证;修改已有页面前留存截图,主题算法仅在涉及时读取
接口、部署或迁移分别定位 API、部署、迁移的对应章节
SDK、Runtime、宿主扩展或独立插件插件职责边界;只有创作、排查独立网关插件时使用 cpr-plugin-dev
修改或审查文档文档检查及目标章节,不默认读取代码开发、页面验收或发布流程
普通代码审查审查标准;审查默认只读
PR / Issue / 发版按当前意图选 PR、Issue或发版,普通提交不创建 PR

参考仓库的优先级

  • 涉及 Codex 行为、协议或兼容性时,以官方 openai/codex 对应版本的源码与调用链为第一手资料,先查官方实现
  • 优先使用用户提供或本机已有的官方仓库,核对来源、版本或提交;资料不足时再查官方对应版本的源码、测试与文档
  • 三方仓库只能提供排查线索或实现参考,不能代替官方行为依据;与官方不一致时回到官方源码核实,不直接照搬三方结论
  • 结论注明适用版本或提交,区分官方事实、三方参考与本项目推断;官方证据不足时保留不确定性

执行与收尾

  1. 确认工作区、任务范围与已有改动,先定位事实归属、同类实现和调用链,再修改;编码前只读项目约定的对应条目
  2. 自审完整差异,处理本次引入的职责越界、重复规则、冗余状态与无依据分支;仅审查时报告,不自行修复
  3. 按变更范围读取验证,区分通过、失败、跳过与未执行;提交时补读提交约定
  4. 交付说明实际结果与验证缺口;页面证据和后端生命周期检查按上表执行,不把构建通过当作行为验收

后端注释

  • 每个 Rust 文件顶层使用简短的中文 //! 注释说明文件职责,覆盖生产源码、测试与构建脚本;测试文件说明测试范围或辅助用途,生成文件同步维护生成器
  • 注释不使用中文或英文句号,多句说明按语义分行;保留 URL、版本号、标识符和代码示例中有语义的点号
  • 文件说明聚焦当前功能与职责边界,局部注释解释原因和约束,避免复述代码或记录修改经过

文档硬约束

常规文档只描述当前状态,不写变更历史,这项检查适用于每次开发收尾,不限于专门的文档任务

  • 动笔前确定读者、所属章节与必须说明的当前事实,没有必要就不改文档
  • 有文档差异时执行文档检查,逐段决定保留、改写、删除或移入任务报告,未完成内容审查不能称文档已检查
  • 没有文档差异时只确认现有说明是否失真;普通开发不自动修改 release/notes.md

© 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 3 other files (references) in .agents/skills/cpr-dev-guide of zyycn/codex-proxy-rs.

  • SKILL.md
  • agents/openai.yaml
  • references/documentation.md
  • references/plugin-boundaries.md

Open the folder on GitHubat commit f174320

Compare with similar skills

Codex Proxy RS Development Guide 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 Development Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Codex Proxy RS Development Guide this skillzyycn/codex-proxy-rs738—~618Automated safety check: PassApache-2.0
Deepwiki Rssopaco/deepwiki-rs3.1k—~748Automated safety check: PassMIT
Project Onboarding Guide from Knowledge GraphEgonex-AI/Understand-Anything85k—~1.2kAutomated safety check: PassMIT
Worktrunk Tend CI Guidancemax-sixty/worktrunk8.9k—~6.4kAutomated safety check: PassCustom licence
Change Verification Gatefengshao1227/ccg-workflow5.9k—~511Automated safety check: NotesMIT
Post Draft Reviewagent-substrate/substrate4.5k—~2.8kAutomated safety check: PassApache-2.0

Similar skills

  • Deepwiki Rs

    sopaco/deepwiki-rs

    AI-powered Rust documentation generation engine for comprehensive codebase analysis, C4 architecture diagrams, and automated technical documentation.

    3.1k GitHub stars~748 tokensUpdated 23 days ago
    DevelopmentAuto-check passed
  • Writes an onboarding guide for new team members from a project's existing knowledge graph, after checking that the graph still matches the current commit.

    85k GitHub stars~1.2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Worktrunk Tend CI Guidance

    max-sixty/worktrunk

    Adds Worktrunk-specific rules to the tend CI workflows: Codecov polling, Rust test commands, labels and review criteria for pull requests handled in CI.

    8.9k GitHub stars~6.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Change Verification Gate

    fengshao1227/ccg-workflow

    Analyzes a code diff for documentation sync, test coverage and impact scope, warning when docs or tests lag behind a design-level change or a large edit.

    5.9k GitHub stars~511 tokensUpdated 22 days ago
    DevelopmentAuto-check: notes
  • Post Draft Review

    agent-substrate/substrate

    Posts pull request review findings as GitHub draft (pending) inline comments for a human to edit and submit, instead of publishing them straight to the PR author.

    4.5k GitHub stars~2.8k tokensUpdated today
    DevelopmentAuto-check passed
  • SeekDB Code Review

    oceanbase/seekdb

    Reviews seekdb pull requests and diffs for real defects in correctness, resources, concurrency, security and tests, reporting only Blocker or Major findings.

    3.1k GitHub stars~2.1k tokensUpdated 4 days ago
    DevelopmentAuto-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
  • 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
  • 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.

    738 GitHub stars~449 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 Development Guide

What does Codex Proxy RS Development Guide do?

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. This is a navigation skill for a Rust-based self-hosted Codex proxy gateway.md that actually need reading, rather than the whole file.

When should I use Codex Proxy RS Development Guide?

Codex Proxy RS Development Guide fits situations like: starting development, troubleshooting or a code review on the Codex Proxy RS repository; deciding which part of the architecture or contributing docs to read for a given change; writing a Rust file-header comment that follows the repository's convention; checking whether a documentation edit should describe history or only current state.

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

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

How do I install Codex Proxy RS Development Guide in Codex?

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

Can I use Codex Proxy RS Development Guide 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-dev-guide -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-dev-guide, .gemini/skills/cpr-dev-guide, .github/skills/cpr-dev-guide and .opencode/skills/cpr-dev-guide in your project.

What does Codex Proxy RS Development Guide need to run?

Going by SKILL.md and its folder, Codex Proxy RS Development Guide needs the command-line tools its instructions call (rg). Our summary lists: A checkout of the codex-proxy-rs repository with its AGENTS.md and docs.

Does Codex Proxy RS Development Guide access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Codex Proxy RS Development Guide 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 Development Guide use?

Codex Proxy RS Development Guide 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 Development Guide use?

About 618 tokens (SKILL.md is roughly 2.5k 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 803 tokens, read only when the agent opens those files.

What are the alternatives to Codex Proxy RS Development Guide?

Skills that share tags, products or a category with Codex Proxy RS Development Guide: Deepwiki Rs (sopaco/deepwiki-rs, 3.1k stars), Project Onboarding Guide from Knowledge Graph (Egonex-AI/Understand-Anything, 85k stars), Worktrunk Tend CI Guidance (max-sixty/worktrunk, 8.9k stars) and Change Verification Gate (fengshao1227/ccg-workflow, 5.9k 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 Development Guide?

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.