Automates the GitHub PR flow with changelog updates and conventional commit labeling.

Install

mkdir -p .claude/skills/pr-gacela-project && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13172" && unzip -o skill.zip -d .claude/skills/pr-gacela-project && rm skill.zip

Installs to .claude/skills/pr-gacela-project

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.

Push branch and create a PR with concise description and labels
63 charsno explicit “when” trigger
Beginner

Key capabilities

  • Update CHANGELOG.md if necessary
  • Generate a PR title based on issue number or branch prefix
  • Read and use `.github/PULL_REQUEST_TEMPLATE.md` for PR body
  • Create a pull request with assignee and labels
  • Report the PR URL to the user

How it works

The skill checks for changelog updates, pushes the current branch, generates a PR title, reads a template for the PR body, and then creates a pull request with appropriate labels and assignee.

Inputs & outputs

You give it
Current branch with changes, optional issue number
You get back
Updated CHANGELOG.md (if applicable), pushed branch, and a GitHub pull request with a generated title, body, and labels

When to use pr

  • Open PR with changelog update
  • Automate PR labeling
  • Create PR from issue
  • Sync PR body with templates

About this skill

Create Pull Request

Context

!git branch --show-current !git log main..HEAD --oneline !git diff main..HEAD --stat

Instructions

  1. Check CHANGELOG.md — if it wasn't updated for these changes, update it now and commit:

    git add CHANGELOG.md && git commit -m "chore: update changelog"
    
  2. Push branch:

    git push -u origin HEAD
    
  3. Generate PR title:

    • If $ARGUMENTS contains an issue number, fetch the issue title:
      gh issue view <number> --json title -q '.title'
      
    • PR title format: <type>(<scope>): <short description> (conventional commit style, under 70 chars)
    • Derive the type from the branch prefix (feat/ → feat, fix/ → fix, docs/ → docs)
  4. Read .github/PULL_REQUEST_TEMPLATE.md and use its exact section headers (including emojis) for the PR body. Do NOT hardcode headers — always read the template file first.

  5. Create PR using the headers from the template:

    gh pr create --title "<title>" --assignee @me --label "<label>" --body "$(cat <<'EOF'
    <paste exact headers from .github/PULL_REQUEST_TEMPLATE.md>
    
    Closes #<issue-number>
    EOF
    )"
    

    Labels: Pick the single most relevant from:

    • bug — branch starts with fix/
    • enhancement — branch starts with feat/
    • documentation — branch starts with docs/
    • refactoring — code restructuring with no behavior change
    • pure testing — only test changes
    • dependencies — dependency updates

    Body guidelines:

    • Focus on what and why, not implementation details
    • Use Closes #<number> so merging auto-closes the issue
    • Keep the entire body under 15 lines
  6. Report the PR URL to the user.

When not to use it

  • When the changelog should not be updated
  • When a specific PR template is not available at `.github/PULL_REQUEST_TEMPLATE.md`
  • When the PR body should exceed 15 lines

Limitations

  • PR body must be under 15 lines
  • Requires `.github/PULL_REQUEST_TEMPLATE.md` for PR body structure
  • Labels are selected from a predefined set based on branch prefix or commit type

How it compares

This skill automates the creation of a pull request by integrating changelog updates, dynamic title generation, template-based body creation, and intelligent label assignment, which is more efficient than manual PR creation.

Compared to similar skills

pr side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
pr (this skill)04moReviewBeginner
github-workflow-automation112moReviewAdvanced
testing-workflow169moReviewIntermediate
github-actions-templates73moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

Search skills

Search the agent skills registry