christopherlouet/claude-base / .claude/skills/work-pr
work-pr
VerifiedCreate a complete and well-documented Pull Request. Use when the user wants to create a PR, submit their changes, or prepare a merge request.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.0 KB |
| examples/pr-example.md | markdown | 3.0 KB |
examples/pr-example.md
View on GitHub# Pull Request Example
## Context
Adding a pagination system for the product list.
## Pre-PR checks
```bash
# State
git status
# On branch feature/pagination
# nothing to commit, working tree clean
# Differences
git diff main...HEAD --stat
# src/components/ProductList.tsx | 45 ++++++++--
# src/hooks/usePagination.ts | 32 +++++++
# src/services/products.ts | 15 ++-
# src/types/pagination.ts | 8 ++
# tests/usePagination.test.ts | 67 ++++++++++++++
# 5 files changed, 158 insertions(+), 9 deletions(-)
# Tests
npm test
# ✅ All tests passed
# Lint
npm run lint
# ✅ No errors
# Build
npm run build
# ✅ Build successful
```
## PR created
### Title
```
feat(products): add pagination to the product list
```
### PR body
```markdown
## Description
Adds a server-side pagination system for the product list,
enabling efficient handling of large catalogs (+10k products).
## Type of change
- [x] New feature (non-breaking change that adds functionality)
- [ ] Bug fix
- [ ] Breaking change
- [ ] Refactoring
## Changes
### Additions
- `src/hooks/usePagination.ts` - Reusable pagination hook
- `src/types/pagination.ts` - TypeScript types for pagination
- `tests/usePagination.test.ts` - Unit tests for the hook
### Modifications
- `src/components/ProductList.tsx` - Pagination integration
- `src/services/products.ts` - Support for page/limit parameters
## How to test
1. Start the application: `npm run dev`
2. Go to `/products`
3. Verify that:
- The list shows 20 products per page
- The "Previous/Next" buttons work
- The URL updates with `?page=X`
- The total counter is displayed
## Tests
- [x] Unit tests added (coverage: 94%)
- [x] Manual tests performed
- [ ] E2E tests (to be added in a follow-up PR)
## Checklist
- [x] My code follows the project conventions
- [x] I did a self-review of my code
- [x] Variable names are explicit
- [x] No leftover `console.log`
- [x] Tests pass locally
- [x] Build successful
## Screenshots
### Before

*Full list loaded at once (slow)*
### After

*20 products per page with navigation*
## Performance
| Metric | Before | After |
|----------|-------|-------|
| Time to First Byte | 2.3s | 0.4s |
| Largest Contentful Paint | 3.1s | 0.8s |
| Data transferred | 2.4MB | 45KB |
## Notes for reviewers
- The `usePagination` hook is generic and can be reused
for other lists (orders, users, etc.)
- I chose 20 items per page based on UX best practices
- Pagination is server-side for performance
Fixes #234
```
### Creation command
```bash
gh pr create \
--title "feat(products): add pagination to the product list" \
--body-file PR_BODY.md \
--base main \
--head feature/pagination \
--reviewer "@team/frontend" \
--label "feature,frontend,needs-review" \
--milestone "v2.1.0"
```
## Result
```
Creating pull request for feature/pagination into main
https://github.com/example/app/pull/456
```
**PR #456 created successfully.**
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |