Commit, Push & PR Skill
Automates the full workflow from local commits to opened PRs, including branch handling, PR descriptions, and post-PR babysitting.
Evidence shows the skill documents security-aware practices: avoiding `git add -A` and `git add .` to prevent accidental staging of sensitive files; explicit user confirmation mechanisms ('Asking the user' section and branch creation decisions); treating unknown PR state as unknown rather than assuming none; using a temp file for PR body to prevent empty content; and surfacing conflicts to the user rather than auto-resolving. No malicious behavior or gross overreach detected. Deductions: publisher identity unverified (affects trust but not a fixed penalty), privacy and data handling not directly disclosed in skill (requires PRIVACY.md), permissions and confirmations numerous but not covering all external effects (e.g., network access and dependency security).
Evidence shows detailed and self-consistent steps with conditional branches handling abnormal cases (detached HEAD, fork checkout, fetch failure, etc.) and explicit instructions on interpreting non-zero exit statuses. Multiple reference files (branch-creation, pr-description-writing, stack-submit) support key paths. No obvious contradictions or errors. Deductions: static review cannot execute verification; skill relies on many external commands (git, gh) and network dependencies, actual reliability untested; no test suite or CI coverage specific to this skill itself.
Skill clearly describes usage scenarios ('Commit, push, and open a PR') and modes (description-only, description-update, full workflow) with parameters (mode:pipeline, archive, branding, babysit). Boundaries clear: when user wants just a description, full workflow is not executed. Trigger description explicit. Environment fit: skill primarily depends on git and gh CLI and GitHub platform; for mainland China users, GitHub and gh may be inaccessible, but skill runs locally and does not rely on overseas services as core functionality. Deductions: non-GitHub environments (e.g., GitLab) not explicitly stated as out of scope; trigger conditions depend on user intent understanding, potential false triggers; no Chinese support documentation, though skill itself is in English, potential language barrier for Chinese users (FollowSkills serves Chinese users, noted).
Skill documentation structured clearly with step-by-step modes, parameter explanations, and references to reference files. Progressive disclosure present (description separate from details). Examples included via description. Known limitations disclosed (treating non-zero exit as unknown not no PR). License info from repo MIT license, version in package.json (3.21.4), but skill itself lacks version and changelog. Deductions: no independent version or changelog for the skill, relying on repo-level; no troubleshooting section though error handling detailed; maintenance responsibility not explicit within skill (only in README and SECURITY.md), update path depends on whole repo.
Based on documentation, skill appears to achieve its core task: create commits, push, open PR, with detailed guidance ensuring correctness (e.g., avoid `git add -A`, use `--body-file`). Output described as PR URL and body. Marginal value: saves manual time and provides consistent PR description writing guidance. Deductions: static review cannot verify actual output is directly usable; skill complexity high, may need adjustments; alternatives (direct git commands) low cost, so marginal value exists but limited.
Evidence primarily from skill documentation and repository metadata (CI, tests exist), but no actual execution tests for this skill found. CI and tests exist but may not cover skill key paths. No third-party verification records. Claimed benefits ('make each unit of engineering work easier') articulated but unverified. Deductions: static review cannot execute skill; minimal independent verifiable evidence, only test existence in repo but possibly not specific to this skill.
- Publisher identity is unverified; install and use with caution.
- Skill depends on GitHub's gh CLI and network; for mainland China users, a proxy or alternative may be needed.
- Privacy/data handling not directly disclosed in skill; refer to PRIVACY.md.
- Skill is powerful and may auto-perform commits, pushes, etc.; ensure trustworthy environment and understand its behavior.
What does this skill do, and when should you use it?
This skill automates the complete Git workflow from local changes to an opened pull request: it detects branch state, creates feature branches, commits changes, pushes them, and generates or updates the PR description. It also handles PR stacks, concept-teaching documentation archival, and automatically starts post-PR babysitting to keep the PR moving toward merge. The skill supports multiple AI coding tools (Claude Code, Codex, Cursor) and follows different modes (full workflow, description-only, description update).
Runs git commands (git rev-parse, git status, git branch, git log, git rev-parse --abbrev-ref origin/HEAD) to gather repo context; checks for existing open PRs (gh pr list); auto-creates feature branches when needed; determines commit and PR title style from repo conventions; stages and commits changes (avoiding git add -A); pushes the branch (git push -u origin HEAD); composes PR title and body with value-first framing, evidence decision, and concept-teaching section; applies via gh pr create or gh pr edit; optionally writes explainer docs to <root>/explainers/; and starts PR babysitting via ce-babysit-pr.
- A developer with local changes wants to quickly commit, push, and open a PR without remembering each git command.
- A developer working on a branch with an existing open PR wants to push new commits and update the PR description.
- A user wants to generate a PR description based only on a given PR number or URL, without committing or pushing.
- A team using PR stacks for multiple related logical changes wants to automatically create and submit the entire stack.
- A developer wants the PR to be babysat by ce-babysit-pr until merge-ready, monitoring CI and review feedback.
What are this skill's strengths and limitations?
- Automates the complete Git workflow, reducing manual steps and errors.
- Handles complex scenarios intelligently: detached HEAD, commits on default branch, fork PRs, same-name branches from multiple owners.
- Generates value-first PR descriptions with optional evidence and concept-teaching sections.
- Integrates with post-PR babysitting to keep the PR moving toward merge.
- Works across multiple AI tools (Claude Code, Codex, Cursor).
- Requires Git and GitHub CLI (gh) installed and authenticated.
- Very complex, with many modes and configuration options that may be overwhelming to fully master.
- Heavily GitHub-dependent; applicability to GitLab or other platforms is not documented.
- May not work in platforms without compatible plugin installation.
- No test suite mentioned in the README; reliability is largely documented, not verified.
How do you install this skill?
Since this skill is part of the Compound Engineering plugin, follow the plugin installation instructions in the README. For example, in Claude Code: type /plugin marketplace add EveryInc/compound-engineering-plugin then /plugin install compound-engineering. For Codex CLI: run codex plugin marketplace add EveryInc/compound-engineering-plugin then codex plugin add compound-engineering@compound-engineering-plugin. After installation, the skill is located at skills/ce-commit-push-pr/SKILL.md.
How do you use this skill?
Trigger it with natural language in a supported AI coding tool, e.g., 'commit and push and open a PR'. The skill will automatically handle branching and committing logic. For description-only flows, provide a PR URL or number, e.g., 'write a description for PR #123'. To skip automatic babysitting after the PR, add babysit:off; to force it, use babysit:continuous or babysit:checkpoint.
How does this skill compare with similar options?
This skill is part of the Compound Engineering plugin, with clear differentiation from other skills like ce-commit and ce-babysit-pr. It focuses on end-to-end commit, push, and PR creation, while ce-commit handles only commits, and ce-babysit-pr monitors the PR after creation. Standard Git workflows or GitHub CLI commands could be considered alternatives, but this skill offers a more comprehensive solution by automating context decisions and integrating with the ecosystem.