{"id":"523f6c66-303c-4113-b96c-7d62e5e127c7","shortId":"hw2TVu","kind":"skill","title":"create-pull-request","tagline":"Create GitHub pull requests. Use when user asks to \"create a pull request\", \"open a pull request\", \"open a PR\", \"make a PR\", \"submit a PR\", \"push a PR\", \"/create-pull-request\", or requests creating a pull request. Don't use for reviewing PRs, merging branches, or committing local","description":"# Create Pull Request\n\nMode: $ARGUMENTS\n\nIf `--draft` is passed, create as draft PR.\n\n## Pre-loaded context\n\n- Branch status: !`git status && git branch -vv`\n- Recent commits: !`git log --oneline -10`\n\n## Workflow\n\n1. Run in parallel:\n   - `git fetch origin && git remote show origin | grep 'HEAD branch' | cut -d' ' -f5` (get base branch)\n   - `git rev-parse --abbrev-ref HEAD | grep -oE '[A-Z]+-[0-9]+'` (extract ticket ID)\n   - Search for PR template (see [template-locations.md](references/template-locations.md))\n2. Run in parallel:\n   - `git diff HEAD`\n   - `git diff [base-branch]...HEAD --unified=0`\n3. Read template if found\n4. Review ALL commits (not just latest)\n5. Ask the user (use AskUserQuestion when available; otherwise ask directly). Ask all at once where possible:\n   - **Effort** (required): how long the task took in hours (planning, reading, testing, all included)\n   - **Changes** (required): general overview of what was done\n   - **Testing** (optional): testing done that isn't visible in the diff\n   - **Tricky parts** (optional): anything hard, requiring multiple attempts, or non-obvious\n   - If template found, also surface any template-specific fields that can't be inferred from the diff (e.g. \"Does this include breaking changes?\", \"What type of change is this?\")\n6. Draft title and body:\n   - Title must match: `/^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(\\(.*\\))?: .+$/`\n   - **If template found**: use the template verbatim as the body base — fill every section/placeholder using diff + user answers; check applicable checkboxes; do NOT add sections not in the template; do NOT omit any template sections\n   - **If no template**: use Summary + Test plan\n   - Reference ticket ID in body if found (e.g. `Resolves TICKET-123`)\n   - Incorporate user's answers into description — don't just repeat the diff\n7. In parallel:\n   - Create branch if needed\n   - Push with `-u` if needed\n   - Create PR with `gh pr create` using HEREDOC (add `--draft` if requested)\n\nSee [examples.md](references/examples.md) for output format and [gh-flags.md](references/gh-flags.md) for advanced options.\n\n## Rules\n\n- If a PR template exists, the body MUST be the filled template — not a summary that references it\n- Analyze ALL commits, not just the latest\n- Return PR URL when done\n- Use `gh` CLI only\n- NEVER force push to main/master\n- NEVER push without user confirmation if already on main/master\n- NEVER create PR with uncommitted changes — commit first\n\n## Error Handling\n\n- If `gh pr create` fails with \"already exists\" → run `gh pr view` and return existing PR URL\n- If branch is not pushed → run `git push -u origin HEAD` before creating PR\n- If `gh auth status` fails → ask user to run `gh auth login` and retry","tags":["create","pull","request","agent","skills","helderberto","agent-skills","ai-tools","antigravity","claude-code","cursor","developer-tools"],"capabilities":["skill","source-helderberto","skill-create-pull-request","topic-agent-skills","topic-ai-tools","topic-antigravity","topic-claude-code","topic-cursor","topic-developer-tools","topic-gemini-cli","topic-markdown","topic-plugin","topic-sdlc","topic-skills","topic-tracer-bullet"],"categories":["agent-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/helderberto/agent-skills/create-pull-request","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add helderberto/agent-skills","source_repo":"https://github.com/helderberto/agent-skills","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 8 github stars · SKILL.md body (2,755 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:09:12.736Z","embedding":null,"createdAt":"2026-05-18T13:14:52.726Z","updatedAt":"2026-05-18T19:09:12.736Z","lastSeenAt":"2026-05-18T19:09:12.736Z","tsv":"'-10':81 '-123':318 '-9':117 '/create-pull-request':34 '0':116,142 '1':83 '2':128 '3':143 '4':148 '5':155 '6':247 '7':331 'a-z':113 'abbrev':108 'abbrev-ref':107 'add':289,351 'advanc':365 'alreadi':413,432 'also':220 'analyz':386 'answer':283,322 'anyth':208 'applic':285 'argument':56 'ask':12,156,164,166,462 'askuserquest':160 'attempt':212 'auth':459,467 'avail':162 'base':101,138,276 'base-branch':137 'bodi':251,275,312,374 'branch':48,69,74,96,102,139,335,444 'break':239 'build':255 'chang':186,240,244,421 'check':284 'checkbox':286 'chore':256 'ci':257 'cli':400 'commit':50,77,151,388,422 'confirm':411 'context':68 'creat':2,5,14,37,52,61,334,343,348,417,429,455 'create-pull-request':1 'cut':97 'd':98 'descript':324 'diff':133,136,204,234,281,330 'direct':165 'doc':258 'done':193,197,397 'draft':58,63,248,352 'e.g':235,315 'effort':172 'error':424 'everi':278 'examples.md':356 'exist':372,433,440 'extract':118 'f5':99 'fail':430,461 'feat':259 'fetch':88 'field':226 'fill':277,378 'first':423 'fix':260 'forc':403 'format':360 'found':147,219,268,314 'general':188 'get':100 'gh':346,399,427,435,458,466 'gh-flags.md':362 'git':71,73,78,87,90,103,132,135,449 'github':6 'grep':94,111 'handl':425 'hard':209 'head':95,110,134,140,453 'heredoc':350 'hour':180 'id':120,310 'includ':185,238 'incorpor':319 'infer':231 'isn':199 'latest':154,392 'load':67 'local':51 'log':79 'login':468 'long':175 'main/master':406,415 'make':25 'match':254 'merg':47 'mode':55 'multipl':211 'must':253,375 'need':337,342 'never':402,407,416 'non':215 'non-obvi':214 'obvious':216 'oe':112 'omit':297 'onelin':80 'open':18,22 'option':195,207,366 'origin':89,93,452 'otherwis':163 'output':359 'overview':189 'parallel':86,131,333 'pars':106 'part':206 'pass':60 'perf':261 'plan':181,307 'possibl':171 'pr':24,27,30,33,64,123,344,347,370,394,418,428,436,441,456 'pre':66 'pre-load':65 'prs':46 'pull':3,7,16,20,39,53 'push':31,338,404,408,447,450 'read':144,182 'recent':76 'ref':109 'refactor':262 'refer':308,384 'references/examples.md':357 'references/gh-flags.md':363 'references/template-locations.md':127 'remot':91 'repeat':328 'request':4,8,17,21,36,40,54,354 'requir':173,187,210 'resolv':316 'retri':470 'return':393,439 'rev':105 'rev-pars':104 'revert':263 'review':45,149 'rule':367 'run':84,129,434,448,465 'search':121 'section':290,300 'section/placeholder':279 'see':125,355 'show':92 'skill' 'skill-create-pull-request' 'source-helderberto' 'specif':225 'status':70,72,460 'style':264 'submit':28 'summari':305,382 'surfac':221 'task':177 'templat':124,145,218,224,267,271,294,299,303,371,379 'template-locations.md':126 'template-specif':223 'test':183,194,196,265,306 'ticket':119,309,317 'titl':249,252 'took':178 'topic-agent-skills' 'topic-ai-tools' 'topic-antigravity' 'topic-claude-code' 'topic-cursor' 'topic-developer-tools' 'topic-gemini-cli' 'topic-markdown' 'topic-plugin' 'topic-sdlc' 'topic-skills' 'topic-tracer-bullet' 'tricki':205 'type':242 'u':340,451 'uncommit':420 'unifi':141 'url':395,442 'use':9,43,159,269,280,304,349,398 'user':11,158,282,320,410,463 'verbatim':272 'view':437 'visibl':201 'vv':75 'without':409 'workflow':82 'z':115","prices":[{"id":"caace964-4e3b-441a-9116-ca44514ed2c5","listingId":"523f6c66-303c-4113-b96c-7d62e5e127c7","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"helderberto","category":"agent-skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:14:52.726Z"}],"sources":[{"listingId":"523f6c66-303c-4113-b96c-7d62e5e127c7","source":"github","sourceId":"helderberto/agent-skills/create-pull-request","sourceUrl":"https://github.com/helderberto/agent-skills/tree/main/skills/create-pull-request","isPrimary":false,"firstSeenAt":"2026-05-18T13:14:52.726Z","lastSeenAt":"2026-05-18T19:09:12.736Z"}],"details":{"listingId":"523f6c66-303c-4113-b96c-7d62e5e127c7","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"helderberto","slug":"create-pull-request","github":{"repo":"helderberto/agent-skills","stars":8,"topics":["agent-skills","ai","ai-tools","antigravity","claude-code","cursor","developer-tools","gemini-cli","markdown","plugin","sdlc","skills","tracer-bullet"],"license":"mit","html_url":"https://github.com/helderberto/agent-skills","pushed_at":"2026-05-14T11:37:47Z","description":"My personal SDLC toolbelt for AI coding agents — PRD to ship.","skill_md_sha":"ef129bf67bf7c3c219fddca6641faa96594cfa36","skill_md_path":"skills/create-pull-request/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/helderberto/agent-skills/tree/main/skills/create-pull-request"},"layout":"multi","source":"github","category":"agent-skills","frontmatter":{"name":"create-pull-request","description":"Create GitHub pull requests. Use when user asks to \"create a pull request\", \"open a pull request\", \"open a PR\", \"make a PR\", \"submit a PR\", \"push a PR\", \"/create-pull-request\", or requests creating a pull request. Don't use for reviewing PRs, merging branches, or committing local changes."},"skills_sh_url":"https://skills.sh/helderberto/agent-skills/create-pull-request"},"updatedAt":"2026-05-18T19:09:12.736Z"}}