PR Body Drafter
Yeachan-Heo/oh-my-claudecode
Drafts a pull request body from the session's paper trail: a one-line claim with the smallest proving visual, verify evidence, a reversibility note and glossary terms.
Create or update a Pull Request with AI-generated description, mermaid diagram, file walkthrough, and automatic design-doc detection.
Install Create PR
$ npx skills add Smana/cloud-native-ref --skill create-pr -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Smana/cloud-native-ref create-pr --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Smana/cloud-native-ref.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/create-pr .claude/skills/create-pr && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "create-pr" agent skill from https://github.com/Smana/cloud-native-ref/tree/main/.agents/skills/create-pr into .claude/skills/create-pr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "create-pr", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Smana/cloud-native-ref/tree/main/.agents/skills/create-prType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Smana/cloud-native-ref --skill create-pr -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Smana/cloud-native-ref create-pr --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Smana/cloud-native-ref.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/create-pr .agents/skills/create-pr && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "create-pr" agent skill from https://github.com/Smana/cloud-native-ref/tree/main/.agents/skills/create-pr into .agents/skills/create-pr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "create-pr", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Smana/cloud-native-ref --skill create-pr -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Smana/cloud-native-ref create-pr --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Smana/cloud-native-ref.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/create-pr .cursor/skills/create-pr && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "create-pr" agent skill from https://github.com/Smana/cloud-native-ref/tree/main/.agents/skills/create-pr into .cursor/skills/create-pr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "create-pr", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Smana/cloud-native-ref.git --path .agents/skills/create-pr--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Smana/cloud-native-ref --skill create-pr -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Smana/cloud-native-ref create-pr --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Smana/cloud-native-ref.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/create-pr .gemini/skills/create-pr && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "create-pr" agent skill from https://github.com/Smana/cloud-native-ref/tree/main/.agents/skills/create-pr into .gemini/skills/create-pr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "create-pr", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Smana/cloud-native-ref create-prInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Smana/cloud-native-ref --skill create-pr -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Smana/cloud-native-ref.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/create-pr .github/skills/create-pr && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "create-pr" agent skill from https://github.com/Smana/cloud-native-ref/tree/main/.agents/skills/create-pr into .github/skills/create-pr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "create-pr", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Smana/cloud-native-ref --skill create-pr -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Smana/cloud-native-ref create-pr --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Smana/cloud-native-ref.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/create-pr .opencode/skills/create-pr && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "create-pr" agent skill from https://github.com/Smana/cloud-native-ref/tree/main/.agents/skills/create-pr into .opencode/skills/create-pr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "create-pr", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
create-pr- GitHub stars
- 103
- Token cost
- ~1.2k tokens
- SKILL.md length
- 442 words
- Files
- 3 (incl. references)
- Skills in repo
- 6
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Create or update a Pull Request with AI-generated description, mermaid diagram, file walkthrough, and automatic design-doc detection.
- Works in 6 steps: Rebase first → Gather diff information (parallel) → Detect the design context → …
- Tasks that involve Pull requests
- SKILL.md covers Mode detection, Create Mode, Update Mode and Content rules, plus 2 more sections
- Calls git and gh
What it does
Create PR is an agent skill from Smana/cloud-native-ref. Create or update a Pull Request with AI-generated description, mermaid diagram, file walkthrough, and automatic design-doc detection. Uses templates/pr-body.md for structure.
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/mermaid-styles.md` and `templates/pr-body.md`).
It sits in Development, covering Pull requests and Architecture decision records. It works with Mermaid. The repository describes itself as: Opiniated Cloud Native Platform Reference. The licence is Apache-2.0.
When your agent uses it
- Tasks that involve Pull requests
- Tasks that involve Architecture decision records
Example prompts
- “/create-pr”
Requirements
- Pre-approved tools (allowed-tools): Bash(git:*), Bash(gh:*), Read
Workflow steps
6 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit e5ee7e1. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
Bash(git:*)Bash(gh:*)Read
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
gitgh
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git and gh, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Create PR loads about 1.2k tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 46 tokens; SKILL.md has 442 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from Smana/cloud-native-ref at commit e5ee7e1, republished under its Apache-2.0 licence (© Smana). 442 words, ~1,237 tokens.
Download SKILL.mdSave it as
.claude/skills/create-pr/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.- name
- create-pr
- description
- Create or update a Pull Request with AI-generated description, mermaid diagram, file walkthrough, and automatic design-doc detection. Uses templates/pr-body.md for structure.
- allowed-tools
- Bash(git:*), Bash(gh:*), Read
- when_to_use
- When the user says "open a PR", "create pull request", "push this as a PR", "open PR against main", "update my PR description", "--update <number>", or wants…
- disable-model-invocation
- true
- argument-hint
- [base-branch] | --update <pr-number>
Create PR Skill
Generate and create/update a comprehensive PR using the shared body template.
Mode detection
Parse $ARGUMENTS:
- Starts with
--updateor-ufollowed by a number → Update Mode on that PR. - Anything else → Create Mode (argument is the base branch; default
main).
Create Mode
0. Rebase first
Run the sync-branch skill before reading the diff. A PR opened from a branch behind
origin/${BASE:-main} shows reviewers a diff against the wrong merge base, and its CI result
describes code that will not merge.
Opening a PR is explicit direction to publish the branch, so this is the one caller for which
sync-branch may force-push. It pushes once, here — not again in step 4.
1. Gather diff information (parallel)
git log origin/${BASE:-main}..HEAD --oneline
git diff origin/${BASE:-main}...HEAD --stat
git diff origin/${BASE:-main}...HEAD2. Detect the design context
Changed paths → change type:
| Path pattern | Change type |
|---|---|
infrastructure/base/crossplane/configuration-aws/configuration-packages.yaml (composition package pin) | composition |
opentofu/**/*.tf, terramate.tm.hcl | infrastructure |
*networkpolicy*, *rbac*, openbao/**, *cilium*policy* | security |
| Multiple top-level dirs + HelmRelease/Kustomization | platform |
Find the design document behind these changes, if one exists. Non-trivial work goes through the
Superpowers flow (see docs/superpowers/AGENTS.md), which commits a design and a plan on
the branch:
git diff origin/${BASE:-main}...HEAD --name-only \
| grep -oE 'docs/superpowers/(specs|plans)/[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9-]+\.md' \
| sort -uWhen a design is detected, include the Design block:
## 📋 Design
Design: [`<date>-<topic>-design.md`](../blob/main/docs/superpowers/specs/<date>-<topic>-design.md)
Plan: [`<date>-<topic>-plan.md`](../blob/main/docs/superpowers/plans/<date>-<topic>-plan.md)
<one line: which part of the plan this PR delivers>If the design doc itself changed materially in a PR that also implements it, say so in the summary — a design moving during implementation usually signals scope creep worth calling out.
If the changes look substantial (a new composition, a new OpenTofu stack, a security-model change) and no design doc is present, include the Design Recommendation warning block from the template.
3. Render the PR body
Fill the template in templates/pr-body.md. Apply the mermaid styling from references/mermaid-styles.md. Keep title < 70 chars. Drop sections that do not apply (no empty stubs).
Show full SKILL.md (165 more words)Show less
4. Create the PR
git push -u origin "$(git branch --show-current)"
gh pr create --base "${BASE:-main}" --title "<title>" --body "$BODY"5. Output
Return only the PR URL.
Update Mode
gh pr view "$PR_NUMBER" --json number,title,files,additions,deletions,baseRefName,body
gh pr diff "$PR_NUMBER"Generate a fresh body using the same template. Update through the REST endpoint — gh pr edit
runs a GraphQL query that includes projectCards, which GitHub has sunset, and on this repo it
fails outright while printing what looks like a deprecation warning. Verified 2026-09-17: the body
was unchanged afterwards.
gh api --method PATCH "repos/{owner}/{repo}/pulls/$PR_NUMBER" -f body="$BODY" --jq '.number'Return Updated PR #<N>: <url>.
Content rules
- Title: conventional prefix (
feat(crossplane): ...), under 70 chars. - Summary: WHY, not WHAT. The file table shows WHAT.
- Auto-detect the design by scanning
docs/superpowers/specs/*-design.mdin the diff. Preserve existing references on update. - Never skip hooks, never force-push without explicit user direction.
Related skills
ship-it— the full pipeline; calls this skill as its last stagesync-branch— the rebase preflight in step 0superpowers:brainstorming— produces the design this PR references/commit— commit with pre-commit validation before creating the PR
Supporting files
templates/pr-body.md— full body template with both design-present and design-recommendation variantsreferences/mermaid-styles.md— color classes and best practices for flow diagrams
© Smana, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 2 other files (references) in .agents/skills/create-pr of Smana/cloud-native-ref.
- SKILL.md
- references/mermaid-styles.md
- templates/pr-body.md
Open the folder on GitHubat commit e5ee7e1
Compare with similar skills
Create PR next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Create PR this skillSmana/cloud-native-ref | 103 | — | ~1.2k | Automated safety check: Pass | Apache-2.0 | |
| PR Body DrafterYeachan-Heo/oh-my-claudecode | 40k | — | ~773 | Automated safety check: Pass | MIT | |
| PR Design DocOpenHands/OpenHands | 90k | — | ~2.4k | Automated safety check: Pass | MIT | |
| Design Doc MermaidSpillwaveSolutions/design-doc-mermaid | 175 | 1 repos | ~5.6k | Automated safety check: Pass | None | |
| Eli5coldteadotai/pr-lens | 1.9k | — | ~2.3k | Automated safety check: Pass | MIT | |
| PR Lenscoldteadotai/pr-lens | 1.9k | — | ~398 | Automated safety check: Pass | MIT |
Similar skills
PR Design Doc
OpenHands/OpenHands
For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…
Design Doc Mermaid
SpillwaveSolutions/design-doc-mermaid
Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code.
Eli5
coldteadotai/pr-lens
WHAT: Explains a codebase, a folder, a feature, a command or a pull request to someone who knows nothing about it, as a PR Lens canvas whose walkthrough builds the picture one part at a time.
PR Lens
coldteadotai/pr-lens
WHAT: Draws a code change or part of a codebase as an animated architecture or data-flow diagram, on its own or in a pull request.
Open PR
Kiln-AI/Kiln
Open a pull request on the Kiln repo for a human to complete.
More from Smana/cloud-native-ref
Commit
Smana/cloud-native-ref
Run pre-commit validation before committing. An agent skill from Smana/cloud-native-ref.
Ship It
Smana/cloud-native-ref
Take a finished branch through the full pre-merge pipeline in one pass — rebase onto origin/main, simplify, prune prose, run the repo's validators and cite their output, review the diff, act on…
Sync Branch
Smana/cloud-native-ref
Rebase the current branch onto the latest origin/main before pushing, reviewing, or opening a PR.
Spec Research
Smana/cloud-native-ref
Research patterns, ecosystem tools, and best practices before writing a design.
Verify Spec
Smana/cloud-native-ref
Verify that a merged design's success criteria are actually met in the live cluster.
Related
Works with
Categories
Questions about Create PR
What does Create PR do?
Create or update a Pull Request with AI-generated description, mermaid diagram, file walkthrough, and automatic design-doc detection. Create PR is an agent skill from Smana/cloud-native-ref. Create or update a Pull Request with AI-generated description, mermaid diagram, file walkthrough, and automatic design-doc detection.
When should I use Create PR?
Create PR fits situations like: tasks that involve Pull requests; tasks that involve Architecture decision records.
How do I install Create PR in Claude Code?
Run `npx skills add Smana/cloud-native-ref --skill create-pr -a claude-code`. Or copy the skill folder (.agents/skills/create-pr in Smana/cloud-native-ref) into .claude/skills/create-pr in your project. Claude Code loads it when a task matches its description.
How do I install Create PR in Codex?
Run `npx skills add Smana/cloud-native-ref --skill create-pr -a codex`. Or copy the skill folder (.agents/skills/create-pr in Smana/cloud-native-ref) into .agents/skills/create-pr in your project. Codex loads it when a task matches its description.
Can I use Create PR in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Smana/cloud-native-ref --skill create-pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/create-pr, .gemini/skills/create-pr, .github/skills/create-pr and .opencode/skills/create-pr in your project.
What does Create PR need to run?
Going by SKILL.md and its folder, Create PR needs the command-line tools its instructions call (git and gh). Its frontmatter pre-approves these tools: Bash(git:*), Bash(gh:*), Read.
Does Create PR access the network?
SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Create PR safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Create PR use?
Create PR is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Create PR use?
About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 400 tokens, read only when the agent opens those files.
What are the alternatives to Create PR?
Skills that share tags, products or a category with Create PR: PR Body Drafter (Yeachan-Heo/oh-my-claudecode, 40k stars), PR Design Doc (OpenHands/OpenHands, 90k stars), Design Doc Mermaid (SpillwaveSolutions/design-doc-mermaid, 175 stars) and Eli5 (coldteadotai/pr-lens, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Create PR?
Smana (a GitHub user) maintains it in Smana/cloud-native-ref, which has 103 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 8, 2026.
Source: Smana/cloud-native-ref on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.