Agent skill

Case Law Research

by LegalQuants in LegalQuants/lq-ai

A skill your agent uses when the user asks to find, read, or cite U.S.

Apache-2.0Auto-check passedLegal & Compliance

Install Case Law Research

skills CLI
$ npx skills add LegalQuants/lq-ai --skill case-law-research -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install LegalQuants/lq-ai case-law-research --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/LegalQuants/lq-ai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/case-law-research .claude/skills/case-law-research && rm -rf skills-src

Use ~/.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/

Facts

Skill name
case-law-research
GitHub stars
150
Token cost
~2.4k tokens
SKILL.md length
1,030 words
Files
2
Skills in repo
16
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when the user asks to find, read, or cite U.S.

  • Works in 3 steps: search_case_law → get_cluster → read_opinion or find_in_case
  • The user asks to find
  • SKILL.md covers When this skill applies, Inputs, Tool chain and Grounding discipline, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Case Law Research is an agent skill from LegalQuants/lq-ai. Use when the user asks to find, read, or cite U.S. case law on a question — locating controlling or persuasive decisions via CourtListener, reading the opinion text, and grounding any statement in what the source actually says.

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `examples/research-trail.md`).

It sits in Legal & Compliance, covering Legal research. The repository describes itself as: Open-source AI for legal teams. Bring your own keys, run it where you want, own your data. The licence is Apache-2.0.

When your agent uses it

  • The user asks to find
  • Tasks that involve Legal research

Example prompts

  • “/case-law-research”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. search_case_law
  2. get_cluster
  3. read_opinion or find_in_case

What it can do on your machine

Read from SKILL.md and the folder at commit d185a62. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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

Case Law Research loads about 2.4k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 1,030 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k

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 LegalQuants/lq-ai at commit d185a62, republished under its Apache-2.0 licence (© LegalQuants). 1,030 words, ~2,360 tokens.

Download SKILL.mdSave it as .claude/skills/case-law-research/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
case-law-research
description
Use when the user asks to find, read, or cite U.S. case law on a question — locating controlling or persuasive decisions via CourtListener, reading the opinion text, and grounding any statement in what the source actually says.
lq_ai.title
Case-Law Research
lq_ai.version
1.0.0
lq_ai.author
LegalQuants
lq_ai.tags
research, case-law, litigation, citations, courtlistener
lq_ai.jurisdiction
us
lq_ai.tool_usage
courtlistener
lq_ai.trigger_examples
find case law on the duty of good faith in NY, what does the Ninth Circuit say about trade-secret misappropriation, pull the leading Supreme Court cases on…
lq_ai.output_format
report
lq_ai.use_organization_profile
true

Case-Law Research

Conduct a structured search of U.S. case law via CourtListener, read the opinion text, and produce a grounded research report. Every statement in the report must be traceable to retrieved text — do not assert what a case holds unless you have read the relevant passage.

When this skill applies

Apply when the user asks to locate, read, or cite court decisions on a legal question. Common triggers: finding controlling or persuasive authority, confirming whether authority exists, reading specific language from an opinion, assembling citations for a brief or memo.

Do not apply this skill when:

  • The user asks about statutory text, regulations, or administrative guidance. Those are not in the CourtListener corpus; direct the user to the appropriate source.
  • The user asks about non-U.S. law. CourtListener covers U.S. federal and state courts only; this skill does not extend beyond that coverage.
  • The user needs to confirm whether a case is still good law (overruled, distinguished, limited). This skill is not a citator. It does not perform Shepardizing or KeyCiting. Always recommend the user validate any case's current status in Westlaw, Lexis, or a comparable citator before relying on it.

Inputs

Required: the question input — the legal question or issue to research. If the user has not stated a question clearly, ask before searching.

Optional: the jurisdiction input — a court or jurisdiction to focus on (e.g., "9th Circuit", "New York Court of Appeals", "SCOTUS"). When provided, weight searches toward that jurisdiction. When absent, begin with a broad U.S. search and note which courts produced the most relevant results.

If the user's question is ambiguous (e.g., "case law on good faith") and the jurisdiction materially affects which results are relevant, ask one clarifying question before searching. Do not block on optional inputs.

Tool chain

This skill runs through the LQ.AI governed gateway. All CourtListener tool calls are tier-gated and audited; the "Sources consulted" panel (visible to the user after the run) shows the provenance trail.

Step 1 — search_case_law

Call search_case_law with a query derived from the user's question. Tips:

  • Use specific legal terms from the question rather than paraphrasing in lay language.
  • If a jurisdiction was provided, include it as a filter.
  • Prefer narrower queries first; broaden if the initial results are sparse or off-topic.
  • Run multiple searches if the question has distinct sub-issues (e.g., a threshold test and a remedy standard).

search_case_law returns a list of candidate clusters (cases). Each cluster includes a docket identifier and case metadata. Do not assert anything about the case yet — the search result is a pointer, not a full read.

Step 2 — get_cluster

For each promising candidate from Step 1, call get_cluster with the cluster identifier to retrieve the case metadata and the list of opinion documents within it. This confirms the court, date, parties, and which opinion(s) are available to read.

Select the opinion(s) most likely to contain the relevant passage (majority opinion first; concurrences or dissents only if the question specifically implicates them).

Step 3 — read_opinion or find_in_case

To read the full opinion text, call read_opinion with the opinion identifier from the cluster. For long opinions or targeted lookups, call find_in_case with search terms to locate the specific passage.

Ground every statement in retrieved text. Before citing a case for a proposition, locate the supporting passage. Quote or closely paraphrase the relevant excerpt in the report. Do not summarize from memory or from the search-result snippet alone.

If read_opinion or find_in_case returns no content or an error, record the gap explicitly in the report.

Show full SKILL.md (447 more words)Show less

Grounding discipline

  • Cite only what the tools returned. Do not add cases from training memory — the user cannot verify those through the provenance panel.
  • Quote or locate the supporting passage before asserting what a case holds.
  • If the retrieved text is ambiguous, say so. Present the text and note the ambiguity rather than resolving it with an interpretation the user has not authorized.
  • If the search returns no relevant results, say so clearly. A "no results" finding is an honest answer; do not substitute general statements.
  • When results are jurisdictionally mismatched (the user asked for 9th Circuit authority but only 7th Circuit decisions surfaced), report the mismatch. Note that the results found are from a different jurisdiction and may be persuasive but not controlling.

Honesty and scope limits

State the following clearly in every research report:

  1. Coverage: CourtListener covers U.S. federal and state courts; coverage depth varies by court and date range. Gaps in the corpus do not mean no authority exists — they mean it was not found in this source.
  2. Not a citator: This skill does not validate whether a case is still good law. Before relying on any case, the user should verify its subsequent history in Westlaw, Lexis, or a comparable citator.
  3. Research assistance, not legal advice: The report identifies authorities and what their text says. Evaluating whether those authorities govern the user's facts, and how to apply them, requires human legal judgment.

Output

Produce the report in markdown with this structure:

markdown
# Case-Law Research: [short restatement of the question]

**Question:** [the user's research question]
**Jurisdiction searched:** [courts/jurisdictions covered by the search]
**Date of research:** [today's date]

## Authorities found

[For each case identified as relevant:]

### [Case Name], [Court], [Year] ([Citation if available])

**What was retrieved:** [one or two sentences stating what the opinion addresses, grounded in the text retrieved]

**Relevant passage:**
> [Quoted or closely paraphrased excerpt from read_opinion / find_in_case]

**How this bears on the question:** [one or two sentences connecting the retrieved text to the user's question — descriptive, not conclusory]

---

## Gaps and caveats

- **What was searched:** [query terms and jurisdiction filters used]
- **What was not found:** [authorities the user might expect that did not surface]
- **Jurisdiction notes:** [any mismatch between the user's requested jurisdiction and what was found]
- **Currency warning:** This skill is not a citator. Each case above should be Shepardized or KeyCited before reliance.
- **Coverage note:** CourtListener's corpus has gaps; absence of results does not mean no authority exists.

## Recommended next steps

- [e.g., validate each case's current status in a citator]
- [e.g., search secondary sources for doctrinal synthesis]
- [e.g., consult a jurisdiction-specific practitioner for application to the specific facts]

If the search returns no relevant results, the "Authorities found" section should say so explicitly. Do not omit the section.

Keep the report as short as the results warrant. Do not pad. A one-case answer with an honest gaps section is correctly short.

What this skill does not do

  • Assert that a case is still good law. Recommend citator validation.
  • Research non-U.S. jurisdictions.
  • Search statutory or regulatory text.
  • Apply retrieved authority to the user's specific facts. That evaluation requires human legal judgment.
  • Substitute training-memory cases for tool-retrieved ones.

Edge cases

  • User names a specific case to read: Begin at Step 2 (get_cluster) rather than Step 1 if the user provides enough identification to locate the cluster directly. If the identification is incomplete, use search_case_law to locate the cluster first.
  • Very broad question: Ask the user to narrow the question, or break it into sub-issues and run a search for each, then synthesize the results under separate "Authorities found" subsections.
  • Opinion is very long: Use find_in_case with targeted terms rather than reading the entire text, to locate the passage efficiently.
  • Conflicting results across jurisdictions: Report each set of results separately, note the jurisdictional split, and leave synthesis to the user.

© LegalQuants, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/case-law-research of LegalQuants/lq-ai.

  • SKILL.md
  • examples/research-trail.md

Open the folder on GitHubat commit d185a62

Compare with similar skills

Case Law Research 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.

Case Law Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Case Law Research this skillLegalQuants/lq-ai150—~2.4kAutomated safety check: PassApache-2.0
Tw Legal RAGaa0101181514/tw-legal-rag328—~580Automated safety check: PassCustom licence
Design Award SearchSeanJ1ang/design-judge-skills712—~3kAutomated safety check: PassApache-2.0
China Lawyer AnalystCSlawyer1985/china-lawyer-analyst196—~3.3kAutomated safety check: PassNone
Billing And Litigation BudgetTHUYRan/Legal-Skills-Chinese874—~5kAutomated safety check: PassNone
Legal Issue ResearchGolden2002/legal-research-skill156—~6.8kAutomated safety check: PassMIT

Similar skills

  • 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.

    328 GitHub stars~580 tokensUpdated yesterday
    Legal & ComplianceAuto-check passed
  • 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…

    712 GitHub stars~3k tokensUpdated 1 mo ago
    Legal & ComplianceAuto-check passed
  • China Lawyer Analyst

    CSlawyer1985/china-lawyer-analyst

    通过中国法律视角分析事件,运用成文法解释、指导案例参照、请求权基础分析等方法, 理解权利义务、评估责任风险、识别法律依据并推荐合规策略。

    196 GitHub stars~3.3k tokensUpdated 8 mo ago
    Legal & ComplianceAuto-check passed
  • 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.

    874 GitHub stars~5k tokensUpdated 1 mo ago
    Legal & ComplianceAuto-check passed
  • Legal Issue Research

    Golden2002/legal-research-skill

    中国法律全领域系统性检索专家. An agent skill from Golden2002/legal-research-skill.

    156 GitHub stars~6.8k tokensUpdated 1 mo ago
    Legal & ComplianceAuto-check passed
  • 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.

    148 GitHub stars~997 tokensUpdated 4 mo ago
    Legal & ComplianceAuto-check: notes

More from LegalQuants/lq-ai

All 16 skills in this repo
  • A skill your agent uses when the user provides a client alert, regulatory bulletin, law firm memo, or similar legal update and wants the time-sensitive action items, deadlines, and obligations…

    150 GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Comms Improver

    LegalQuants/lq-ai

    A skill your agent uses when the user has a piece of legal-jargon-heavy text and wants it rewritten in plain language for a specified non-legal audience.

    150 GitHub stars~3.8k tokensUpdated today
    Auto-check passed
  • Contract QA

    LegalQuants/lq-ai

    A skill your agent uses when the user has a contract loaded and asks a specific question about it — what a clause means, where something is addressed, whether a term is unusual, how a provision…

    150 GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Contract Snapshot

    LegalQuants/lq-ai

    A skill your agent uses when the user wants to compare the same handful of terms across N contracts side-by-side in a grid — what is the term, survival period, carveouts, and governing law in each…

    150 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Dpa Checklist Review

    LegalQuants/lq-ai

    A skill your agent uses when the user provides a Data Processing Agreement, Data Processing Addendum, or HIPAA Business Associate Agreement and asks whether it contains the terms required under the…

    150 GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Enhance Prompt

    LegalQuants/lq-ai

    A skill your agent uses when the user has typed a short or vague prompt and the system is configured to expand prompts before submission, or when the user explicitly invokes "Enhance Prompt" or asks…

    150 GitHub stars~3.3k tokensUpdated today
    Auto-check passed

Questions about Case Law Research

What does Case Law Research do?

A skill your agent uses when the user asks to find, read, or cite U.S. Case Law Research is an agent skill from LegalQuants/lq-ai.S.

When should I use Case Law Research?

Case Law Research fits situations like: the user asks to find; tasks that involve Legal research.

How do I install Case Law Research in Claude Code?

Run `npx skills add LegalQuants/lq-ai --skill case-law-research -a claude-code`. Or copy the skill folder (skills/case-law-research in LegalQuants/lq-ai) into .claude/skills/case-law-research in your project. Claude Code loads it when a task matches its description.

How do I install Case Law Research in Codex?

Run `npx skills add LegalQuants/lq-ai --skill case-law-research -a codex`. Or copy the skill folder (skills/case-law-research in LegalQuants/lq-ai) into .agents/skills/case-law-research in your project. Codex loads it when a task matches its description.

Can I use Case Law Research 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 LegalQuants/lq-ai --skill case-law-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/case-law-research, .gemini/skills/case-law-research, .github/skills/case-law-research and .opencode/skills/case-law-research in your project.

What does Case Law Research need to run?

SKILL.md names no scripts, command-line tools or credentials: Case Law Research is instructions for the agent only.

Does Case Law Research access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Case Law Research 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 Case Law Research use?

Case Law Research is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Case Law Research use?

About 2.4k tokens (SKILL.md is roughly 9.4k 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 Case Law Research?

Skills that share tags, products or a category with Case Law Research: 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 Case Law Research?

LegalQuants (a GitHub organization) maintains it in LegalQuants/lq-ai, which has 150 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 11, 2026.

Source: LegalQuants/lq-ai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.