.claude/skills/pr-description/SKILL.md
Generate a PR description from current branch changes, output as copyable markdown
npx skillsauth add washingtonguilhardes/example.hr-module pr-descriptionInstall 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.
Persona: Execute this task as the @developer subagent.
Load the persona characteristics from .rulesync/subagents/developer.md before proceeding.
Generate a standalone PR description for the current branch changes. Output as raw inline markdown in a code fence, ready to copy-paste. Does NOT commit, push, or create a PR.
Analyze changes: - Run git diff dev...HEAD to see all changes on current branch (default base: dev) - Run git log dev...HEAD --oneline to see all commits - If no changes detected: report "No changes found relative to dev" and stop - Identify: files modified, files added, files deleted
Determine context: - Read commit messages for intent and scope - Check for Linear issue IDs in branch name or commits (e.g., ARC-123) - Check for referenced specs or briefs - Determine commit type (feat/fix/docs/refactor/perf/test/chore)
Generate description: - Read template: .rulesync/templates/pr-description-template.md - Follow template structure - Fill sections from git diff and commit history: - Title from primary commit or branch name - Summary (2-3 sentences) - Changes (files with descriptions) - Testing (tests added/modified) - Related (Linear issues, specs) - Checklist (mark based on diff analysis) - Omit entirely empty sections
Output: - Output the completed description as raw inline markdown inside a single code fence (```markdown ... ```) - This allows easy copy-paste
Clipboard (best-effort): - Attempt to copy raw markdown to clipboard: pbcopy (macOS) or xclip (Linux) - Report success or "Copy the description above manually"
Summary: - Report: PR title, files changed count, commit type, clipboard status - Suggest: "Ready to create a draft PR? Run /draft-pr"
Create todos at task start:
pr-desc-analyze - "Analyze branch changes"pr-desc-context - "Determine context from commits and branch name"pr-desc-generate - "Generate PR description from template"pr-desc-output - "Output description as markdown code fence"pr-desc-clipboard - "Copy description to clipboard"pr-desc-summary - "Show summary and next steps"Update status: Mark in_progress when starting each, completed when done.
testing
Analyze distributed traces to find blocking queries, N+1 patterns, and missing tRPC encapsulation, then produce prioritized fixes
testing
required reading for all test/spec files or test related queries.
testing
Transform Product Brief into Technical Specification
development
Detect drift between code implementations and specification documents