Automates the Git and GitHub workflow for submitting code changes.
Install
mkdir -p .claude/skills/pr-alamenai && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13174" && unzip -o skill.zip -d .claude/skills/pr-alamenai && rm skill.zipInstalls to .claude/skills/pr-alamenai
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Commit, push, and open a pull request on GitHubKey capabilities
- →Commit changes following conventional commit format
- →Push the current branch to remote
- →Open a pull request on GitHub
- →Assign labels to pull requests based on type and scope
- →Include a structured description in the pull request body
- →Verify and report the PR URL
How it works
The skill stages specific files, commits them using a conventional format, pushes the branch to the remote, and then opens a GitHub pull request with dynamically assigned labels and a structured body.
Inputs & outputs
When to use pr
- →Open PR
- →Push branch
- →Automate conventional commits
About this skill
Pull Request Skill
Commit changes, push the branch, and open a pull request on GitHub.
Instructions
-
Check Current State
- Run
git statusto see changed files - Run
git diff --stagedandgit diffto see all changes - Run
git log --oneline -5to see recent commits
- Run
-
Stage and Commit
- Stage specific files by name (avoid
git add -Aorgit add .) - Never stage sensitive files (.env, credentials, etc.)
- Follow conventional commit format:
type(scope): description - Keep commit messages concise (under 72 characters)
- Stage specific files by name (avoid
-
Create or Use Branch
- If on
main, create a new branch:git checkout -b <branch-name> - Branch name format:
type/short-description(e.g.,feat/code-comparison,fix/marker-cleanup) - If already on a feature branch, use it
- If on
-
Push to Remote
- Push with upstream tracking:
git push -u origin <branch-name>
- Push with upstream tracking:
-
Assign Labels Add
--labelflags togh pr createbased on the PR type and scope.Type labels — pick based on the commit type:
Commit type Label fixbugfeatenhancementdocsdocumentationtest(no type label) refactor(no type label) chore(no type label) Component labels — if the scope matches a component label in the repo, add it:
Scope Label compassCompassinteractionInteractionRun
gh label listto check available labels if unsure. Multiple labels can be combined:gh pr create --label "bug" --label "Compass" ... -
Open Pull Request
- Use
gh pr createto open the PR - Write a clear title (under 70 characters)
- Write a description that follows the structure below based on PR type
- Start with a Type checklist — check the one that applies:
gh pr create --title "type(scope): description" --label "label" --body "$(cat <<'EOF' ## Type - [ ] Feature - [ ] Bug fix - [ ] Refactor - [ ] Test - [ ] Docs - [ ] Chore ## Summary - bullet points describing what changed and why ## Bug Details (only for bug fixes) **What was the bug?** Describe the incorrect behavior. **Why did it happen?** Explain the root cause. **How was it fixed?** Describe the solution. ## Test Coverage If tests were added or updated, link to the file on the branch (permalink): - [`src/registry/map/__tests__/component.test.tsx`](https://github.com/alamenai/terrae/blob/<branch-name>/src/registry/map/__tests__/component.test.tsx) EOF )" - Use
-
Verify and Report
- Show the PR URL to the user
- Run
git statusto confirm clean state
Important Rules
- Do NOT push to
maindirectly — always use a feature branch - Do NOT force push unless explicitly requested
- Ask user before proceeding with each step
When not to use it
- →When pushing directly to `main` is required
- →When force pushing is needed without explicit request
- →When sensitive files like `.env` or credentials are to be staged
Limitations
- →Does not allow pushing directly to `main`
- →Does not allow force pushing without explicit request
- →Does not stage sensitive files
How it compares
This skill automates the GitHub pull request process by enforcing conventional commit messages, intelligent label assignment, and a structured PR body, which is more consistent and efficient than manual PR creation.
Compared to similar skills
pr side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| pr (this skill) | 0 | 6mo | Review | Beginner |
| github-workflow-automation | 11 | 2mo | Review | Advanced |
| testing-workflow | 16 | 9mo | Review | Intermediate |
| github-actions-templates | 7 | 3mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
github-workflow-automation
ruvnet
Advanced GitHub Actions workflow automation with AI swarm coordination, intelligent CI/CD pipelines, and comprehensive repository management
testing-workflow
amo-tech-ai
Comprehensive testing workflow for E2E, integration, and unit tests. Use when testing applications layer-by-layer, validating user journeys, or running test suites.
github-actions-templates
wshobson
Create production-ready GitHub Actions workflows for automated testing, building, and deploying applications. Use when setting up CI/CD with GitHub Actions, automating development workflows, or creating reusable workflow templates.
glab
NikiforovAll
Expert guidance for using the GitLab CLI (glab) to manage GitLab issues, merge requests, CI/CD pipelines, repositories, and other GitLab operations from the command line. Use this skill when the user needs to interact with GitLab resources or perform GitLab workflows.
create-pr
n8n-io
Creates GitHub pull requests with properly formatted titles that pass the check-pr-title CI validation. Use when creating PRs, submitting changes for review, or when the user says /pr or asks to create a pull request.
gh-fix-ci
openai
Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions; use `gh` to inspect checks and logs, summarize failure context, draft a fix plan, and implement only after explicit approval. Treat external providers (for example Buildkite) as out of scope and report only the details URL.