Board Status Skill

Purpose

Automatically fetch and summarize GitHub Project board status when the user asks about sprint progress, what's being worked on, or issue tracking. This is a read-only skill.

When Claude Should Use This

• User asks "what's in progress?"
• User asks "board status"
• User asks "sprint status"
• User asks "what's next to work on?"
• User asks "what's blocked?" or "what's awaiting review?"
• User mentions project tracking

Instructions

Get All Board Items

# Using GraphQL (more reliable - doesn't require read:org scope)
gh api graphql -f query='
  query {
    organization(login: "rollercoaster-dev") {
      projectV2(number: 11) {
        items(first: 100) {
          nodes {
            id
            fieldValueByName(name: "Status") {
              ... on ProjectV2ItemFieldSingleSelectValue { name }
            }
            content {
              ... on Issue { number title assignees(first: 5) { nodes { login } } }
              ... on PullRequest { number title }
            }
          }
        }
      }
    }
  }'

Get Items by Status

Parse the JSON output and filter by status field name (e.g., "In Progress", "Blocked").

Board Configuration

Project: Monorepo Development (#11) URL: https://github.com/orgs/rollercoaster-dev/projects/11

Status Columns

Status	Description	Color
Backlog	Not yet ready (needs triage/prioritization)	Gray
Next	Ready to pick up - dependencies met	Blue
In Progress	Currently being worked on	Yellow
Blocked	PR created, awaiting review	Purple
Done	Merged to main	Green

Project IDs (for updates - use agents, not this skill)

• Project ID:

  PVT_kwDOB1lz3c4BI2yZ

• Status Field ID:

  PVTSSF_lADOB1lz3c4BI2yZzg5MUx4

Status Option IDs:

• Backlog:

  8b7bb58f

• Next:

  266160c2

• In Progress:

  3e320f16

• Blocked:

  51c2af7b

• Done:

  56048761

Output Format

## Board Status

### In Progress (<count>)

- #X: <title> (@assignee)

### Blocked (<count>)

- #X: <title> - PR #Y (awaiting review)

### Next (<count>)

- #X: <title>

### Recently Done (<count>)

- #X: <title> - Merged <date>

Note

This skill is read-only. To update board status, use the

atomic-developer

,

pr-creator

, or

review-handler

agents which have write permissions.