Agent skill
workbench-sync
Sync workflows for Workbench CLI. Use when aligning local work items with GitHub issues, creating branches, or reconciling doc backlinks.
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/workbench-sync
SKILL.md
Key settings
.workbench/config.json: github.owner, github.repository, github.host, git.defaultBaseBranch.- Ensure
gh auth loginis complete before syncing issues.
Core workflows
- Import missing GitHub issues into local work items.
- Create missing GitHub issues for active work items.
- Create branches for active items.
- Sync doc backlinks and front matter.
Commands
Dry-run sync:
bash
workbench.ps1 sync --dry-run
Sync a specific item and prefer GitHub content:
bash
workbench.ps1 item sync --id TASK-0001 --prefer github
Bulk sync (local wins on conflicts):
bash
workbench.ps1 sync --items
Import unlinked GitHub issues (slower):
bash
workbench.ps1 sync --items --import-issues
Sync doc backlinks (include done items when needed):
bash
workbench.ps1 doc sync --all
workbench.ps1 doc sync --all --include-done
Output
- New work items from GitHub issues.
- New GitHub issues and branches for active work items.
- Updated doc backlinks and front matter.
Guardrails
- Use
--dry-runbefore creating issues or branches. workbench.ps1 syncdefaults to linked work items only; use--import-issuesto pull unlinked GitHub issues.- Terminal items (done/dropped) do not create issues or branches by default.
- Sync is not a replacement for specs/ADRs; create or update them during planning.
Didn't find tool you were looking for?