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.