af-git-pr

Create GitHub pull requests with contextual titles and scaled descriptions via the GitHub CLI.

1|Updated Nov 12, 2025
One-click install
npx skills add https://github.com/e-stpierre/agentic-forge --skill af-git-pr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: af-git-pr
Source: https://github.com/e-stpierre/agentic-forge/tree/main/src/claude/.claude/skills/git-pr
Command: npx skills add https://github.com/e-stpierre/agentic-forge --skill af-git-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the creation of GitHub pull requests by generating a clear title and a context-aware, size-appropriate description so developers don't have to craft boilerplate or guess the right level of detail for reviewers.

Core Features & Use Cases

  • Adaptive PR descriptions: Analyzes diffs and commit logs to choose concise or structured descriptions based on change magnitude.
  • Title generation and metadata: Produces a focused title, chooses the target base branch, and supports draft PR creation.
  • CLI integration: Uses the GitHub CLI to push and create the PR, and returns structured JSON with PR details.
  • Use Case: A developer finishing a feature branch can quickly generate a PR that explains the intent and context for reviewers, with short notes for tiny fixes and structured summaries for large refactors.

Quick Start

Create a pull request from the current branch into main with an AI-generated title and a size-appropriate description and mark it draft if needed.

Frequently Asked Questions about af-git-pr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically generate a GitHub pull request description from branch diffs?

To generate a pull request description from branch diffs, use this Skill to analyze commit logs and code changes. It computes the diff via the GitHub CLI and produces a context-aware, size-appropriate summary so developers avoid crafting boilerplate manually.

What's the best way to create a draft pull request using the gh cli with a generated title?

Creating a draft pull request with the gh cli is supported by this Skill through an optional draft parameter. It generates a focused title from the branch context and executes gh pr create, returning structured JSON with the resulting PR details.

Do I need git and the GitHub CLI installed to automate pull request creation?

Yes, you need both git and the GitHub CLI installed to automate pull request creation. The Skill requires these tools to fetch remote bases, compute diffs, and execute the gh pr create command with optional base and draft parameters.

How does adaptive PR description generation work for large refactors versus small fixes?

Adaptive PR description generation works by analyzing diff magnitude and commit logs to scale the output. It produces concise notes for small fixes and structured summaries for large refactors, ensuring reviewers get appropriate context.

Can I specify a target base branch when creating a pull request from my feature branch?

Yes, you can specify a target base branch when creating a pull request. The Skill supports an optional base parameter, allowing you to push your feature branch and generate the PR against the correct remote base branch.

Why use an automated pull request generator instead of writing PR descriptions manually?

Using an automated pull request generator eliminates the guesswork of providing the right level of detail for reviewers. It analyzes diffs to choose concise or structured descriptions, saving time and ensuring context is clearly communicated.