skills/creating-pull-requests/SKILL.md
Prepare and open pull requests using the team's PR template, including a short PR title, diff-based classification into Features and Fixes, and an approval checkpoint before any push or PR creation. Use when the user asks to create, draft, preview, or open a pull request.
npx skillsauth add ilya-valasiuk/agent-skills creating-pull-requestsInstall 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.
Prepare a PR from the current branch, show a preview, and open it only after explicit approval.
Features or Fixes has no real items, write N/A.main, always use the title Release.Copy this checklist and track progress:
PR Progress:
- [ ] Step 1: Inspect branch and choose base
- [ ] Step 2: Identify main story and work items
- [ ] Step 3: Classify items into Features and Fixes
- [ ] Step 4: Draft title and PR body
- [ ] Step 5: Show preview and wait for approval
- [ ] Step 6: Push and open PR, or provide fallback handoff
Check branch name, status, commits, and diff against the target branch.
Default base: origin/develop
Use another base when:
mainIf the correct base is unclear, ask before finalizing.
Common commands:
git branch --show-current
git status --short
git log --oneline --decorate -n 15
git diff --stat origin/develop...HEAD
git diff origin/develop...HEAD
Summarize what the branch mainly does.
Prefer task names and work item links from:
Use behavior, not filenames.
Features: new or expanded capabilityFixes: corrected broken behavior, regression, or edge caseDo not force refactors or maintenance work into either section unless they are the only changes worth mentioning for reviewer context.
Classification and bullet patterns: see references/REFERENCE.md
Title priority:
Prefer short natural-language titles focused on the main outcome.
Build the PR body using the exact team template from references/TEMPLATES.md.
Before any push or PR creation, show:
Use the preview template from references/TEMPLATES.md, then stop and wait for approval.
After approval:
If GitHub CLI is available, prefer gh pr create.
If PR creation succeeds, use the success response template from references/TEMPLATES.md.
If automatic PR creation is blocked because of missing CLI, invalid auth, sandbox/network restrictions, or unavailable repo tooling, do not stop with an error. Use the fallback response template from references/TEMPLATES.md, and build the compare link using the GitHub format documented in references/REFERENCE.md.
tools
Standardize and preserve Next.js App Router project structure across `src/`, including route files, page composition, API modules, server actions, hooks, providers, helpers, and shared utilities. Use this skill whenever the user asks to add, move, rename, refactor, or review files in a Next.js App Router codebase, especially if the task affects file placement, page architecture, or folder naming.
development
Enforces classNames package usage patterns and Tailwind CSS class ordering conventions in React components. Use this skill whenever writing or reviewing component className props, applying Tailwind classes, using the classnames package, organizing breakpoint-specific styles, writing conditional class expressions, or when the user asks about CSS class ordering, mobile-first responsive patterns, or how to handle className props in components.
testing
Explains how to create and review TypeORM migrations. Use this skill whenever the user wants to change an entity, add or update schema-related database objects, generate a migration, or decide whether a database change should be handled through TypeORM metadata or a custom migration.
development
Builds, restructures, and standardizes React components according to project conventions (placement, folder/file naming, exports, props patterns). Use when adding components or when reorganizing existing components during refactors, migrations, or component moves.