Installation

There are three ways to install the CLI skills. Choose whichever suits your workflow.

Method 1: One-line install (recommended)

curl -fsSL https://raw.githubusercontent.com/davendra/ai-legal-uk/main/install.sh | bash

This clones the repository into a temporary directory, copies the skills and agents into ~/.claude/, and cleans up after itself.

Method 2: Clone and install

git clone https://github.com/davendra/ai-legal-uk.git
cd ai-legal-uk
./install.sh

Use this method if you want to keep a local copy for contributing or customising skills.

Method 3: Manual copy

If you prefer full control, copy the files yourself:

# Clone the repo
git clone https://github.com/davendra/ai-legal-uk.git
cd ai-legal-uk

# Create target directories
mkdir -p ~/.claude/skills
mkdir -p ~/.claude/agents

# Copy the orchestrator
cp -r legal ~/.claude/skills/legal

# Copy all sub-skills
cp -r skills/legal-* ~/.claude/skills/

# Copy all agents
cp agents/*.md ~/.claude/agents/

# Copy scripts and templates
cp scripts/*.py ~/.claude/skills/legal/scripts/
cp templates/*.md ~/.claude/skills/legal/templates/

What install.sh does

The installer performs these steps:

1. Detects local vs remote --- if run from a local clone it uses those files; otherwise it clones davendra/ai-legal-uk from GitHub into a temp directory
2. Creates directories --- ~/.claude/skills/ and ~/.claude/agents/
3. Copies the skill files --- the main orchestrator (legal/SKILL.md) plus 35 command skills (skills/legal-*/SKILL.md)
4. Copies 12 agent files --- parallel analysis agents used by the review, employment, and corporate orchestrators
5. Copies scripts and templates --- Python scripts for PDF generation and Markdown templates for document generation
6. Checks prerequisites --- warns if Claude Code, Python 3, or reportlab are missing (installation still succeeds)
7. Prints a summary --- installed counts and a command reference table

Verify the installation

After installing, open Claude Code and type /legal. You should see the full command menu with all 38 skills listed.

Dashboard setup

The web dashboard is a separate Next.js application. It does not require the CLI skills to be installed.

cd dashboard
npm install
npm run dev

Open http://localhost:3000 in your browser. The dashboard starts in demo mode by default --- no API key needed to explore the interface with sample data.

To enable live analysis, enter your Anthropic API key in the dashboard Settings page. The key is stored in your browser's local storage and sent with each analysis request.

API key handling

The dashboard server does not store your API key. It is held in browser local storage and passed to the Anthropic API on each request. Clear your browser data to remove it.

Production build

cd dashboard
npm run build
npm start

MCP server setup

The UK Legislation MCP server provides real-time statute lookup against legislation.gov.uk.

cd mcp-servers/uk-legislation
npm install
npm run dev

This starts a stdio-based MCP server. The project's .mcp.json registers it as uk-legislation for local use and connects to the remote lex server for court case search.

Available MCP tools

Tool	Description
search_legislation	Full-text search across UK legislation
lookup_statute	Look up a specific Act by title and year
lookup_section	Retrieve a specific section of an Act
check_in_force	Verify whether a provision is currently in force
check_amendments	List amendments to a section
get_extent	Check geographic extent (E+W, S, NI)

Uninstalling

To remove all installed skills and agents:

./uninstall.sh

This removes the skill directories from ~/.claude/skills/ and agent files from ~/.claude/agents/. Your Claude Code installation is otherwise unchanged. The dashboard and MCP server are not affected --- delete their directories manually if needed.