github-boardslisted
Install: claude install-skill Deocracy/github-boards-skill
# GitHub Boards
Drive a GitHub Projects (v2) Kanban board for the user in plain language, and let other skills record work onto it. This instruction body is **vendor-neutral** (it must mirror to `AGENTS.md` with no rewrite) — all board logic lives in the bundled script, not in this prose.
> **STATUS:** the engine (`scripts/board.mjs`), the verb layer (`scripts/board-manager.mjs`), the ledger pipeline (sync → map → promote), reconcile, and snapshots are implemented and tested. Before first use, configure `board.json` — run `node "<skill-dir>/scripts/board.mjs" doctor` for the setup checklist.
## How to run it
All board operations go through the bundled Node script (never hand-built `gh`/GraphQL — the script carries the safety rules). Invoke it cross-platform with an absolute path:
```
node "<skill-dir>/scripts/board-manager.mjs" <verb> [args] --config <path-to/board.json>
```
If the board isn't configured yet, run `node "<skill-dir>/scripts/board.mjs" doctor` first — it checks `gh`/Node, finds the project/field IDs, and prints the one-time human board-setup checklist.
## The pipeline (which verb when)
```
sources (TODO.md, plans, other skills' artifacts)
└─ sync scan / sync record ─► intent LEDGER ─► map prepare / map record ─► promote plan / promote apply ─► BOARD
maintenance loops:
reconcile scan/apply (drift report → ledger-only healing)