# lawve-ai/awesome-legal-skills architecture

> Architecture diagram of the GitHub repository lawve-ai/awesome-legal-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lawve-ai/awesome-legal-skills
- Repository: https://github.com/lawve-ai/awesome-legal-skills

## Overview

Lawve is a curated repository of portable, composable AI-agent skills for legal work, rather than one integrated runtime. A user selects a skill for a legal task; an agent follows that skill’s procedural knowledge and uses its scripts or integrations where provided. The sampled legal-diagram workflow explicitly harvests, deduplicates, resolves, materializes, and packages document-extraction results. Other examples provide independent tools for citation verification, case-law search, security auditing, and document generation. Connections are shown only where the excerpts, source index, or README establish them; many skill-level workflows are documented but not sampled.

Main entry points: [`skills/legal-diagram-sam-zhai/scripts/extraction/engine.py`](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/engine.py) (Extraction engine), [`skills/legal-diagram-sam-zhai/scripts/extraction/materialize.py`](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/materialize.py) (Result materializer), [`skills/legal-diagram-sam-zhai/scripts/extraction/handoff.py`](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/handoff.py) (LLM handoff), [`skills/legal-diagram-sam-zhai/scripts/extraction/resolver.py`](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/resolver.py) (Candidate resolver)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Skill Collection"]
  node_skills["Legal skills"]
  node_categories["Practice areas"]
end

subgraph group_diagram["Diagram Extraction"]
  node_extract["Extraction engine<br/>[engine.py]"]
  node_harvester["Candidate harvester<br/>[base.py]"]
  node_resolver["Candidate resolver<br/>[resolver.py]"]
  node_materializer["Result materializer<br/>[materialize.py]"]
  node_handoff["LLM handoff<br/>[handoff.py]"]
  node_domain["Domain model<br/>[domain.py]"]
  node_manifest["Candidate manifest<br/>[manifest.py]"]
  node_schema["Extraction schema<br/>[schema.py]"]
  node_lexicon["Resolver lexicon<br/>[lexicon.py]"]
end

subgraph group_research["Legal Research"]
  node_citation["Citation verifier<br/>[core.py]"]
  node_mcp["MCP interface<br/>[server.py]"]
  node_search["Extradition search<br/>[xsearch.py]"]
  node_quality["Search quality gate<br/>[quality.py]"]
end

subgraph group_tools["Utilities"]
  node_auditor["Security auditor core<br/>[core.py]"]
  node_patterns["Threat patterns<br/>[patterns.py]"]
  node_schedule["Schedule data"]
  node_schedule_doc["Schedule generator"]
  node_connector["MCP connections<br/>[connections.py]"]
end

node_user(("Legal professional"))
node_agent(("AI agent"))

node_user -->|"selects skill"| node_skills
node_skills -->|"organized by"| node_categories
node_agent -->|"follows procedures"| node_skills
node_extract -->|"runs"| node_harvester
node_extract -->|"deduplicates and resolves"| node_resolver
node_extract -->|"materializes"| node_materializer
node_extract -->|"builds handoff"| node_handoff
node_materializer -->|"creates entities"| node_domain
node_materializer -->|"uses types"| node_schema
node_handoff -->|"uses types"| node_schema
node_handoff -->|"builds manifest"| node_manifest
node_resolver -->|"uses thresholds"| node_lexicon
node_mcp -->|"invokes verifier"| node_citation
node_search -->|"applies quality gate"| node_quality
node_auditor -->|"uses catalog"| node_patterns
node_schedule_doc -->|"loads rows"| node_schedule

click node_extract "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/engine.py"
click node_harvester "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/harvesters/base.py"
click node_resolver "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/resolver.py"
click node_materializer "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/materialize.py"
click node_handoff "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/handoff.py"
click node_domain "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/domain.py"
click node_manifest "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/manifest.py"
click node_schema "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/schema.py"
click node_lexicon "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/lexicon.py"
click node_citation "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/ktzr-polskie-umowy-gospodarcze-adam-piotrowski/tools/legal-cite/legal_cite/core.py"
click node_mcp "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/ktzr-polskie-umowy-gospodarcze-adam-piotrowski/tools/legal-cite/legal_cite/server.py"
click node_search "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/extradition-case-law-search-matei-clej-59ff8929/scripts/xsearch.py"
click node_quality "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/extradition-case-law-search-matei-clej-59ff8929/scripts/quality.py"
click node_auditor "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/skill-security-auditor-lawve/scripts/core.py"
click node_patterns "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/skill-security-auditor-lawve/scripts/patterns.py"
click node_schedule "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/client-instruction-schedule-serhan-handani-fx44146u/references/schedule-data-example.js"
click node_schedule_doc "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/client-instruction-schedule-serhan-handani-fx44146u/references/build-schedule-example.js"
click node_connector "https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/mcp-builder-anthropic/scripts/connections.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skills,node_categories toneBlue
class node_extract,node_harvester,node_resolver,node_materializer,node_handoff,node_domain,node_manifest,node_schema,node_lexicon toneAmber
class node_citation,node_mcp,node_search,node_quality toneMint
class node_auditor,node_patterns,node_schedule,node_schedule_doc,node_connector toneRose
class node_user,node_agent toneIndigo
```

## Components

### Skill Collection

- **Legal skills**
- **Practice areas**

### Diagram Extraction

- [Extraction engine](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/engine.py): `skills/legal-diagram-sam-zhai/scripts/extraction/engine.py`
- [Candidate harvester](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/harvesters/base.py): `skills/legal-diagram-sam-zhai/scripts/extraction/harvesters/base.py`
- [Candidate resolver](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/resolver.py): `skills/legal-diagram-sam-zhai/scripts/extraction/resolver.py`
- [Result materializer](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/materialize.py): `skills/legal-diagram-sam-zhai/scripts/extraction/materialize.py`
- [LLM handoff](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/handoff.py): `skills/legal-diagram-sam-zhai/scripts/extraction/handoff.py`
- [Domain model](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/domain.py): `skills/legal-diagram-sam-zhai/scripts/extraction/domain.py`
- [Candidate manifest](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/manifest.py): `skills/legal-diagram-sam-zhai/scripts/extraction/manifest.py`
- [Extraction schema](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/schema.py): `skills/legal-diagram-sam-zhai/scripts/extraction/schema.py`
- [Resolver lexicon](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/legal-diagram-sam-zhai/scripts/extraction/lexicon.py): `skills/legal-diagram-sam-zhai/scripts/extraction/lexicon.py`

### Legal Research

- [Citation verifier](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/ktzr-polskie-umowy-gospodarcze-adam-piotrowski/tools/legal-cite/legal_cite/core.py): `skills/ktzr-polskie-umowy-gospodarcze-adam-piotrowski/tools/legal-cite/legal_cite/core.py`
- [MCP interface](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/ktzr-polskie-umowy-gospodarcze-adam-piotrowski/tools/legal-cite/legal_cite/server.py): `skills/ktzr-polskie-umowy-gospodarcze-adam-piotrowski/tools/legal-cite/legal_cite/server.py`
- [Extradition search](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/extradition-case-law-search-matei-clej-59ff8929/scripts/xsearch.py): `skills/extradition-case-law-search-matei-clej-59ff8929/scripts/xsearch.py`
- [Search quality gate](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/extradition-case-law-search-matei-clej-59ff8929/scripts/quality.py): `skills/extradition-case-law-search-matei-clej-59ff8929/scripts/quality.py`

### Utilities

- [Security auditor core](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/skill-security-auditor-lawve/scripts/core.py): `skills/skill-security-auditor-lawve/scripts/core.py`
- [Threat patterns](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/skill-security-auditor-lawve/scripts/patterns.py): `skills/skill-security-auditor-lawve/scripts/patterns.py`
- [Schedule data](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/client-instruction-schedule-serhan-handani-fx44146u/references/schedule-data-example.js): `skills/client-instruction-schedule-serhan-handani-fx44146u/references/schedule-data-example.js`
- [Schedule generator](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/client-instruction-schedule-serhan-handani-fx44146u/references/build-schedule-example.js): `skills/client-instruction-schedule-serhan-handani-fx44146u/references/build-schedule-example.js`
- [MCP connections](https://github.com/lawve-ai/awesome-legal-skills/blob/main/skills/mcp-builder-anthropic/scripts/connections.py): `skills/mcp-builder-anthropic/scripts/connections.py`

### Other components

- **Legal professional**
- **AI agent**

## Connections

- Legal professional → Legal skills: selects skill (evidence: `README.md`)
- Legal skills → Practice areas: organized by (evidence: `README.md`)
- AI agent → Legal skills: follows procedures (evidence: `README.md`)
- Extraction engine → Candidate harvester: runs (evidence: `skills/legal-diagram-sam-zhai/scripts/extraction/engine.py`)
- Extraction engine → Candidate resolver: deduplicates and resolves (evidence: `skills/legal-diagram-sam-zhai/scripts/extraction/engine.py`)
- Extraction engine → Result materializer: materializes (evidence: `skills/legal-diagram-sam-zhai/scripts/extraction/engine.py`)
- Extraction engine → LLM handoff: builds handoff (evidence: `skills/legal-diagram-sam-zhai/scripts/extraction/engine.py`)
- Result materializer → Domain model: creates entities (evidence: `skills/legal-diagram-sam-zhai/scripts/extraction/materialize.py`)
- Result materializer → Extraction schema: uses types (evidence: `skills/legal-diagram-sam-zhai/scripts/extraction/materialize.py`)
- LLM handoff → Extraction schema: uses types (evidence: `skills/legal-diagram-sam-zhai/scripts/extraction/handoff.py`)
- LLM handoff → Candidate manifest: builds manifest (evidence: `skills/legal-diagram-sam-zhai/scripts/extraction/handoff.py`)
- Candidate resolver → Resolver lexicon: uses thresholds (evidence: `skills/legal-diagram-sam-zhai/scripts/extraction/resolver.py`)
- MCP interface → Citation verifier: invokes verifier (evidence: `skills/ktzr-polskie-umowy-gospodarcze-adam-piotrowski/tools/legal-cite/legal_cite/server.py`)
- Extradition search → Search quality gate: applies quality gate (evidence: `skills/extradition-case-law-search-matei-clej-59ff8929/scripts/xsearch.py`)
- Security auditor core → Threat patterns: uses catalog (evidence: `skills/skill-security-auditor-lawve/scripts/patterns.py`)
- Schedule generator → Schedule data: loads rows (evidence: `skills/client-instruction-schedule-serhan-handani-fx44146u/references/build-schedule-example.js`)
