skills/gh-create-pr/SKILL.md
Use when creating/raising/opening/submitting a GitHub PR. Produces short, feature-focused descriptions without a test plan.
npx skillsauth add lwlee2608/agent-skills gh-create-prInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Create PRs with short, feature-focused descriptions. No test plan or co-author lines.
gh pr create with a HEREDOC body:
gh pr create --title "<short title>" --body "$(cat <<'EOF'
[## Context <1–2 sentences — include this section only if rule 3 applies>
]## Summary <bullet points describing the main features/changes, proportional to PR size> EOF )"
2. **Title**: Use imperative mood (e.g., "Add user auth", "Fix pagination bug").
3. **Context section**: Include `## Context` above `## Summary` only when the PR has business/user-facing motivation sourced from a linked issue, ticket, CLAUDE.md, or conversation. Keep it to 1–2 sentences in plain language — what the user or business gets, not how. **Do not invent or speculate**; omit the section entirely for purely technical work (refactor, chore, dep bump) or when no source material exists.
4. **Summary section**: Bullet points proportional to PR size, focused on the changes themselves.
5. **No test plan**: Do not add a test plan, checklist, or QA section.
6. **No co-author**: Do not add "Co-Authored-By" lines.
documentation
Use when the user wants to condense the current conversation into a handoff document for another agent to pick up.
development
Use when the user asks to explain or teach a technical concept. Replies in plain language with a simple diagram instead of a wall of jargon.
development
Use when writing or editing a system prompt for any LLM API or SDK (any code passing a `system=` / `system` role parameter, or a `.txt`/`.md` file holding such a prompt). Applies prompt-engineering and prompt-caching best practices.
tools
Use before running any Go toolchain command (`go build`, `go test`, `go run`, `go vet`, `go fmt`, `golangci-lint`). Substitutes make targets when a Makefile is present.