audit-board

Audits a GitHub project board for obsolete issues, clusters, and hygiene problems.

3|3|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/PioneerAIAcademy/cowork-genealogy --skill audit-board-pioneeraiacademy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: audit-board
Source: https://github.com/PioneerAIAcademy/cowork-genealogy/tree/main/.claude/skills/audit-board
Command: npx skills add https://github.com/PioneerAIAcademy/cowork-genealogy --skill audit-board-pioneeraiacademy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large GitHub project boards accumulate stale issues, duplicate clusters, and hygiene problems that per-issue review skills never catch. This Skill reviews the entire open issue pool as a system, verifying every claim against the repository before proposing closures, labels, or corrections. ## Core Features & Use Cases - Obsolescence Detection: Runs eight checks per issue — merged PRs, passing tests, missing cited files, closed blockers, drifted measurements, and code that exists only on unmerged branches. - Cluster Management: Groups issues by shared fix site, gate, or decision, maintains cluster:* labels, and tracks each cluster's next action with a doer and date. - Board Hygiene & Paid-Run Tax: Reports closed issues in active columns, unlabeled items, stalled work, and the eval re-run cost of queued skill edits. - Use Case: Run weekly after merging duplicates and before ranking the backlog, so the board's premises are verified and dead items are dropped before planning. ## Quick Start Ask the assistant to audit the board and report which open issues are obsolete, where the clusters are, and what cross-cutting handling beats the per-issue plans.

Frequently Asked Questions about audit-board

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

FAQPage Schema
How do I audit a GitHub project board for stale issues?▼

Pull the full board and open issue list with the gh CLI using an explicit high limit, then run per-issue obsolescence checks: merged PRs naming the issue, cited files that no longer exist, closed blockers, and drifted measurements. Verify each claim against the repo before proposing closures.

How to find duplicate or clustered issues across a GitHub backlog?▼

Group issues by shared fix site, shared gate, or shared decision rather than subject matter, and record membership as a cluster label so it survives between runs. Read every open issue body in one pass, since clustering depends on what one body says about another.

Why does gh issue list miss issues on large boards?▼

The gh CLI defaults to a limit of 30 and truncates silently, dropping real backlog items with no error. Always pass an explicit --limit well above the board size and confirm the returned count is below the limit before trusting downstream counts.

Can this skill merge or close issues automatically?▼

No. It proposes actions and applies only what the lead approves, using gh issue commands for closes, comments, and labels. Merging duplicates is explicitly delegated to a separate merge-issues skill, and it never edits code or creates branches.

What are the limitations of automated board audits?▼

The audit cannot make prioritization or doctrine decisions, which remain the lead's responsibility, and it cannot judge merge candidates that require semantic comparison. It also depends on accurate issue bodies and may miss work on branches nobody has fetched.