name: pr description: Create a feature branch, commit changes, push, and open a PR against iopsystems/rezolus
Create a PR from the current uncommitted changes. Handles branching, committing, pushing, and opening the PR against the upstream repo.
Arguments
The skill accepts an optional branch name argument:
- If provided, use it as the branch name (e.g.,
/pr fix-socket-perms) - If not provided, generate a descriptive kebab-case branch name from the changes
Steps
-
Verify prerequisites:
- Working directory must have uncommitted changes (staged or unstaged)
- Must not already be on a feature branch with unpushed commits for a different change
git status git diff git diff --stagedIf there are no changes, stop and tell the user.
-
Analyze the changes:
- Read the diff to understand what changed
- Check recent commit messages for style conventions:
git log --oneline -10
-
Create feature branch:
- If currently on
main, create a new branch:git checkout -b <branch-name> - If already on a feature branch, use the current branch
- If currently on
-
Sync docs version label (idempotent — runs every PR):
./scripts/sync-docs-version.shUpdates
site/docs/*.html's sidebar version label to the latest stable release tag. If it modifies any file, include the change in the same commit. If nothing changes, no-op. -
Stage and commit:
- Stage the relevant changed files by name (avoid
git add -A) - Write a commit message following the repo's conventional commit style (
type(scope): description) - Common types:
feat,fix,refactor,chore,docs,test - Include
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>trailer - Use a HEREDOC for the commit message
- Stage the relevant changed files by name (avoid
-
Push to origin:
git push -u origin <branch-name> -
Open PR against upstream:
- The upstream repo is
iopsystems/rezolus - The fork remote is
origin(determine the owner fromgit remote -v) - Use
gh pr createwith--repo iopsystems/rezolusand--head <fork-owner>:<branch-name>
gh pr create \ --repo iopsystems/rezolus \ --head <fork-owner>:<branch-name> \ --draft \ --title "<conventional commit style title>" \ --body "$(cat <<'EOF' ## Summary <1-3 bullet points describing the changes> ## Test plan <bulleted checklist of testing done or needed> 🤖 Generated with [Claude Code](https://claude.com/claude-code) EOF )" - The upstream repo is
-
Report the PR URL to the user.
Version bumps
Non-release PRs must never bump the major, minor, or patch version. Instead, bump only the pre-release revision number in Cargo.toml:
- Format:
<major>.<minor>.<patch>-alpha.<revision> - Example:
5.8.3-alpha.0→5.8.3-alpha.1→5.8.3-alpha.2 - Increment the revision (
-alpha.N) by 1 from the currentmainbranch version - Check the current main branch version before committing:
git show main:Cargo.toml | grep '^version'
Notes
- Keep PR titles under 70 characters
- PR title should follow the same conventional commit format as the commit message
- If
cargo clippy,cargo test, orcargo fmt --checkhaven't been run yet during this session, run them before committing - Never force push or amend existing commits
- The fork owner can be determined from the origin remote URL (e.g.,
git@github.com:brayniac/rezolus→brayniac) - PRs are created as drafts by default. Mark ready via GitHub UI or
gh pr ready
Expert Next.js App Router
Developpement
Un skill qui transforme Claude en expert Next.js App Router.
Générateur de README
Developpement
Crée des README.md professionnels et complets pour vos projets.
Rédacteur de Documentation API
Developpement
Génère de la documentation API complète au format OpenAPI/Swagger.