nx-scorecard

name	nx-scorecard
description	Compute Nx CLI scorecard metrics for a month: GitHub issues/PRs (nrwl/nx), Linear high-priority misc issues, and npm download counts with YoY growth. Outputs a Notion-ready markdown table. Use when user says "scorecard", "nx scorecard", "cli scorecard", "monthly scorecard", or asks for the Nx CLI team's monthly issue/PR/download metrics.
allowed-tools	["Bash","WebFetch","mcp__linear-server__list_issues","mcp__linear-server__list_teams"]

Nx CLI Scorecard

Compute all scorecard metrics for the Nx CLI team for the current month (or the month specified in the user's request / $ARGUMENTS).

Determine Target Month

• If the request contains a month (e.g., "March", "2026-03", "Feb 2026"), use that month.
• Otherwise, use the current month based on today's date.
• Derive: YEAR, MONTH_NUM (zero-padded), MONTH_NAME, FIRST_DAY (YYYY-MM-01), LAST_DAY (YYYY-MM-last day of month).
• For partial months (current month not yet ended), use today's date as the end date for closed issues.

GitHub Auth (no gh CLI)

Either gh or curl against https://api.github.com with a bearer token works. For the curl path, get the token from 1Password:

export GITHUB_TOKEN="$(op read 'op://Employee/API Keys/github_token')"

Reusable curl helper for the GitHub search API (returns total_count):

gh_count() {  # $1 = url-encoded q value
  curl -sS --fail \
    -H "Authorization: Bearer $GITHUB_TOKEN" \
    -H "Accept: application/vnd.github+json" \
    -H "X-GitHub-Api-Version: 2022-11-28" \
    "https://api.github.com/search/issues?q=$1&per_page=1" | jq '.total_count'
}

GitHub's search q must be URL-encoded (spaces -> + is fine in a query, but : and quotes in label filters need encoding). Build each query string and pass it to gh_count.

Data Collection

Run queries in parallel where possible.

1. GitHub Issues (nrwl/nx)

All use is:issue. Replace {FIRST_DAY}/{LAST_DAY} with the target month bounds.

• Open issues (snapshot): repo:nrwl/nx is:issue state:open created:2017-09-01..{LAST_DAY}
• Open issues created this month: repo:nrwl/nx is:issue state:open created:{FIRST_DAY}..{LAST_DAY}
• Open high-priority (snapshot): repo:nrwl/nx is:issue state:open created:2017-09-01..{LAST_DAY} label:"priority: high"
• Open high-priority created this month: repo:nrwl/nx is:issue state:open created:{FIRST_DAY}..{LAST_DAY} label:"priority: high"
• Closed issues (during month): repo:nrwl/nx is:issue state:closed closed:{FIRST_DAY}..{LAST_DAY}
• Closed high-priority (during month): repo:nrwl/nx is:issue state:closed closed:{FIRST_DAY}..{LAST_DAY} label:"priority: high"

2. GitHub PRs (nrwl/nx)

Count only non-draft PRs (draft:false).

• Open non-draft PRs (snapshot): repo:nrwl/nx is:pr state:open draft:false
• Open non-draft PRs created this month: repo:nrwl/nx is:pr state:open draft:false created:{FIRST_DAY}..{LAST_DAY}

3. Linear High-Priority Misc Issues

Nx CLI team issues in the "Miscellaneous" project OR no project, with Urgent (priority=1) or High (priority=2) priority, in an active state (not Done/Cancelled).

Strategy: Query ALL open Nx CLI urgent+high issues, then filter in post-processing. More reliable than querying "no project" directly.

Confirm the team first (mcp__linear-server__list_teams -> "Nx CLI"). Then run these 4 queries in parallel via mcp__linear-server__list_issues:

1. team: "Nx CLI", priority: 1, state: "started", limit: 250
2. team: "Nx CLI", priority: 2, state: "started", limit: 250
3. team: "Nx CLI", priority: 1, state: "unstarted", limit: 250
4. team: "Nx CLI", priority: 2, state: "unstarted", limit: 250

From the combined results, keep only issues where project is "Miscellaneous" OR project is null/empty/missing. Deduplicate by issue id and count unique issues.

4. npm Downloads

# Current month
curl -s "https://api.npmjs.org/downloads/point/{FIRST_DAY}:{LAST_DAY}/nx" | jq '.downloads'
# Same month last year (YoY)
curl -s "https://api.npmjs.org/downloads/point/{LAST_YEAR_FIRST_DAY}:{LAST_YEAR_LAST_DAY}/nx" | jq '.downloads'

YoY growth: (this_month - same_month_last_year) / same_month_last_year * 100, rounded to nearest whole percent. If the current month is incomplete, note the YoY comparison is partial.

Output Format

## Nx CLI Scorecard — {MONTH_NAME} {YEAR}

| Metric | Value |
|--------|-------|
| Open issues | {total} ({this_month} this month) |
| Open high-priority issues | {total} ({this_month} this month) |
| Closed issues | {count} |
| Closed high-priority issues | {count} |
| Open Linear high-priority misc issues | {count} |
| Non-draft PRs (open) | {total} ({this_month} this month) |
| Total monthly downloads | {formatted, e.g. 36.0M} |
| YoY growth (monthly downloads) | {percent}% |

Format downloads in millions with one decimal (e.g., 33.2M, 36.0M).

If the month is not yet complete, add a note: *Data as of {TODAY}. Month in progress.*

Important Notes

• GitHub search API has rate limits. On a rate-limit response, wait and retry once.
• "Open issues" snapshot: if running mid-month, use today's date as the upper bound instead of LAST_DAY.
• The creation floor 2017-09-01 filters out ancient pre-active issues.
• Do NOT include PRs in issue counts (is:issue in all issue queries).