workbench-github
GitHub workflows for Workbench CLI. Use when creating pull requests from work items or wiring GitHub-specific actions.
When & Why to Use This Skill
The workbench-github skill streamlines GitHub workflows by integrating the Workbench CLI directly into the development lifecycle. It automates the transition from task management to version control by allowing developers to create Pull Requests directly from work items, ensuring that PR descriptions are automatically populated with relevant task metadata and acceptance criteria for better traceability and documentation.
Use Cases
- Automated Pull Request Creation: Generate GitHub PRs directly from the command line using work item IDs, reducing manual entry and context switching.
- Standardized PR Documentation: Use the --fill flag to automatically sync task summaries and requirements into the PR body, ensuring consistent and high-quality information for reviewers.
- Project Management Integration: Automatically update work item front matter with PR links to maintain a synchronized record between code changes and project tracking tools.
- Custom Branching Workflows: Configure specific base branches and GitHub hosts to align the CLI tool with enterprise-grade repository structures and branching strategies.
| name | workbench-github |
|---|---|
| description | GitHub workflows for Workbench CLI. Use when creating pull requests from work items or wiring GitHub-specific actions. |
Key settings
.workbench/config.json: github.owner, github.repository, github.host, git.defaultBaseBranch.- Ensure GitHub auth is configured (token or
gh auth login).
Commands
Create a PR from a work item:
workbench github pr create TASK-0001 --fill
Create a draft PR targeting a base branch:
workbench github pr create TASK-0001 --draft --base main --fill
Output
- PR URL printed to stdout or returned in JSON.
- Work item front matter updated with the PR link.
Guardrails
- Prefer
workbench github pr create;workbench pr createis deprecated. - Use
--fillto include the work item summary and acceptance criteria in the PR body.