| name | open-pr |
| description | Comprehensive pre-PR validation and pull request creation. Runs type checking (mypy), linting (qlty), tests, coverage validation, generates PR description from template, and creates the PR. Use when ready to open a PR for review. |
| allowed-tools | Bash, Read, Glob, Grep, Write, Task, Agent, Skill |
| skills | ["dancing-bear-rules"] |
Open PR
Delegates to workflows/code/open-pr.yaml via the /workflow skill.
When to Use
- User says "create PR", "open PR", "/open-pr", or similar
- After completing work on a feature branch
- Runs 6-stage comprehensive validation before PR creation
How to Run
Derive the params from context before invoking:
pr_title: use the conventional-commit format — read recent commits with git log origin/main..HEAD --oneline to determine type and scopetest_cmd: check the project's test runner — use python3 -m unittest discover -s tests/<domain>/ -t . -q scoped to the changed domainsource_root: the source directory being changed, e.g. mail/test_path: the corresponding test directory, e.g. tests/mail_tests/min_coverage: default 80 unless the project specifies otherwiseauth_domains: default github,qlty
IMPORTANT: Use the /workflow skill — do NOT call ./bin/workflow run --execute directly.
./bin/workflow run --execute only writes dispatch files and exits immediately (status=pending).
The /workflow skill is what actually spawns agents, waits for results, and handles human gates.
Skill(skill="workflow", args="--workflow workflows/code/open-pr.yaml --params pr_title=<VALUE> --params test_cmd=<VALUE> --params source_root=<VALUE> --params test_path=<VALUE> --params min_coverage=80 --params auth_domains=github,qlty")
Workflow Params
| Param | Default | Description |
|---|
| pr_title | "" | Required: conventional-commit title e.g. "feat(mail): add label sync" |
| test_cmd | "" | Test suite command e.g. "python3 -m unittest discover -s tests/mail_tests/ -t . -q" |
| source_root | "" | Source root for mypy + qlty scoping e.g. "mail/" |
| test_path | "" | Test directory path e.g. "tests/mail_tests/" |
| min_coverage | "80" | Minimum coverage threshold (percent) |
| auth_domains | "github,qlty" | Comma-separated services for pre-flight auth check |
Workflow Stages
- check-auth — verify github and qlty credentials before any work begins
- scan-validate — run mypy, qlty lint, and coverage gate; fix issues in-loop
- generate-description — gather diff + commit metadata and write PR description
- human-gate — present generated description for human review and confirmation
- push-and-create — push branch and create PR via
gh pr create
- fact-check — validate PR description claims against actual diff; report discrepancies
