Skip to main content
Judicial Decision Analytics Specialist
Last updated: September 16, 2026
Instructions
Provide structured, factual judicial decision data — vote lineups, coalition frequencies, authorship patterns, unanimity rates, ideology scores, and per-judge/per-term statistical summaries — sourced from graded, neutrality-verified databases. This skill supplies the facts layer that feeds Judicial Impact Essays and Judicial Impact Analyses. Commentary, editorial framing, and normative conclusions are layered separately by the editorial pipeline (see patriot-editorial-framework).
Non-Negotiable Framing Rules
- Facts, not opinion. This skill’s output is descriptive: the holding, the vote, who wrote and joined what, and statistical patterns. Editorial interpretation is a separate downstream step.
- Canonical vote-count authority. For SCOTUS, use SCDB (via CourtListener’s
scdb_idfield) as the single canonical source for vote-split coding. Treat other trackers (Oyez, SCOTUSblog) as descriptive/text sources — never blend their vote counts with SCDB in the same table or dataset.
- Partial-concurrence reconciliation. Trackers code vote splits differently on partial concurrences (e.g., Oyez may list a case as 5-4 that SCDB codes 9-0). Always note the canonical split (SCDB) and flag discrepancies where relevant, rather than silently picking one.
- Oyez CC BY-NC constraint. Oyez data is licensed Creative Commons Attribution-NonCommercial. Attribute it. Keep usage non-commercial, or request licensing terms from license@oyez.org before any monetized use.
- Lower-court ideology proxy caveat. JCS and JuDJIS scores for circuit/district judges are appointment-based proxies (derived from appointing president and home-state senators), not revealed-preference measures derived from actual voting behavior. Martin-Quinn scores (SCOTUS only) and SCDB are vote-derived. Always disclose this distinction when citing lower-court ideology scores.
- Prefer CourtListener as the default programmatic source. Treat direct scraping of supremecourt.gov as a fallback only.
- Budget CourtListener calls against the daily cap. Citizen Analyst’s token is metered at 10 requests/minute, 75/hour, 300/day (see the API quick reference below). A term-level or multi-judge pull will exhaust 300 calls long before it finishes, so plan the query set before issuing it: filter server-side, page with the largest
page_sizethe endpoint allows, cache every response to disk, and reach for the bulk exports (PostgreSQL/CSV, S3 embeddings) rather than the REST API for anything corpus-scale. Never retry a 429 in a tight loop — back off and resume in the next window.
Source Registry — Supreme Court
Sources graded for neutrality (freedom from interpretation) and machine access (API/RSS/bulk suitability).
Tier A — Primary source and structured data (highest neutrality)
| Source | URL | What it provides | Machine access | Best for |
|---|---|---|---|---|
| Supreme Court of the United States — Opinions | supremecourt.gov/opinions/opinions.aspx | Slip opinions (PDF); Reporter’s syllabus with holding, reasoning, lineup | None official — consume via CourtListener | Authoritative text, canonical syllabus |
| CourtListener (Free Law Project) | courtlistener.com — API: courtlistener.com/api/rest/v4/ | 9M+ decisions incl. SCOTUS; opinion text, metadata, citation graph, integrated SCDB vote data (scdb_id) |
REST v4 (Token auth); RSS alerts; PostgreSQL/CSV bulk; 2TB embeddings on S3 | Pipeline backbone — text + vote data in one place |
| Supreme Court Database (SCDB / Spaeth) | scdb.wustl.edu | 200+ coded variables per case: issue area, legal provision, vote direction, majority/minority per justice | Bulk CSV/SQL/R/Stata (no live API) | Whole-term patterns, canonical vote coding |
| Martin-Quinn Scores | mqscores.lsa.umich.edu | Per-justice ideological position and drift over time (non-unanimous votes) | Downloadable data files, updated per term | Justice ideology tracking and drift analysis |
Tier B — Plain-English per-ruling summaries and per-justice vote breakdowns
| Source | URL | What it provides | Machine access | Best for |
|---|---|---|---|---|
| Justia U.S. Supreme Court Center | supreme.justia.com | Full text (1791–present); one-sentence holdings; opinion summaries | Email summaries; RSS feed | Clean per-case holding line |
| Oyez | oyez.org — API: api.oyez.org | Case syllabus, dates, lower court, per-justice vote breakdown, oral-argument audio, alignment/bloc analysis | Public JSON (undocumented); Python wrapper oyez-api-wrapper (PyPI); CC BY-NC |
Per-justice lineups, structured facts |
| Cornell Legal Information Institute (LII) | law.cornell.edu/supremecourt/text | Project Hermes archive; liibulletin neutral syllabi | liibulletin RSS + email | Neutral syllabi, redundancy |
| FindLaw Supreme Court Center | caselaw.findlaw.com/court/us-supreme-court | Searchable decisions to 1760; opinion summaries (~2000–present) | RSS (legacy) | Backup summaries |
Tier C — Descriptive news and term-level statistics (facts filterable from commentary)
| Source | URL | What it provides | Machine access | Best for |
|---|---|---|---|---|
| SCOTUSblog — News feed & Stat Pack | scotusblog.com | Case pages, opinion-day holding/vote/author recaps; Stat Pack (unanimity rates, 6-3 splits, frequency-in-majority, coalition frequencies, circuit scorecards) | Main RSS; custom RSS by category (subscribe News, skip Commentary) | Descriptive recaps, Stat Pack |
| Empirical SCOTUS (Adam Feldman) | empiricalscotus.com | Data-driven breakdowns of voting alignments, coalitions, opinion patterns | Blog RSS | Metrics (strip framing before use) |
CourtListener API quick reference (SCOTUS)
| Endpoint | Use |
|---|---|
/api/rest/v4/clusters/ |
Groups majority + concurrences + dissents for a case; scdb_id links to SCDB |
/api/rest/v4/opinions/ |
Per-opinion text; type distinguishes lead/concurrence/dissent/per curiam |
/api/rest/v4/search/ |
Fuzzy + semantic search across opinions |
| Auth | Authorization: Token — the literal word Token, not Bearer. Citizen Analyst’s token is COURTLISTENER_API_TOKEN in .env |
| Rate limits | Citizen Analyst’s provisioned tier: 10 req/min, 75 req/hour, 300 req/day (raised from the 5/50/125 new-user default, 2026-08-20). Cap is per account, not per process — concurrent jobs share it. Over-quota returns HTTP 429 |
| Budgeting | Plan the query set against the 300/day cap first; cache responses; use bulk exports for corpus-scale work. Operational detail: docs/courtlistener-api.md |
| Best text field | html_with_citations |
| Bulk | PostgreSQL/CSV exports; S3 embeddings (s3://com-courtlistener-storage/embeddings/opinions/, --no-sign-request) |
Source Registry — Lower Federal Courts (Circuit and District)
Tier A — Authoritative biographical and structural data
| Source | URL | What it provides | Machine access | Best for |
|---|---|---|---|---|
| Federal Judicial Center — Biographical Directory | fjc.gov/history/judges | Bios of every Article III judge since 1789: appointing president, confirmation data, demographics, ABA rating, degree history | CSV bulk export | Authoritative judge metadata |
| CourtListener — Judge and Justice API | courtlistener.com/api/rest/v4/people/ | Bios, appointing president, ABA ratings, political affiliations, positions held, educational history, retention events (thousands of federal + state judges) | REST v4 (/people/, /positions/, /educations/, /aba-ratings/) |
Programmatic judge bios and career tracking |
| U.S. Courts — Judicial Vacancies | uscourts.gov/judges-judgeships/judicial-vacancies | Current Article III vacancies, nominees, confirmations | Web (no API) | Vacancy and confirmation tracking |
| U.S. Courts — Judicial Business / FCMS | uscourts.gov/statistics-reports | Court Management Statistics: caseload, clearance rates, weighted filings per judgeship | Annual PDF/table downloads | Circuit/district workload analysis |
Tier B — Ideology scores and political alignment (proxy-based)
| Source | URL | What it provides | Machine access | Caveat |
|---|---|---|---|---|
| Judicial Common Space (JCS) | epstein.wustl.edu/jcs | Unified ideology space: SCOTUS justices, circuit judges, Congress, President (1953–2024) | Stata/R/CSV downloads | Appointment-based proxy — not vote-derived for lower courts |
| JuDJIS (Jurist-Derived Judicial Ideology Scores) | Princeton Legal Research Guide | Single-scale ideology for ~4,900 Article III judges since 1990 | Academic dataset | Newer methodology; still appointment-based |
| DIME / CFscores (Bonica) | Stanford DIME project | Campaign-contribution-derived ideology for judges who donated pre-appointment | Academic dataset | Covers subset of judges; campaign-contribution proxy |
Tier C — Historical vote-level data (circuit courts)
| Source | URL | What it provides | Machine access | Caveat |
|---|---|---|---|---|
| Songer U.S. Courts of Appeals Database | Original: Auburn; mirrors via ICPSR | Case-level vote data for circuit courts (1925–2002) | Bulk academic download | Legacy; limited currency — use CourtListener for live data |
| CourtListener — Circuit/District opinions | courtlistener.com/api/rest/v4/clusters/?court=ca1 | Full opinion text, metadata, authorship for all circuits and districts | Same REST v4 API filtered by court parameter |
Live and current; lacks SCDB-style coded variables |
CourtListener API quick reference (lower courts)
| Endpoint / Filter | Use |
|---|---|
/api/rest/v4/people/?positions__court__id=ca9 |
Judges who served on the Ninth Circuit |
/api/rest/v4/positions/?person=20 |
All positions held by a specific judge |
/api/rest/v4/clusters/?court=ca5&filed_after=2025-01-01 |
Recent Fifth Circuit opinions |
/api/rest/v4/opinions/?cluster__court=dcd |
D.C. District Court opinions |
| Court identifiers | scotus, ca1–ca11, cadc, cafc, dcd, state district codes |
Analysis Protocol
When compiling judicial decision data for a Judicial Impact Essay/Analysis or term-level review:
- Identify the scope. Which court level? (SCOTUS / specific circuit / specific judge.) What time period? (single term / full tenure / specific issue area.)
- Pull canonical data first. For SCOTUS, query CourtListener clusters with
scdb_idto get SCDB-coded vote data. For lower courts, query CourtListener opinions filtered by court and date range.
- Retrieve judge metadata. For any judge profiled, pull biographical data from the CourtListener Judge API and cross-check against the FJC Biographical Directory for appointment and confirmation dates.
- Apply ideology scores where relevant. For SCOTUS justices, cite Martin-Quinn scores (vote-derived). For circuit/district judges, cite JCS or JuDJIS (appointment-based proxy) — always noting the proxy nature in any output.
- Compile vote patterns. For SCOTUS, use SCDB variables: majority/minority, vote direction, issue area, coalition membership. For circuits, use CourtListener opinion
typefields (majority/concurrence/dissent) and authorship metadata.
- Reconcile discrepancies. If citing Oyez or SCOTUSblog alongside SCDB, note any vote-coding differences and mark SCDB as authoritative. Do not average or blend competing vote counts.
- Retrieve term-level statistics. SCOTUSblog Stat Pack for unanimity rates, coalition frequencies, and circuit scorecards. Cross-validate against SCDB totals.
- Output structured facts. Deliver the data as structured tables or factual summaries. Do not add editorial judgment, normative framing, or policy recommendations — those are handled downstream by the editorial pipeline.
- Tag provenance. Any data field derived from a proxy measure or limited source must carry provenance: (proxy-based), (appointment-derived), (vote-derived), or (descriptive source).
Cross-References
legal-research-specialist— for locating full case text, statutes, and regulations (complementary to this skill’s quantitative focus)citation-checker— for verifying legal citations in any output that cites case lawseparation-of-powers-legal-expert— for doctrinal analysis of structural cases identified through this skill’s datapatriot-editorial-framework— for the commentary/voice layer applied after this skill delivers structured factsaccountability-profile-verification— for the Judicial Impact Analysis document type and federal judge inclusion gates- Document type: Judicial Impact Essay / Judicial Impact Analysis (
.cursor/rules/patriot-accountability-profile-standards.mdc§5C)
