pr

Use this skill when creating a GitHub pull request for changes to this repository, or when editing an existing PR's title or description.

gh CLI

This skill uses the gh CLI throughout. If a gh command fails because it is not installed or not authenticated, fall back to providing the PR title and body clearly so the user can copy-paste them, along with the relevant GitHub URL:

• New PR: https://github.com/cloudflare/cloudflare-docs/compare/production...<branch> (get branch from git branch --show-current)
• Edit existing PR: https://github.com/cloudflare/cloudflare-docs/pull/<number> — instruct them to select Edit on the description.

Editing an existing PR

When asked to update or edit an existing PR description (or title), follow these rules strictly — then stop. Do not proceed to the "Creating a new PR" steps below.

1. Always read the current PR description first using gh pr view <number> --json title,body before making any changes.
2. If the description is empty, treat it as a new PR body and follow the template and guidelines in the "Creating a new PR" section below.
3. Follow the existing format — if the author has structured their description in a particular way, preserve that structure. Do not reformat, reorder, or restructure sections they wrote.
4. Only change what was asked — make the minimum edit necessary to fulfill the request. Do not "improve" unrelated phrasing, fix grammar elsewhere, rewrite the summary, or modify checklist items that were not part of the request.
5. Apply the edit:
   • Title: gh pr edit <number> --title "..."