pr-push_skill

Overview

This skill automates committing any local changes, running lint and tests, applying fixes, and pushing the current feature branch to GitHub. It completes all steps autonomously without asking for confirmation and ensures a pull request is created or updated. It also records session learnings and reports the final PR URL and a concise summary of actions.

How this skill works

The skill inspects the current git branch, stages and commits uncommitted changes (excluding secrets and unwanted artifacts), runs formatter/linter and TypeScript checks, and fixes issues either automatically or by editing files. It runs the test suite, amends commits if lint made changes, determines the correct remote, pushes with --force-with-lease, and creates or updates a GitHub PR using the gh CLI. Finally, it removes a specific review label if present and records learnings in repo docs.

When to use it

• You have local work that needs to be committed, linted, tested, and pushed without manual steps.
• You want an automated, auditable PR creation or update from a feature branch.
• You need consistent pre-push checks (fmt, lint:fix, TypeScript, tests) applied before pushing.
• You want session learnings recorded automatically after a push.

Best practices

• Never run this skill from main/master; it will create a descriptive feature branch if needed.
• Keep secrets and build artifacts out of commits (.env, node_modules/, *.key, *.pem, .DS_Store, logs).
• Avoid spurious package-lock.json commits unless package.json changed.
• Ensure gh CLI is authenticated and remotes are configured (origin/upstream) for predictable pushes.
• Prefer small, focused commits so lint fixes can be amended cleanly into the last commit.

Example use cases

• Finish a local bugfix: commit changed files, auto-fix lint, run tests, and push with a PR created.
• Polish a new feature branch after manual edits and ensure all checks pass before pushing.
• Recover from local formatting fixes by amending the last commit and force-pushing safely.
• Capture session notes and troubleshooting tips into AGENTS.md or rules/ after a successful push.