What problem does it solve?
Pull request descriptions often lack critical context, implementation reasoning, and consistent tone, making it hard for reviewers to understand the "why" behind changes and leading to slower, less effective review cycles.
Core Features & Use Cases
- Chalk Voice Alignment: Automatically formats PR titles and descriptions to match the project's standardized chalk voice, ensuring consistent, clear communication across the team.
- Context Synthesis: Distills reasoning from branch commits, conversation history, and tracked issue comments into a coherent narrative, rather than just listing code changes from the diff.
- Edge Case Handling: Automatically includes necessary usage steps for teammates if the change requires manual action, and prompts for clarifying questions if key context is missing from available sources.
- Use Case: For a feature branch adding read-only database secondaries, the skill pulls all chalk session notes from the related GitHub issue to build a PR description that explains tradeoffs, dead ends, and required deployment steps, instead of a generic list of changed files.
Quick Start
Use the pr skill to draft a complete pull request description for your current feature branch, incorporating all relevant context from related issues and commit history.