finish-issue
Prepare a GitHub issue branch for PR with quality checks, cleanup, and review recommendations. Use when user says "finish issue", "ready for PR", "prepare for review", "submit PR", "create PR", "finalize issue", or "wrap up".
When & Why to Use This Skill
The Finish Issue Workflow is a comprehensive Claude skill designed to automate the transition from local development to formal code review. It streamlines the GitHub Pull Request (PR) process by performing automated git rebasing, security secret scanning, code cleanup, and project-specific quality checks like linting and testing. By generating standardized PR descriptions and recommending appropriate reviewers, it ensures high-quality code submissions and accelerates the software development lifecycle (SDLC).
Use Cases
- Automated PR Preparation: Seamlessly rebase feature branches onto the main branch, resolve potential conflicts, and push code to GitHub using standardized workflows.
- Pre-submission Security & Quality Audits: Automatically detect hardcoded secrets, debug statements, and unresolved TODOs while running linters and tests to ensure code health before review.
- Standardized Documentation: Automatically generate professional PR descriptions by synthesizing information from PLANNING.md and commit histories, ensuring reviewers have full context.
- Intelligent Reviewer Assignment: Receive data-driven recommendations for code reviewers based on the specific technical domains impacted by the changes (e.g., Security, Database, or Ops).
| schema_version | "1.0.0" |
|---|---|
| name | finish-issue |
| title | Finish Issue Workflow |
| version | "1.0.0" |
| status | stable |
| objective | Prepare a GitHub issue branch for PR with quality checks, cleanup, and review recommendations |
| description | Prepare a GitHub issue branch for PR with quality checks, cleanup, and review recommendations. |
| - name | Dossier Community |
| algorithm | sha256 |
| hash | 7f81210beb8488fe5b8c2f3002a48c23331d4cbf726824154d0515b7d25a2d44 |
Finish Issue Workflow
When the user wants to finalize their work on a GitHub issue and prepare a PR:
Prerequisites
- dossier-tools installed (
pip install dossier-tools) - On a feature/bug branch (not main/master)
- GitHub CLI (
gh) authenticated
Steps
- Verify we're on a feature/bug branch (not main/master)
- Run the finish workflow:
dossier run imboard-ai/development/git/finish-issue-workflow - Respond to prompts for each check category
- Confirm successful PR creation with the user
What This Does
- Git prep: Fetch latest, rebase onto main, check for conflicts
- Security scans: Detect secrets, hardcoded paths, files that should be gitignored
- Code cleanup: Find debug statements, commented code, unresolved TODOs
- Project checks: Run linter, formatter, type checker, tests
- Review recommendations: Suggest reviewers based on changed files (security, DB, ops, etc.)
- PR creation: Generate description from PLANNING.md + commits, link to issue, push and create PR