Agent skill

workbench-sync

Sync workflows for Workbench CLI. Use when aligning local work items with GitHub issues, creating branches, or reconciling doc backlinks.

View SKILL.md on GitHub Repository
Stars 0
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/incursa/workbench/tree/main/.codex/skills/workbench-sync

SKILL.md

Key settings

  • .workbench/config.json: github.owner, github.repository, github.host, git.defaultBaseBranch.
  • Ensure gh auth login is complete before syncing issues.

Core workflows

  1. Import missing GitHub issues into local work items.
  2. Create missing GitHub issues for active work items.
  3. Create branches for active items.
  4. 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 WI-WB-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-run before creating issues or branches.
  • workbench.ps1 sync defaults to linked work items only; use --import-issues to 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.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

incursa/workbench

workbench-github

GitHub workflows for Workbench CLI. Use when creating pull requests from work items or wiring GitHub-specific actions.

0 0
Explore
incursa/workbench

workbench-architecture

Architecture and ADR workflows for Workbench CLI. Use when documenting system design, decisions, tradeoffs, or rationale that must be tracked over time.

0 0
Explore
incursa/workbench

dotnet-build-diagnostics

Capture dotnet environment and CI-style build diagnostics with binlog and summary output.

0 0
Explore
incursa/workbench

dotnet-test-triage

Run dotnet test, capture failed test cases, and generate a rerun filter plus a markdown failure summary. Use when test runs fail and you need a focused rerun command or a compact failure report.

0 0
Explore
incursa/workbench

dotnet-symbol-grep-recipes

Quick ripgrep recipes for common C# navigation tasks in this repo.

0 0
Explore
incursa/workbench

workbench-docs

Documentation workflows for Workbench CLI. Use when creating or updating specs, ADRs, runbooks, guides, or general docs, and when syncing backlinks or change notes.

0 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results