update-board

Moves Kanban board tasks through lifecycle transitions and commits board changes to the task branch.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/Zeyad-37/tech-agency --skill update-board-zeyad-37
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-board
Source: https://github.com/Zeyad-37/tech-agency/tree/main/.claude/skills/update-board
Command: npx skills add https://github.com/Zeyad-37/tech-agency --skill update-board-zeyad-37

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a project Kanban board in sync with actual work is error-prone: agents forget transitions, write rows with the wrong column schema, or commit board edits to the wrong branch. This Skill standardizes every task lifecycle transition (In Progress, Blocked, Review, Done) across two board backends so board state always travels with the code it describes. ## Core Features & Use Cases - Dual-backend transitions: On the github backend it swaps status: labels via gh issue edit and relies on Closes #{issue} for Done; on the markdown backend it edits board-context.md with per-column schemas and commits the change on the task branch. - Full lifecycle coverage: Handles Ready → In Progress, In Progress → Blocked, Blocked → In Progress, In Progress → Review, and Review → Done, including metadata like blockers, reviewers, cycle days, and PR links. - Failure recovery: If the Done commit's re-triggered CI run fails, it resets the commit, force-pushes, moves the task back to Review, and hands off to /address-feedback with a 3-iteration cap. - Use Case: An agent finishes implementing task US-042 and says "send to review" — the Skill moves the task to Review, records the reviewer and PR number, and commits the board edit on the feature branch so it merges with the PR. ## Quick Start Ask the agent to update the board by moving task US-042 to Review with PR #47 attached.

Frequently Asked Questions about update-board

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I move a task to Done on a Kanban board in a PR workflow?▼

On the github backend, do nothing — the `Closes #{issue}` line in the PR body closes the issue when the merge lands. On the markdown backend, move the task to Done only at the merge gate, commit board-context.md on the branch, and push before running gh pr merge.

How do I mark a task as blocked on the board?▼

Call the update with the Blocked transition: record the blocker reason, what unblocks it, and the blocked-since date, then notify the coordinating agent. On github this swaps the status label; on markdown it rewrites the row into the Blocked table schema.

What is the difference between the github and markdown board backends?▼

The github backend performs transitions as API writes via gh issue edit label swaps with nothing to commit. The markdown backend edits board-context.md tables with per-column schemas and requires committing the change on the task branch so it merges with the PR.

Can I batch multiple task transitions into one board commit?▼

Only when every task belongs to the same PR, such as one branch closing several tasks together. Never batch transitions for tasks on different branches, because the commit would have to land on main, which the board-in-PR policy forbids.

What happens if CI fails after the Done commit is pushed?▼

Reset the Done commit with git reset --hard HEAD~1, force-push with --force-with-lease, move the task back to Review, and hand the failure to the feedback workflow. This recovery is capped at three iterations before surfacing to the user.