Tw Legal RAG
aa0101181514/tw-legal-rag
Retrieve real Taiwan court judgments with verifiable citations before answering any question about Taiwan law or case law.
Legal case law database with PACER data and judge profiles. An agent skill from wentorai/research-plugins.
Install Courtlistener API
$ npx skills add wentorai/research-plugins --skill courtlistener-api -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install wentorai/research-plugins courtlistener-api --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/domains/law/courtlistener-api .claude/skills/courtlistener-api && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "courtlistener-api" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/domains/law/courtlistener-api into .claude/skills/courtlistener-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "courtlistener-api", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/wentorai/research-plugins/tree/main/skills/domains/law/courtlistener-apiType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add wentorai/research-plugins --skill courtlistener-api -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install wentorai/research-plugins courtlistener-api --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/domains/law/courtlistener-api .agents/skills/courtlistener-api && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "courtlistener-api" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/domains/law/courtlistener-api into .agents/skills/courtlistener-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "courtlistener-api", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add wentorai/research-plugins --skill courtlistener-api -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install wentorai/research-plugins courtlistener-api --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/domains/law/courtlistener-api .cursor/skills/courtlistener-api && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "courtlistener-api" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/domains/law/courtlistener-api into .cursor/skills/courtlistener-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "courtlistener-api", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/wentorai/research-plugins.git --path skills/domains/law/courtlistener-api--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add wentorai/research-plugins --skill courtlistener-api -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install wentorai/research-plugins courtlistener-api --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/domains/law/courtlistener-api .gemini/skills/courtlistener-api && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "courtlistener-api" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/domains/law/courtlistener-api into .gemini/skills/courtlistener-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "courtlistener-api", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install wentorai/research-plugins courtlistener-apiInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add wentorai/research-plugins --skill courtlistener-api -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/domains/law/courtlistener-api .github/skills/courtlistener-api && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "courtlistener-api" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/domains/law/courtlistener-api into .github/skills/courtlistener-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "courtlistener-api", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add wentorai/research-plugins --skill courtlistener-api -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install wentorai/research-plugins courtlistener-api --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/wentorai/research-plugins.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/domains/law/courtlistener-api .opencode/skills/courtlistener-api && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "courtlistener-api" agent skill from https://github.com/wentorai/research-plugins/tree/main/skills/domains/law/courtlistener-api into .opencode/skills/courtlistener-api/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "courtlistener-api", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
courtlistener-api- GitHub stars
- 298
- Used in
- 1 other repo
- Token cost
- ~2.5k tokens
- SKILL.md length
- 741 words
- Files
- 1
- Skills in repo
- 405
- Repo updated
- First seen
- Licence
- MIT
At a glance
Legal case law database with PACER data and judge profiles. An agent skill from wentorai/research-plugins.
- Works in 4 steps: Create a free account at… → Navigate to your profile settings → Generate an API token → …
- Tasks that involve Legal research
- SKILL.md covers Overview, Authentication, Core Endpoints and Rate Limits, plus 2 more sections
- Calls curl; reaches courtlistener.com
What it does
Courtlistener API is an agent skill from wentorai/research-plugins. Legal case law database with PACER data and judge profiles
Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Legal & Compliance, covering Legal research. The repository describes itself as: 350+ academic research skills, MCP configs, and plugins for Research-Claw and AI agents. The licence is MIT.
When your agent uses it
- Tasks that involve Legal research
Example prompts
- “/courtlistener-api”
Requirements
- Python 3
- A credential in YOUR_TOKEN
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- Create a free account at https://www.courtlistener.com/
- Navigate to your profile settings
- Generate an API token
- Include it in the Authorization header
What it can do on your machine
Read from SKILL.md and the folder at commit bf44b3c. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
curl
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
courtlistener.com
Also links to:
free.law
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Courtlistener API loads about 2.5k tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 741 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from wentorai/research-plugins at commit bf44b3c, republished under its MIT licence (© wentorai). 741 words, ~2,450 tokens.
Download SKILL.mdSave it as
.claude/skills/courtlistener-api/SKILL.md (or your agent's skills folder).- name
- courtlistener-api
- description
- Legal case law database with PACER data and judge profiles
CourtListener API Guide
Overview
CourtListener is a free legal research platform operated by Free Law Project, a non-profit organization dedicated to making legal data freely accessible. The platform hosts one of the largest open collections of U.S. case law, containing millions of court opinions, docket entries, oral arguments, and judge profiles sourced from PACER (Public Access to Court Electronic Records), state court websites, and historical digitization efforts.
The CourtListener REST API provides programmatic access to this extensive legal database, enabling searches across court opinions, dockets, judge biographical data, and court information. The API covers federal courts (Supreme Court, Circuit Courts, District Courts, Bankruptcy Courts) and many state courts, with records spanning from the founding of the republic to the present day.
Legal scholars, law students, practicing attorneys, journalists, policy researchers, and civic technologists use the CourtListener API to conduct legal research, perform empirical legal studies, build litigation analytics tools, track judicial behavior, monitor active litigation, and analyze trends in case law. It serves as a critical resource for computational legal studies and access-to-justice initiatives.
Authentication
No authentication is required for basic API access. The CourtListener API is publicly accessible for read operations. However, creating an account and using an API token provides higher rate limits and access to additional features. Authentication is recommended for production applications.
To obtain an API token:
- Create a free account at https://www.courtlistener.com/
- Navigate to your profile settings
- Generate an API token
- Include it in the
Authorizationheader
# Unauthenticated request
curl "https://www.courtlistener.com/api/rest/v4/opinions/?q=first+amendment"
# Authenticated request (higher rate limits)
curl -H "Authorization: Token YOUR_TOKEN" \
"https://www.courtlistener.com/api/rest/v4/opinions/?q=first+amendment"Core Endpoints
opinions: Search Court Opinions
Search and retrieve the full text of court opinions (judicial decisions) across all indexed courts.
- URL:
GET https://www.courtlistener.com/api/rest/v4/opinions/ - Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | No | Full-text search query |
| court | string | No | Court identifier (e.g., scotus, ca9) |
| date_filed_min | string | No | Minimum filing date (YYYY-MM-DD) |
| date_filed_max | string | No | Maximum filing date (YYYY-MM-DD) |
| type | string | No | Opinion type: 010combined, 020lead, etc. |
| ordering | string | No | Sort order: date_filed, -date_filed |
| page | int | No | Page number for pagination |
- Example:
curl "https://www.courtlistener.com/api/rest/v4/opinions/?q=privacy+fourth+amendment&court=scotus&ordering=-date_filed"- Response: Returns paginated results with
count,next,previous, andresultsarray. Each opinion includesid,absolute_url,cluster(case metadata),author(judge),type,date_filed,plain_textorhtml(opinion text),download_url, andcitations.
dockets: Access Case Dockets
Search and retrieve docket information including case metadata, parties, attorneys, and docket entries from PACER and other sources.
- URL:
GET https://www.courtlistener.com/api/rest/v4/dockets/ - Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | No | Full-text search query |
| court | string | No | Court identifier |
| date_filed_min | string | No | Minimum filing date |
| date_filed_max | string | No | Maximum filing date |
| case_name | string | No | Filter by case name |
| docket_number | string | No | Filter by docket number |
| ordering | string | No | Sort order field |
- Example:
curl "https://www.courtlistener.com/api/rest/v4/dockets/?q=antitrust&court=scotus&ordering=-date_filed"- Response: Returns
count,resultsarray withid,case_name,docket_number,court,date_filed,date_terminated,nature_of_suit,assigned_to(judge),referred_to, anddocket_entries.
Show full SKILL.md (292 more words)Show less
courts: Court Information
Retrieve information about courts in the CourtListener database, including jurisdiction, location, and identifiers.
- URL:
GET https://www.courtlistener.com/api/rest/v4/courts/ - Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| jurisdiction | string | No | Filter by jurisdiction type: F (federal), S (state) |
- Example:
curl "https://www.courtlistener.com/api/rest/v4/courts/?jurisdiction=F"- Response: Returns court objects with
id,full_name,short_name,jurisdiction,position,start_date,end_date, andurl.
people: Judge Profiles
Access biographical and professional information about judges, including their appointment history, education, and political affiliations.
- URL:
GET https://www.courtlistener.com/api/rest/v4/people/ - Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | No | Name search query |
| court | string | No | Filter by court served |
| appointer | int | No | Filter by appointing authority |
- Example:
curl "https://www.courtlistener.com/api/rest/v4/people/?q=ginsburg"- Response: Returns judge profiles with
id,name_first,name_last,date_of_birth,gender,positions(court appointments with dates),education,political_affiliations, andaba_ratings.
search: Unified Search
Perform a unified full-text search across all CourtListener content types.
- URL:
GET https://www.courtlistener.com/api/rest/v4/search/ - Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | Yes | Search query |
| type | string | No | Content type: o (opinions), r (RECAP), oa (oral arguments) |
- Example:
curl "https://www.courtlistener.com/api/rest/v4/search/?q=net+neutrality&type=o"- Response: Returns unified search results with relevance scoring across content types.
Rate Limits
The CourtListener API allows up to 5,000 requests per hour for unauthenticated users. Authenticated users with API tokens receive higher limits. The API returns standard HTTP 429 responses when limits are exceeded. For bulk data access, CourtListener provides downloadable bulk data files at https://www.courtlistener.com/api/bulk-info/ which are more appropriate for large-scale research projects. The bulk data includes complete opinion texts, docket metadata, and judge biographical data.
Common Patterns
Track Recent Supreme Court Opinions
Monitor new opinions from the Supreme Court of the United States:
import requests
params = {
"court": "scotus",
"ordering": "-date_filed",
"page_size": 10
}
resp = requests.get("https://www.courtlistener.com/api/rest/v4/opinions/", params=params)
data = resp.json()
for opinion in data["results"]:
cluster = opinion.get("cluster", {})
print(f"{opinion['date_filed']}: {cluster.get('case_name', 'Unknown')}")Empirical Analysis of Judicial Citations
Study citation patterns across courts and time periods:
import requests
params = {
"q": "stare decisis",
"court": "scotus",
"date_filed_min": "2020-01-01",
"ordering": "-date_filed"
}
resp = requests.get("https://www.courtlistener.com/api/rest/v4/search/", params={**params, "type": "o"})
results = resp.json()
print(f"Found {results['count']} opinions mentioning 'stare decisis' since 2020")Judge Appointment Analysis
Research judicial appointments and their characteristics:
curl "https://www.courtlistener.com/api/rest/v4/people/?court=scotus&ordering=-date_nominated"References
- Official API documentation: https://www.courtlistener.com/api/rest-info/
- CourtListener homepage: https://www.courtlistener.com/
- Bulk data downloads: https://www.courtlistener.com/api/bulk-info/
- Free Law Project: https://free.law/
- RECAP Archive: https://www.courtlistener.com/recap/
© wentorai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/domains/law/courtlistener-api of wentorai/research-plugins.
Open the folder on GitHubat commit bf44b3c
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in wentorai/research-plugins, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Courtlistener API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Courtlistener API this skillwentorai/research-plugins | 298 | 1 repos | ~2.5k | Automated safety check: Pass | MIT | |
| Tw Legal RAGaa0101181514/tw-legal-rag | 328 | — | ~580 | Automated safety check: Pass | Custom licence | |
| Design Award SearchSeanJ1ang/design-judge-skills | 712 | — | ~3k | Automated safety check: Pass | Apache-2.0 | |
| China Lawyer AnalystCSlawyer1985/china-lawyer-analyst | 196 | — | ~3.3k | Automated safety check: Pass | None | |
| Billing And Litigation BudgetTHUYRan/Legal-Skills-Chinese | 874 | — | ~5k | Automated safety check: Pass | None | |
| Legal Issue ResearchGolden2002/legal-research-skill | 156 | — | ~6.8k | Automated safety check: Pass | MIT |
Similar skills
Design Award Search
SeanJ1ang/design-judge-skills
Find and verify award-winning designs in the same or adjacent functional category through eight explicit relevance dimensions: problem and user, core function, sensing technology, intervention…
China Lawyer Analyst
CSlawyer1985/china-lawyer-analyst
通过中国法律视角分析事件，运用成文法解释、指导案例参照、请求权基础分析等方法， 理解权利义务、评估责任风险、识别法律依据并推荐合规策略。
Billing And Litigation Budget
THUYRan/Legal-Skills-Chinese
A skill your agent uses when the user needs to track or manage attorney hours, expert fees, and investigation costs; control litigation spend; or prepare timesheets or expense statements for clients.
Legal Issue Research
Golden2002/legal-research-skill
中国法律全领域系统性检索专家. An agent skill from Golden2002/legal-research-skill.
Tax Law Research
Serein-81/financial_rag
Searches current Chinese tax laws, rates and policy changes with Tavily web search, prioritizing government sources and flagging outdated or conflicting results.
More from wentorai/research-plugins
All 405 skills in this repoAbstract Writing Guide
wentorai/research-plugins
Craft structured research abstracts that maximize clarity and journal acceptance
Academic Citation Manager
wentorai/research-plugins
Manage academic citations across BibTeX, APA, MLA, and Chicago formats
Academic Paper Summarizer
wentorai/research-plugins
Summarize academic papers with structured extraction of key elements
Academic Study Methods
wentorai/research-plugins
Evidence-based study techniques for academic learning and retention
Academic Tone Guide
wentorai/research-plugins
Adjust writing tone and register for academic audiences and venues
Academic Translation Guide
wentorai/research-plugins
Academic translation, post-editing, and Chinglish correction guide
Related
Categories
Questions about Courtlistener API
What does Courtlistener API do?
Legal case law database with PACER data and judge profiles. An agent skill from wentorai/research-plugins. Courtlistener API is an agent skill from wentorai/research-plugins.
When should I use Courtlistener API?
Courtlistener API fits situations like: tasks that involve Legal research.
How do I install Courtlistener API in Claude Code?
Run `npx skills add wentorai/research-plugins --skill courtlistener-api -a claude-code`. Or copy the skill folder (skills/domains/law/courtlistener-api in wentorai/research-plugins) into .claude/skills/courtlistener-api in your project. Claude Code loads it when a task matches its description.
How do I install Courtlistener API in Codex?
Run `npx skills add wentorai/research-plugins --skill courtlistener-api -a codex`. Or copy the skill folder (skills/domains/law/courtlistener-api in wentorai/research-plugins) into .agents/skills/courtlistener-api in your project. Codex loads it when a task matches its description.
Can I use Courtlistener API in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add wentorai/research-plugins --skill courtlistener-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/courtlistener-api, .gemini/skills/courtlistener-api, .github/skills/courtlistener-api and .opencode/skills/courtlistener-api in your project.
What does Courtlistener API need to run?
Going by SKILL.md and its folder, Courtlistener API needs the command-line tools its instructions call (curl). Our summary lists: Python 3; A credential in YOUR_TOKEN.
Does Courtlistener API access the network?
SKILL.md names 2 domains. In commands or code: courtlistener.com; the agent is likely to contact it when it follows the instructions. As links in the text: free.law. This is read from the text; nothing was executed.
Is Courtlistener API safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Courtlistener API use?
Courtlistener API is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Courtlistener API use?
About 2.5k tokens (SKILL.md is roughly 9.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Courtlistener API?
Skills that share tags, products or a category with Courtlistener API: Tw Legal RAG (aa0101181514/tw-legal-rag, 328 stars), Design Award Search (SeanJ1ang/design-judge-skills, 712 stars), China Lawyer Analyst (CSlawyer1985/china-lawyer-analyst, 196 stars) and Billing And Litigation Budget (THUYRan/Legal-Skills-Chinese, 874 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Courtlistener API?
wentorai (a GitHub user) maintains it in wentorai/research-plugins, which has 298 GitHub stars. The repository holds 405 skills in this directory. The repository was last updated on June 19, 2026.
Source: wentorai/research-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.