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 the software development lifecycle by automating GitHub workflows directly through the Workbench CLI. It solves the friction of manual Pull Request creation by allowing developers to generate PRs linked to specific work items, automatically populating descriptions with task metadata, and ensuring project management records are kept in sync with code changes.
Use Cases
- Automated PR Creation: Quickly generate GitHub Pull Requests from the command line using specific task IDs to maintain a tight link between requirements and code.
- Standardized Documentation: Use the --fill flag to automatically pull acceptance criteria and summaries into the PR body, ensuring consistent and high-quality documentation for reviewers.
- Project Management Sync: Automatically update work item front matter with PR links, eliminating the need for manual status updates across different platforms.
- Draft Workflow Management: Create draft Pull Requests for work-in-progress code to facilitate early feedback and collaboration without triggering final CI/CD pipelines.
| 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.