board-man

Manages GitHub Project board operations through serialized gh CLI reads and writes.

Updated May 2, 2026
One-click install
npx skills add https://github.com/whinchman/midi-man-mk3 --skill board-man-whinchman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: board-man
Source: https://github.com/whinchman/midi-man-mk3/tree/main/.claude/skills/board-man
Command: npx skills add https://github.com/whinchman/midi-man-mk3 --skill board-man-whinchman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating multiple agents against a shared GitHub Project board causes race conditions, stale IDs, and duplicated writes. This Skill centralizes all gh project and gh issue operations behind a single subagent that caches board IDs, serializes writes with a lock file, and returns structured JSON results. ## Core Features & Use Cases - Board Reads: List column items, open PRs, tracked issue markers, and fetch the next available task with parallel-safe operations. - Serialized Writes: Create issues, post plan comments, set column status, and apply labels under a flock-style lock to prevent concurrent write conflicts. - ID Caching & Recovery: Cache project, status field, and option IDs in .workflow/temp/ and regenerate them automatically on 422 errors or via refresh-cache. - Use Case: A coordinator agent needs the next READY task while a coder agent marks its issue IN-PROGRESS; both delegate to board-man, which serves the read immediately and serializes the status write safely. ## Quick Start Ask the board-man subagent to run the operation "next-task <repo>" and use the returned JSON issue details to begin work.

Frequently Asked Questions about board-man

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

FAQPage Schema
How do I manage a GitHub Project board from an AI agent?▼

Delegate every board operation to the board-man subagent with a single-line operation string such as "list-column READY" or "set-status 42 IN-PROGRESS". It executes the gh CLI calls and returns a JSON object with the results or an error and exit code.

How to prevent race conditions when multiple agents write to GitHub Projects?▼

Serialize all writes through one interface that acquires a lock file before mutating state. board-man uses a flock-style lock at .workflow/temp/.board-man.lock, polling every 2 seconds and timing out after 30 seconds with exit code 5.

Can GitHub Project board reads run in parallel?▼

Yes, read operations like list-column, next-task, find-issue-by-marker, and download-plan are parallel-safe because they do not mutate board state. Only writes such as create-issue, set-status, and apply-label require the serialization lock.

Why does set-status fail with a 422 error on GitHub Projects?▼

A 422 error means the cached status option ID no longer matches the board, usually after columns are renamed or recreated. board-man detects this and regenerates the cache via refresh-cache before retrying the operation.

Who should invoke the board-man skill?▼

Only other agents such as coordinator, architect, manager, coder, github-triage, and pull-request invoke it when workflow.backend is github_project in agent.yaml. It is not a user-facing skill and should not be called directly by end users.