@wentorai/research-plugins 1.1.0 → 1.2.0

package/skills/domains/law/caselaw-access-api/SKILL.md

@@ -0,0 +1,149 @@
+---
+name: caselaw-access-api
+description: "Query 360+ years of US case law via the Harvard Caselaw Access Project"
+metadata:
+  openclaw:
+    emoji: "⚖️"
+    category: "domains"
+    subcategory: "law"
+    keywords: ["case law", "legal database", "court opinions", "Harvard law", "judicial data", "legal research"]
+    source: "https://case.law/"
+---
+
+# Caselaw Access Project API
+
+## Overview
+
+The Caselaw Access Project (CAP) by Harvard Law School provides free access to 6.9 million US court opinions spanning 360+ years. The REST API enables searching, filtering, and downloading full-text case opinions from all federal and state courts. No authentication required for metadata; API key (free registration) required for full text of post-1923 cases.
+
+## API Endpoints
+
+### Base URL
+
+```
+https://api.case.law/v1/
+```
+
+### Cases
+
+```bash
+# Search cases by keyword
+curl "https://api.case.law/v1/cases/?search=free+speech&decision_date_min=2020-01-01"
+
+# Get a specific case by ID
+curl "https://api.case.law/v1/cases/12345678/"
+
+# Filter by jurisdiction and court
+curl "https://api.case.law/v1/cases/?jurisdiction=us&court=us-sup-ct&search=miranda+rights"
+
+# Filter by date range
+curl "https://api.case.law/v1/cases/?decision_date_min=2015-01-01&decision_date_max=2025-12-31"
+
+# Get full text (requires API key for post-1923)
+curl -H "Authorization: Token YOUR_API_KEY" \
+  "https://api.case.law/v1/cases/12345678/?full_case=true"
+```
+
+### Query Parameters
+
+| Parameter | Description | Example |
+|-----------|-------------|---------|
+| `search` | Full-text search | `search=due+process` |
+| `jurisdiction` | Filter by jurisdiction slug | `jurisdiction=cal` (California) |
+| `court` | Filter by court slug | `court=us-sup-ct` |
+| `decision_date_min` | Earliest date | `decision_date_min=2020-01-01` |
+| `decision_date_max` | Latest date | `decision_date_max=2025-12-31` |
+| `cite` | Search by citation | `cite=410+U.S.+113` |
+| `name_abbreviation` | Case name | `name_abbreviation=Roe+v.+Wade` |
+| `ordering` | Sort results | `ordering=-decision_date` |
+| `page_size` | Results per page (max 100) | `page_size=50` |
+| `full_case` | Include full text | `full_case=true` |
+
+### Courts and Jurisdictions
+
+```bash
+# List all courts
+curl "https://api.case.law/v1/courts/"
+
+# List all jurisdictions
+curl "https://api.case.law/v1/jurisdictions/"
+
+# List all reporters (case report series)
+curl "https://api.case.law/v1/reporters/"
+```
+
+## Python Usage
+
+```python
+import requests
+
+BASE_URL = "https://api.case.law/v1"
+
+def search_cases(query: str, jurisdiction: str = None,
+                 court: str = None, max_results: int = 20) -> list:
+    """Search US case law."""
+    params = {"search": query, "page_size": min(max_results, 100)}
+    if jurisdiction:
+        params["jurisdiction"] = jurisdiction
+    if court:
+        params["court"] = court
+
+    resp = requests.get(f"{BASE_URL}/cases/", params=params)
+    resp.raise_for_status()
+    data = resp.json()
+
+    cases = []
+    for case in data.get("results", []):
+        cases.append({
+            "id": case["id"],
+            "name": case["name_abbreviation"],
+            "citation": case["citations"][0]["cite"] if case.get("citations") else None,
+            "court": case["court"]["name"],
+            "date": case["decision_date"],
+            "url": case["frontend_url"]
+        })
+    return cases
+
+# Search Supreme Court cases
+results = search_cases("fourth amendment", court="us-sup-ct")
+for case in results:
+    print(f"{case['citation']}: {case['name']} ({case['date']})")
+```
+
+## Bulk Data Access
+
+For large-scale research, download bulk datasets instead of querying the API:
+
+```bash
+# Bulk data available at:
+# https://case.law/bulk/download/
+# Formats: JSON (full case data) or text-only
+# Organized by jurisdiction and reporter
+```
+
+## Key Jurisdictions
+
+| Slug | Jurisdiction | Cases |
+|------|-------------|-------|
+| `us` | Federal (all) | ~1.5M |
+| `us-sup-ct` | US Supreme Court | ~65K |
+| `cal` | California | ~500K |
+| `ny` | New York | ~600K |
+| `tex` | Texas | ~300K |
+| `ill` | Illinois | ~250K |
+
+## Authentication
+
+```
+1. Register at https://case.law/user/register/
+2. Get API token from your account page
+3. Include in requests: Authorization: Token YOUR_TOKEN
+```
+
+Free accounts get full text for pre-1923 cases. Post-1923 full text requires an API token (still free).
+
+## References
+
+- [CAP API Documentation](https://case.law/api/)
+- [CAP Bulk Data](https://case.law/bulk/download/)
+- [Harvard Library Innovation Lab](https://lil.law.harvard.edu/)

package/skills/domains/law/legal-agent-skills-guide/SKILL.md

@@ -0,0 +1,132 @@
+---
+name: legal-agent-skills-guide
+description: "Agent skills collection for legal research and automation"
+metadata:
+  openclaw:
+    emoji: "⚖️"
+    category: "domains"
+    subcategory: "law"
+    keywords: ["legal AI", "legal automation", "legal research", "agent skills", "contract analysis", "case law"]
+    source: "https://github.com/lawvable/awesome-legal-skills"
+---
+
+# Legal Agent Skills Guide
+
+## Overview
+
+A curated collection of agent skills for legal research and automation — contract analysis, case law search, regulatory compliance checking, legal document drafting, and citation verification. Each skill provides structured capabilities that AI agents can use to assist with legal workflows. Designed for legal researchers, law firms, and compliance teams.
+
+## Skill Categories
+
+```
+Legal Agent Skills
+├── Research Skills
+│   ├── Case law search (by jurisdiction, topic)
+│   ├── Statute lookup (federal, state, international)
+│   ├── Legal commentary search
+│   └── Regulatory tracking
+├── Analysis Skills
+│   ├── Contract clause extraction
+│   ├── Risk assessment
+│   ├── Compliance checking
+│   └── Legal argument analysis
+├── Drafting Skills
+│   ├── Contract drafting
+│   ├── Legal memo writing
+│   ├── Motion drafting
+│   └── Compliance reports
+├── Citation Skills
+│   ├── Bluebook formatting
+│   ├── Citation verification
+│   ├── Shepard's-style validation
+│   └── Cross-reference linking
+└── Practice Management
+    ├── Case timeline construction
+    ├── Discovery document review
+    ├── Deposition summary
+    └── Billing narrative generation
+```
+
+## Key Skills
+
+### Case Law Research
+
+```python
+# Search case law databases
+from legal_skills import CaseLawSearch
+
+search = CaseLawSearch(jurisdictions=["federal", "california"])
+
+cases = search.find(
+    query="AI liability product defect",
+    date_range=("2020-01-01", "2025-12-31"),
+    court_level="appellate",
+    max_results=20,
+)
+
+for case in cases:
+    print(f"{case.name} ({case.year})")
+    print(f"  Court: {case.court}")
+    print(f"  Key holding: {case.holding[:100]}...")
+    print(f"  Citation: {case.citation}")
+```
+
+### Contract Analysis
+
+```python
+from legal_skills import ContractAnalyzer
+
+analyzer = ContractAnalyzer()
+
+# Analyze contract
+analysis = analyzer.analyze("contract.pdf")
+
+print("Risk Assessment:")
+for risk in analysis.risks:
+    print(f"  [{risk.severity}] {risk.clause}: {risk.description}")
+
+print("\nKey Terms:")
+for term in analysis.key_terms:
+    print(f"  {term.name}: {term.value}")
+
+print("\nMissing Clauses:")
+for missing in analysis.missing_clauses:
+    print(f"  - {missing}")
+```
+
+### Bluebook Citation
+
+```python
+from legal_skills import BluebookFormatter
+
+formatter = BluebookFormatter()
+
+# Format citation
+citation = formatter.format(
+    case_name="Brown v. Board of Education",
+    volume=347,
+    reporter="U.S.",
+    page=483,
+    year=1954,
+)
+print(citation)
+# Brown v. Board of Education, 347 U.S. 483 (1954).
+
+# Verify citation
+valid = formatter.verify("347 U.S. 483")
+print(f"Valid: {valid.is_valid}, Case: {valid.case_name}")
+```
+
+## Use Cases
+
+1. **Legal research**: AI-assisted case law and statute search
+2. **Contract review**: Automated clause analysis and risk flagging
+3. **Compliance**: Regulatory compliance checking
+4. **Drafting**: AI-assisted legal document drafting
+5. **Citation management**: Bluebook formatting and verification
+
+## References
+
+- [awesome-legal-skills](https://github.com/lawvable/awesome-legal-skills)
+- [CourtListener](https://www.courtlistener.com/) — Free case law
+- [Caselaw Access Project](https://case.law/)

package/skills/domains/law/legal-research-methods/SKILL.md

@@ -0,0 +1,190 @@
+---
+name: legal-research-methods
+description: "Systematic legal research methods for case law, statutes, and regulations"
+metadata:
+  openclaw:
+    emoji: "⚖️"
+    category: "domains"
+    subcategory: "law"
+    keywords: ["legal research", "case law", "statute analysis", "legal databases", "regulatory analysis", "legal methodology"]
+    source: "https://clawhub.ai/legal-research"
+---
+
+# Legal Research Methods
+
+## Overview
+
+Legal research involves finding and analyzing primary legal authorities (case law, statutes, regulations) and secondary sources (treatises, law reviews, restatements) to answer legal questions. This guide covers systematic research methodologies, major free and commercial databases, citation practices, and analysis frameworks used in both legal practice and law and economics scholarship.
+
+## Legal Source Hierarchy
+
+| Authority | Type | Weight | Examples |
+|-----------|------|--------|---------|
+| **Constitutional provisions** | Primary, mandatory | Highest | U.S. Constitution, Basic Law |
+| **Statutes / Legislation** | Primary, mandatory | Very high | USC (federal), state codes |
+| **Administrative regulations** | Primary, mandatory | High | CFR (federal), agency rules |
+| **Case law (binding)** | Primary, mandatory | High | Supreme Court, circuit court (same circuit) |
+| **Case law (persuasive)** | Primary, persuasive | Moderate | Other circuits, state courts, foreign courts |
+| **Legislative history** | Secondary, persuasive | Moderate | Committee reports, floor debates |
+| **Treatises** | Secondary, persuasive | Moderate | Prosser on Torts, Corbin on Contracts |
+| **Law review articles** | Secondary, persuasive | Low-Moderate | Peer commentary, novel arguments |
+| **Restatements** | Secondary, persuasive | Moderate | ALI Restatements (Torts, Contracts) |
+| **Legal encyclopedias** | Secondary, reference | Low | Am Jur 2d, CJS |
+
+## Free Legal Databases
+
+| Database | Coverage | URL | Best For |
+|----------|----------|-----|---------|
+| **Google Scholar** (Case Law) | US federal + state opinions | scholar.google.com | Quick case search, citation checking |
+| **CourtListener** | 8M+ opinions, PACER filings | courtlistener.com | Federal litigation, RECAP archive |
+| **Caselaw Access Project** | 6.9M US cases (Harvard Law) | case.law | Historical research, bulk analysis |
+| **Congress.gov** | Federal bills and laws | congress.gov | Legislative history |
+| **GovInfo** | CFR, Federal Register, USC | govinfo.gov | Regulations, statutory text |
+| **Cornell LII** | USC, CFR, Supreme Court | law.cornell.edu | Statutory lookup, Wex definitions |
+| **Justia** | Federal + state cases, codes | justia.com | Free comprehensive search |
+| **SSRN** | Working papers | ssrn.com | Legal scholarship preprints |
+| **HeinOnline** | Law reviews (institutional) | heinonline.org | Historical law journals |
+
+## Research Methodology
+
+### The IRAC Framework
+
+For analyzing legal questions:
+
+```
+Issue:       What is the legal question?
+Rule:        What law (statute, case, regulation) governs this issue?
+Application: How does the rule apply to the specific facts?
+Conclusion:  What is the likely outcome?
+```
+
+### Systematic Case Research Process
+
+```markdown
+Step 1: Identify the Legal Issue
+  - Frame as a specific, answerable question
+  - Identify jurisdiction (federal, state, international)
+  - Identify area of law (contract, tort, constitutional, regulatory)
+
+Step 2: Find Controlling Statutes
+  - Search USC (federal) or state code for relevant provisions
+  - Read the full statutory section, not just the key subsection
+  - Check for recent amendments (currency)
+  - Note any implementing regulations (CFR)
+
+Step 3: Find Leading Cases
+  - Start with secondary sources (treatise, ALR annotation) for overview
+  - Use headnotes/key numbers to find on-point cases
+  - Prioritize: Supreme Court > Circuit Court > District Court
+  - Prioritize: Recent > Older (unless seminal)
+
+Step 4: Expand Through Citation Networks
+  - Forward: Who cited this case? (Citator / "Cited by")
+  - Backward: What does this case cite? (Footnotes)
+  - Negative treatment: Was this case overruled or distinguished?
+
+Step 5: Verify Currency (Shepardize/KeyCite)
+  - Check if cases are still good law
+  - Check for legislative amendments to statutes
+  - Check for new regulations affecting the area
+
+Step 6: Synthesize and Analyze
+  - Identify the majority rule vs. minority rule
+  - Note circuit splits
+  - Distinguish binding vs. persuasive authority
+  - Identify trends in recent decisions
+```
+
+### Boolean Search Syntax for Legal Databases
+
+```
+Westlaw:  "due process" /s "property right" & date(aft 2020)
+Lexis:    "due process" w/s "property right" AND date aft 2020
+Google Scholar: "due process" "property right" (with case law checkbox)
+CourtListener: "due process" AND "property right" filed_after:2020-01-01
+```
+
+| Operator | Westlaw | Lexis | Google Scholar |
+|----------|---------|-------|---------------|
+| AND | & | AND | (implicit) |
+| OR | (space) | OR | OR |
+| NOT | but not | AND NOT | - (minus) |
+| Phrase | "exact phrase" | "exact phrase" | "exact phrase" |
+| Within sentence | /s | w/s | N/A |
+| Within paragraph | /p | w/p | N/A |
+| Proximity | /n (within n words) | w/n | N/A |
+
+## Empirical Legal Research
+
+For law and economics / quantitative legal studies:
+
+### Common Data Sources
+
+| Source | Coverage | Format | Research Use |
+|--------|----------|--------|-------------|
+| **Federal Judicial Center** | Federal court statistics | CSV | Case processing times, judicial behavior |
+| **PACER / RECAP** | Federal docket data | PDF/XML | Litigation patterns, filing trends |
+| **Caselaw Access Project API** | 6.9M case opinions | JSON API | Text analysis, citation networks |
+| **SEC EDGAR** | Corporate filings | XBRL/HTML | Securities regulation, corporate governance |
+| **BLS / Census** | Economic data | CSV | Regulatory impact analysis |
+
+### Citation Network Analysis
+
+```python
+# Using CourtListener API for citation analysis
+import requests
+
+BASE_URL = "https://www.courtlistener.com/api/rest/v3"
+
+def get_case_citations(case_id: str) -> dict:
+    """Get citing and cited cases for a given opinion."""
+    # Get case details
+    resp = requests.get(f"{BASE_URL}/opinions/{case_id}/",
+                        params={"fields": "citations,citing"})
+    return resp.json()
+
+def build_citation_network(seed_case: str, depth: int = 2):
+    """Build citation network from a seed case."""
+    network = {"nodes": set(), "edges": []}
+    queue = [(seed_case, 0)]
+
+    while queue:
+        case_id, level = queue.pop(0)
+        if level >= depth or case_id in network["nodes"]:
+            continue
+        network["nodes"].add(case_id)
+        data = get_case_citations(case_id)
+        for cited in data.get("citations", []):
+            network["edges"].append((case_id, cited))
+            queue.append((cited, level + 1))
+
+    return network
+```
+
+## Legal Citation Format (Bluebook)
+
+```
+Cases:
+  Brown v. Board of Education, 347 U.S. 483 (1954).
+  [Case Name], [Volume] [Reporter] [Page] ([Court] [Year]).
+
+Statutes:
+  42 U.S.C. § 1983 (2018).
+  [Title] [Code] § [Section] ([Year]).
+
+Law Reviews:
+  Cass R. Sunstein, On the Expressive Function of Law, 144 U. Pa. L. Rev. 2021 (1996).
+  [Author], [Title], [Volume] [Journal] [Page] ([Year]).
+
+Regulations:
+  17 C.F.R. § 240.10b-5 (2023).
+  [Title] C.F.R. § [Section] ([Year]).
+```
+
+## References
+
+- [CourtListener API](https://www.courtlistener.com/help/api/)
+- [Caselaw Access Project](https://case.law/)
+- [Cornell Legal Information Institute](https://www.law.cornell.edu/)
+- [The Bluebook: A Uniform System of Citation](https://www.legalbluebook.com/)
+- Epstein, L., & Martin, A. D. (2014). *An Introduction to Empirical Legal Research*. Oxford UP.

package/skills/domains/law/opencontracts-guide/SKILL.md

@@ -0,0 +1,168 @@
+---
+name: opencontracts-guide
+description: "Legal document annotation, versioning, and analysis platform"
+metadata:
+  openclaw:
+    emoji: "📋"
+    category: "domains"
+    subcategory: "law"
+    keywords: ["legal documents", "contract annotation", "document versioning", "legal AI", "NLP legal", "MCP"]
+    source: "https://github.com/Open-Source-Legal/OpenContracts"
+---
+
+# OpenContracts Guide
+
+## Overview
+
+OpenContracts is an open-source platform for legal document annotation, versioning, and analysis. It provides collaborative annotation tools for legal text, version tracking across document drafts, NLP-powered clause extraction, and integration with AI agents via MCP. Designed for legal researchers, law firms, and teams managing large document collections that need structured annotation and analysis.
+
+## Installation
+
+```bash
+# Docker deployment
+git clone https://github.com/Open-Source-Legal/OpenContracts.git
+cd OpenContracts
+docker-compose up -d
+
+# Access at http://localhost:3000
+```
+
+## Core Features
+
+### Document Management
+
+```python
+from opencontracts import Client
+
+client = Client("http://localhost:3000")
+
+# Upload documents
+doc = client.upload(
+    file="contract.pdf",
+    metadata={
+        "type": "NDA",
+        "parties": ["Company A", "Company B"],
+        "date": "2025-01-15",
+        "jurisdiction": "Delaware",
+    },
+)
+
+# Version tracking
+versions = client.get_versions(doc.id)
+for v in versions:
+    print(f"v{v.number}: {v.date} — {v.changes_summary}")
+
+# Compare versions
+diff = client.compare_versions(doc.id, v1=1, v2=3)
+for change in diff.changes:
+    print(f"[{change.type}] Section {change.section}: "
+          f"{change.description}")
+```
+
+### Annotation
+
+```python
+# Create annotation project
+project = client.create_project(
+    name="NDA Clause Analysis",
+    documents=[doc.id],
+    label_set=[
+        "confidentiality_scope",
+        "term_duration",
+        "exclusions",
+        "remedies",
+        "governing_law",
+        "dispute_resolution",
+    ],
+)
+
+# Add annotations
+client.annotate(
+    document_id=doc.id,
+    annotations=[
+        {
+            "start": 1250, "end": 1480,
+            "label": "confidentiality_scope",
+            "note": "Broad definition including derivatives",
+        },
+        {
+            "start": 2100, "end": 2250,
+            "label": "term_duration",
+            "note": "5-year term with auto-renewal",
+        },
+    ],
+)
+```
+
+### NLP Analysis
+
+```python
+# Automated clause extraction
+clauses = client.extract_clauses(
+    doc.id,
+    clause_types=[
+        "indemnification",
+        "limitation_of_liability",
+        "termination",
+        "force_majeure",
+        "assignment",
+    ],
+)
+
+for clause in clauses:
+    print(f"\n[{clause.type}] (confidence: {clause.confidence:.2f})")
+    print(f"  Location: p.{clause.page}, para {clause.paragraph}")
+    print(f"  Text: {clause.text[:100]}...")
+
+# Risk assessment
+risks = client.assess_risks(doc.id)
+for risk in risks:
+    print(f"[{risk.severity}] {risk.clause}: {risk.description}")
+```
+
+### MCP Integration
+
+```json
+{
+  "mcpServers": {
+    "opencontracts": {
+      "command": "npx",
+      "args": ["@opencontracts/mcp-server"],
+      "env": {
+        "OPENCONTRACTS_URL": "http://localhost:3000"
+      }
+    }
+  }
+}
+```
+
+## Search and Analytics
+
+```python
+# Full-text search across documents
+results = client.search(
+    query="indemnification unlimited liability",
+    document_types=["NDA", "MSA"],
+    date_range=("2024-01-01", "2025-12-31"),
+)
+
+# Analytics
+stats = client.analytics(project_id=project.id)
+print(f"Documents annotated: {stats.docs_complete}")
+print(f"Total annotations: {stats.total_annotations}")
+print(f"Inter-annotator agreement: {stats.agreement:.2f}")
+print(f"Most common clause: {stats.top_clauses[0]}")
+```
+
+## Use Cases
+
+1. **Contract review**: Systematic clause analysis and risk assessment
+2. **Legal research**: Annotate case law and legislation
+3. **Compliance**: Track regulatory document requirements
+4. **Training data**: Build labeled datasets for legal NLP
+5. **Due diligence**: Structured review of deal documents
+
+## References
+
+- [OpenContracts GitHub](https://github.com/Open-Source-Legal/OpenContracts)
+- [Legal NLP Resources](https://github.com/thunlp/LegalPapers)