Skip to content

alamenai/terrae / .claude/skills/pr

Commit, push, and open a pull request on GitHub

FileKindSize
SKILL.mdskill md3.0 KB
---
name: pr
description: Commit, push, and open a pull request on GitHub
allowed-tools: Bash(git *), Bash(gh *)
---

# Pull Request Skill

Commit changes, push the branch, and open a pull request on GitHub.

## Instructions

1. **Check Current State**
   - Run `git status` to see changed files
   - Run `git diff --staged` and `git diff` to see all changes
   - Run `git log --oneline -5` to see recent commits

2. **Stage and Commit**
   - Stage specific files by name (avoid `git add -A` or `git add .`)
   - Never stage sensitive files (.env, credentials, etc.)
   - Follow conventional commit format: `type(scope): description`
   - Keep commit messages concise (under 72 characters)

3. **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

4. **Push to Remote**
   - Push with upstream tracking: `git push -u origin <branch-name>`

5. **Assign Labels**
   Add `--label` flags to `gh pr create` based on the PR type and scope.

   **Type labels** — pick based on the commit type:
   | Commit type | Label |
   |-------------|-------|
   | `fix` | `bug` |
   | `feat` | `enhancement` |
   | `docs` | `documentation` |
   | `test` | (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 |
   |-------|-------|
   | `compass` | `Compass` |
   | `interaction` | `Interaction` |

   Run `gh label list` to check available labels if unsure. Multiple labels can be combined:

   ```bash
   gh pr create --label "bug" --label "Compass" ...
   ```

6. **Open Pull Request**
   - Use `gh pr create` to 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:

   ```bash
   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
   )"
   ```

7. **Verify and Report**
   - Show the PR URL to the user
   - Run `git status` to confirm clean state

## Important Rules

- Do NOT push to `main` directly — always use a feature branch
- Do NOT force push unless explicitly requested
- Ask user before proceeding with each step
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall