Agent skill

PR Push

by icebear0828 in icebear0828/codex-proxy

Package the current working changes into a standards-compliant codex-proxy pull request: branch hygiene, commit message linting, CHANGELOG prompt, conventional commit, push, and gh pr create against…

Custom licenceAuto-check: notesDevelopment

Install PR Push

skills CLI
$ npx skills add icebear0828/codex-proxy --skill pr-push -a claude-code

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

GitHub CLI
$ gh skill install icebear0828/codex-proxy pr-push --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/icebear0828/codex-proxy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/pr-push .claude/skills/pr-push && 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
pr-push
GitHub stars
1.8k
Token cost
~2.2k tokens
SKILL.md length
1,200 words
Files
5 (incl. references, assets)
Skills in repo
3
Repo updated
First seen
Licence
Custom licence

At a glance

Package the current working changes into a standards-compliant codex-proxy pull request: branch hygiene, commit message linting, CHANGELOG prompt, conventional commit, push, and gh pr create against…

  • Works in 5 steps: Discovery (interview, do not touch the… → Branch hygiene → Stage + commit → …
  • : user asks to push a PR
  • SKILL.md covers Overview, When to Use, Important Rules and Key Workflows, plus 1 more section
  • Calls git, gh and npm

What it does

PR Push is an agent skill from icebear0828/codex-proxy. Package the current working changes into a standards-compliant codex-proxy pull request: branch hygiene, commit message linting, CHANGELOG prompt, conventional commit, push, and gh pr create against the dev branch. TRIGGER when: user asks to "push a PR", "open a PR", "create PR", "ship this", "推 PR", "开 PR", "提交 PR". DO NOT TRIGGER when: user only wants to commit without pushing; user explicitly wants to push directly to main; user wants to merge, rebase, or close an existing PR (use gh pr merge / gh pr close…

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files and assets (for example `assets/pr-body-template.md`, `references/changelog-format.md` and `references/commit-conventions.md`).

It sits in Development, covering Pull requests, Commit messages and Linting and formatting. It works with Git. The repository describes itself as: OpenAI-compatible proxy for ChatGPT Codex Responses API.

When your agent uses it

  • : user asks to push a PR
  • : user only wants to commit without pushing
  • User explicitly wants to push directly to main
  • User wants to merge

Example prompts

  • “push a PR”
  • “open a PR”
  • “create PR”
  • “/pr-push”

Requirements

  • Node.js
  • Docker
  • Pre-approved tools (allowed-tools): Bash, Read, Edit, Write, Grep

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Discovery (interview, do not touch the repo yet)
  2. Branch hygiene
  3. Stage + commit
  4. Push
  5. Open the PR

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Edit
    • Write
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • gh
    • npm
    • npx
    • docker

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

  • Network

    No URLs in SKILL.md. Its commands use git, gh, npm, npx and docker, which can reach the network depending on how they are called.

    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

PR Push loads about 2.2k tokens when it runs, and up to ~4.1k if it reads all its reference files. Until then it costs about 135 tokens; SKILL.md has 1,200 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Edit, Write, Grep

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,200 words (~2,249 tokens).

“Turn the current working tree into a clean PR targeting dev. This skill enforces codex-proxy's contribution rules so community maintainers do not have to memorize them.”

— opening of SKILL.md by icebear0828, Custom licence
name
pr-push
allowed-tools
Bash, Read, Edit, Write, Grep

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (references, assets) in .agents/skills/pr-push of icebear0828/codex-proxy.

  • SKILL.md
  • assets/pr-body-template.md
  • references/changelog-format.md
  • references/commit-conventions.md
  • references/pr-checklist.md

Open the folder on GitHubat commit fb946da

Compare with similar skills

PR Push 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.

PR Push compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PR Push this skillicebear0828/codex-proxy1.8k—~2.2kAutomated safety check: NotesCustom licence
Git Workflow and Versioningaddyosmani/agent-skills103k2 repos~3.5kAutomated safety check: NotesMIT
Verdaccio Pull Request Workflowverdaccio/verdaccio18k—~1.9kAutomated safety check: PassMIT
Lint Commit PRTresjs/tres3.8k—~1.1kAutomated safety check: PassMIT
Shift Commit Rulesshift-editor/shift347—~1.4kAutomated safety check: NotesApache-2.0
Subwave Release PRperminder-klair/subwave1.4k—~4kAutomated safety check: PassMIT

Similar skills

  • Git Workflow and Versioning

    addyosmani/agent-skills

    Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.

    103k GitHub starsUsed in 2 repos~3.5k tokens
    DevelopmentAuto-check: notes
  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Lint Commit PR

    Tresjs/tres

    Lint local changes, auto-fix, conventional commit, and optionally create PR

    3.8k GitHub stars~1.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Shift Commit Rules

    shift-editor/shift

    Rules for writing git commits in the Shift font editor repo: Conventional Commits subjects, user-facing changelog wording, concise subjects and logical commit boundaries.

    347 GitHub stars~1.4k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Subwave Release PR

    perminder-klair/subwave

    Open a release pull request from develop to main for SUB/WAVE, and keep develop from drifting behind main.

    1.4k GitHub stars~4k tokensUpdated today
    DevelopmentAuto-check passed
  • Git PR Workflow

    andymai/brepjs

    This skill should be used when committing, pushing, branching, or merging in the brepjs repository — when a task involves "pre-commit hook failed" (which tier ran, how to bypass), "commit rejected…

    114 GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed

More from icebear0828/codex-proxy

  • Issue Create

    icebear0828/codex-proxy

    Interview the user to gather all required context, then open a high-quality GitHub issue (gh issue create) on the codex-proxy repo with the right template, labels, and structured body.

    1.8k GitHub stars~1.8k tokensUpdated today
    Auto-check: notes
  • PR Push

    icebear0828/codex-proxy

    Package the current working changes into a standards-compliant codex-proxy pull request: branch hygiene, commit message linting, CHANGELOG prompt, conventional commit, push, and gh pr create against…

    1.8k GitHub stars~2.3k tokensUpdated today
    Auto-check: notes

Works with

Categories

Questions about PR Push

What does PR Push do?

Package the current working changes into a standards-compliant codex-proxy pull request: branch hygiene, commit message linting, CHANGELOG prompt, conventional commit, push, and gh pr create against…. PR Push is an agent skill from icebear0828/codex-proxy. Package the current working changes into a standards-compliant codex-proxy pull request: branch hygiene, commit message linting, CHANGELOG prompt, conventional commit, push, and gh pr create against the dev branch.

When should I use PR Push?

PR Push fits situations like: : user asks to push a PR; : user only wants to commit without pushing; user explicitly wants to push directly to main; user wants to merge.

How do I install PR Push in Claude Code?

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

How do I install PR Push in Codex?

Run `npx skills add icebear0828/codex-proxy --skill pr-push -a codex`. Or copy the skill folder (.agents/skills/pr-push in icebear0828/codex-proxy) into .agents/skills/pr-push in your project. Codex loads it when a task matches its description.

Can I use PR Push 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 icebear0828/codex-proxy --skill pr-push -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pr-push, .gemini/skills/pr-push, .github/skills/pr-push and .opencode/skills/pr-push in your project.

What does PR Push need to run?

Going by SKILL.md and its folder, PR Push needs the command-line tools its instructions call (git, gh, npm, npx and docker). Our summary lists: Node.js; Docker. Its frontmatter pre-approves these tools: Bash, Read, Edit, Write, Grep.

Does PR Push access the network?

SKILL.md contains no URLs. Its commands use git, gh, npm, npx and docker, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is PR Push safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does PR Push use?

PR Push has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does PR Push use?

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

What are the alternatives to PR Push?

Skills that share tags, products or a category with PR Push: Git Workflow and Versioning (addyosmani/agent-skills, 103k stars), Verdaccio Pull Request Workflow (verdaccio/verdaccio, 18k stars), Lint Commit PR (Tresjs/tres, 3.8k stars) and Shift Commit Rules (shift-editor/shift, 347 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PR Push?

icebear0828 (a GitHub user) maintains it in icebear0828/codex-proxy, which has 1,805 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 8, 2026.

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