| 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() {
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:
team: "Nx CLI", priority: 1, state: "started", limit: 250team: "Nx CLI", priority: 2, state: "started", limit: 250team: "Nx CLI", priority: 1, state: "unstarted", limit: 250team: "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
curl -s "https://api.npmjs.org/downloads/point/{FIRST_DAY}:{LAST_DAY}/nx" | jq '.downloads'
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).
