[DOCS] `/commit-push-pr` configured push-remote auto-allow behavior is undocumented

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/commands

Section/Topic

The built-in skills in the "All commands" table, specifically /commit-push-pr, and the permission implications of its push step.

Current Documentation

The commands reference documents built-in skills such as /batch and /doctor, but contains no entry for /commit-push-pr. The permissions reference explains general Bash rules, including that:

"Bash(git * main) matches commands like git push origin main"

Neither page explains the narrower permission that /commit-push-pr grants automatically for its own push step.

What's Wrong or Missing?

Claude Code v2.1.206 makes /commit-push-pr auto-allow git push to the repository's configured push remote. It resolves that remote from remote.pushDefault, or uses the sole configured remote when only one exists, in addition to continuing to recognize origin.

This is a user-visible permission and Git-routing contract. Users need to know which remote the bundled skill can push to without a separate approval, especially in repositories where fetch and push targets differ or where the primary remote is not named origin.

Suggested Improvement

Add /commit-push-pr to the built-in command/skill reference and describe its remote selection precisely:

1. remote.pushDefault, when configured.
2. The sole configured remote, when exactly one remote exists.
3. origin, as the conventional recognized remote.

Clarify that the automatic allowance is scoped to the bundled skill's git push step and does not create a general persistent Bash allow rule for unrelated commands. If the selection behavior is documented on the permissions page instead, cross-link it from the /commit-push-pr row.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 46-116 | Built-in command and skill reference; /commit-push-pr is absent |
| https://code.claude.com/docs/en/permissions | 154-164 | Bash permission matching and git push example |

Total scope: 2 pages affected.

Version: Configured push-remote auto-allow behavior added in Claude Code v2.1.206.