Run GitHub Issues as a Spec, Build, Review and Ship Pipeline with workkit
Use workkit when Claude Code should work a repository's GitHub Issues as a labeled pipeline: capture, triage, spec interview, a subagent build with blind review, owner QA, and a ship step that writes the changelog and releases.
npx skills add agentskillexchange/skills --skill run-github-issues-as-a-spec-build-review-ship-pipeline-with-workkit
claude plugin install workkit@workkit
# Run GitHub Issues as a Spec, Build, Review and Ship Pipeline with workkit
What this skill actually does
Use workkit when a Claude Code session should treat a repository’s GitHub Issues as the single work queue instead of chat history or a local task file. Each issue moves through `status:` labels (inbox, specced, building, qa, complete), and the stage label decides what Claude may do next. An accepted `## Spec` section in the issue body is the go-ahead to build. During the build, the main chat acts as a manager: worker subagents write the code and the tests, and a verifier subagent reviews the diff blind, without seeing how it was made. The finished change waits uncommitted in the working tree until the owner tries it and passes it.
workkit is a Claude Code plugin with nine skills (`workkit:feature`, `workkit:interview`, `workkit:diagnose`, `workkit:review`, `workkit:triage`, `workkit:status`, `workkit:checkpoint`, `workkit:migrate`, `workkit:ship`), five agents and 27 hooks. The hooks guard each step: for example, no code commits until the full test suite has passed on exactly what is being committed. `workkit:ship` writes the CHANGELOG entry in keepachangelog format, commits with Conventional Commits, cuts the release and closes the issue. A repository that has not run `workkit enable` gets none of the hooks.
## Prerequisites
git, the GitHub CLI (`gh`) signed in with `gh auth login`, jq, Node.js with npm (a current LTS release), and the Claude Code CLI. It runs on macOS, Linux, and Windows under Git Bash.
## Installation
Install the plugin from its upstream marketplace:
claude plugin marketplace add ITW-Creative-Works/workkit
claude plugin install workkit@workkit
Start a Claude Code session and run the one setup command it prints. Then turn workkit on in a project:
cd your-project && workkit enable
claude
Inside the session, `/workkit:status` lists the open issues and what each one is waiting on, and `work on #12` starts the pipeline on an issue.
## Documentation
– https://github.com/ITW-Creative-Works/workkit#readme
– https://github.com/ITW-Creative-Works/workkit/blob/main/docs/project-state.md
– https://github.com/ITW-Creative-Works/workkit/blob/main/docs/setup.md
## Source
– https://github.com/ITW-Creative-Works/workkit