Skip to main content
skill CX Codex official · Anthropic

matter-workspace · anthropics, ip-legal — Claude Code skill: matters and setup

The matter-workspace Claude Code skill manages separate workspaces for client matters. It creates and switches matters, lists them, and archives closed ones.

Apache-2.0 ★ 10,060 updated 2026-10-23

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add anthropics/claude-for-legal
/plugin install ip-legal@claude-for-legal
Open on GitHub

What matter-workspace does

The skill keeps client matters in separate workspaces. It creates a matter after a short intake, lists existing matters, switches the active one, or archives a closed matter. The none command detaches from the active matter and returns to practice-level context. Creating a matter does not switch to it; the skill shows the planned changes and asks for confirmation before writing.

Matter files live under ~/.claude/plugins/config/claude-for-legal/ip-legal/matters/. Each workspace gets matter.md, history.md, and notes.md; archived matters remain readable. The skill does not read across matters unless Cross-matter context is enabled in CLAUDE.md. Workspaces are off by default. If Enabled is marked ✗, the skill explains the state and does not run the requested operation.

What it helps with

  • separate context for different client matters
  • create a matter record and its initial files
  • switch the active matter or return to practice context
  • archive a closed matter without deleting it

Example prompts for the agent

  • Create a matter with the slug acme-trademark-2026.
  • List the matters and mark the active one.
  • Archive the matter zenith-dmca.

How to install matter-workspace

1Plugin marketplace

/plugin marketplace add anthropics/claude-for-legal
/plugin install ip-legal@claude-for-legal

This installs the whole ip-legal plugin with all its skills

2Skills CLI (Vercel)

npx skills add anthropics/claude-for-legal --skill matter-workspace -a claude-code

3Manually: put the files in place

~/.claude/skills/matter-workspace/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/matter-workspace/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about matter-workspace

How do I install matter-workspace in Claude Code?

Add the marketplace with /plugin marketplace add anthropics/claude-for-legal, then install the plugin with /plugin install ip-legal@claude-for-legal.

What does matter-workspace do?

It creates and lists matter workspaces, switches or detaches the active matter, and archives closed matters. Cross-matter reading is disabled unless Cross-matter context is enabled in CLAUDE.md.

How do I enable matter workspaces?

They are enabled during setup for private-practice users. If Enabled is off, rerun setup with /ip-legal:cold-start-interview --redo and choose a private-practice setting.

Source text

SKILL.md · Apache-2.0
---
name: matter-workspace
description: >
  Manage matter workspaces — create, list, switch, close, or detach the
  active matter. Use in multi-client private practice to keep one client's
  context separate from another, or when a substantive skill needs to know
  which matter it's working in.
argument-hint: "<new | list | switch | close | none> [slug]"
---

# /matter-workspace

Practitioners work across multiple clients and matters. A matter workspace keeps one client or engagement's context separate from every other. This skill manages those workspaces.

## Subcommands

- `/ip-legal:matter-workspace new <slug>` — create a new matter workspace, run a short intake, write `matter.md`
- `/ip-legal:matter-workspace list` — list matters with status and active flag
- `/ip-legal:matter-workspace switch <slug>` — set the active matter
- `/ip-legal:matter-workspace close <slug>` — archive a matter (move to `~/.claude/plugins/config/claude-for-legal/ip-legal/matters/_archived/`, never delete)
- `/ip-legal:matter-workspace none` — detach from any active matter, work at practice-level only

## Instructions

1. Read `~/.claude/plugins/config/claude-for-legal/ip-legal/CLAUDE.md` — confirm the `## Matter workspaces` section is populated. If `Enabled` is `✗`, tell the user: "Matter workspaces are off — you're configured as an in-house practice with one client, so the plugin works from practice-level context automatically. If you actually work across multiple clients, re-run `/ip-legal:cold-start-interview --redo` and select a private-practice setting. Otherwise, you don't need `/ip-legal:matter-workspace` at all." Don't error — the disabled state is the expected one for in-house users.
2. Follow the subcommand logic below.
3. Dispatch on the first token of `$ARGUMENTS`:
   - `new` → run the intake interview, write `~/.claude/plugins/config/claude-for-legal/ip-legal/matters/<slug>/matter.md`, seed `history.md` and `notes.md`.
   - `list` → enumerate `~/.claude/plugins/config/claude-for-legal/ip-legal/matters/*/matter.md`, print a table, mark the active matter.
   - `switch` → update the `Active matter:` line in the practice-level CLAUDE.md.
   - `close` → move `~/.claude/plugins/config/claude-for-legal/ip-legal/matters/<slug>/` to `~/.claude/plugins/config/claude-for-legal/ip-legal/matters/_archived/<slug>/`, log the close date in `history.md`.
   - `none` → set `Active matter:` to `none — practice-level context only`.
4. Show the user what changed and confirm before writing.

## Notes

- The skill never reads across matters unless `Cross-matter context` is `on` in the practice-level CLAUDE.md.
- Archiving is not deletion — closed matters remain readable for retention/conflicts purposes.
- Slugs are lowercase with hyphens. If a slug is reused across archived and active, the archived one is preserved under `_archived/<slug>/`.

---

Multi-client practitioners (private practice — solo, small firm, large firm) work across many matters. Context from one must not leak into another. This skill is the thin file-management layer that makes that true.

**Default state is off.** In-house users never see this — they run at practice-level only. Matter workspaces turn on at cold-start for private-practice users, or by editing `## Matter workspaces` in the practice-level CLAUDE.md. If `Enabled` is `✗`, this skill does not run; instead it explains the disabled state and suggests `/ip-legal:cold-start-interview --redo` for users who actually need matter isolation.

## Storage layout

All matter data lives under:

```
~/.claude/plugins/config/claude-for-legal/ip-legal/
├── CLAUDE.md                       # practice-level practice profile
└── matters/
    ├── <slug>/
    │   ├── matter.md               # client, counterparty, matter type, key facts, overrides
    │   ├── history.md              # dated log of events, decisions, drafts, reviews
    │   ├── notes.md                # free-form working notes
    │   └── outputs/                # skill outputs for this matter (optional subfolder)
    └── _archived/
        └── <slug>/                 # closed matters — readable but not active
```

Slugs are lowercase with hyphens. Examples: `acme-trademark-2026`, `zenith-dmca`, `novacorp-fto`.

## Active matter is in the practice CLAUDE.md

The `Active matter:` line under `## Matter workspaces` in the practice-level CLAUDE.md is the single source of truth. Switching a matter edits that line. No separate state file.

## Subcommand logic

### `new <slug>`

1. Confirm slug is not already present in `matters/<slug>/` or `matters/_archived/<slug>/`. If reused, ask the user to pick a different slug.
2. Run the intake interview:
   - **Client** (the party we represent, or the internal business unit if in-house)
   - **Counterparty** (the other side — may be multiple; may be "unknown third-party infringer" for watch-triggered matters)
   - **Matter type** (read the plugin's practice profile for typical categories; for ip-legal: trademark clearance | trademark enforcement | DMCA | patent FTO | patent infringement | IP clause review | OSS compliance | portfolio maintenance | other)
   - **Confidentiality level** (standard | heightened | clean-team — heightened prompts extra care in cross-matter settings; clean-team common in patent FTO work)
   - **Key facts** (2–5 sentences: what this matter is about, who the stakeholders are, what's at stake)
   - **Matter-specific overrides to the practice posture** (e.g., "client wants aggressive posture for this mark only", "counterparty is a strategic partner — measured tone only", "inventor unavailable — don't surface for interview")
   - **Related matters** (slugs of any connected matters)
3. Write `matters/<slug>/matter.md` using the template below.
4. Seed `matters/<slug>/history.md` with a single "Opened" entry.
5. Create an empty `matters/<slug>/notes.md`.
6. Do **not** auto-switch to the new matter. Ask: "Want to switch to `<slug>` now? (`/ip-legal:matter-workspace switch <slug>`)"

### `list`

Enumerate `matters/*/matter.md`. Read each file's front-matter or first few lines to extract status. Print a table:

| Slug | Client | Matter type | Status | Opened | Active |
|---|---|---|---|---|---|

Mark the currently-active matter with `*`. Include `_archived/*` under a separate "Archived" heading if any exist.

### `switch <slug>`

1. Confirm `matters/<slug>/matter.md` exists. If not, offer `/ip-legal:matter-workspace new <slug>`.
2. Edit the `Active matter:` line in the practice-level CLAUDE.md to `Active matter: <slug>`.
3. Show the user the matter.md summary so they can confirm they're on the right matter.

### `close <slug>`

1. Confirm `matters/<slug>/` exists.
2. Append a "Closed" entry to `matters/<slug>/history.md` with today's date.
3. Move `matters/<slug>/` → `matters/_archived/<slug>/`.
4. If the closed matter was the active matter, set `Active matter:` to `none — practice-level context only`.

### `none`

Set `Active matter:` in the practice-level CLAUDE.md to `none — practice-level context only`. Confirm with the user.

## `matter.md` template

```markdown
[WORK-PRODUCT HEADER — per plugin config ## Outputs — differs by role; see `## Who's using this` in the practice-level CLAUDE.md]

# Matter: [Client] — [short description]

**Slug:** [slug]
**Opened:** [YYYY-MM-DD]
**Status:** active
**Confidentiality:** [standard / heightened / clean-team]

---

## Parties

**Client:** [name]
**Counterparty:** [name(s)]

## Matter type

[trademark clearance | trademark enforcement | DMCA | patent FTO | patent infringement | IP clause review | OSS compliance | portfolio maintenance | other — with one-line rationale]

## Key facts

[2–5 sentences. What this matter is about. Who the stakeholders are. What's at stake. What makes it different from the default posture.]

## Matter-specific overrides

*Any deviation from the practice-level posture that applies to this matter and only this matter.*

- [e.g., "Enforcement posture: measured here even though house default is aggressive — counterparty is a key channel partner."]
- [e.g., "Approval for assertion: extra sign-off from marketing required before any letter goes out."]
- [e.g., "Clean-team: matter files not readable even with cross-matter context on."]

## Related matters

- [slug — one line why related]

## Notes on confidentiality

[If heightened or clean-team, describe why. Who may see matter files. Whether cross-matter context is permissible even if globally on.]
```

## `history.md` seed

```markdown
# History: [Client] — [short description]

Append-only event log. Most recent at top.

---

## [YYYY-MM-DD] — Matter opened

Intake completed. Slug: `[slug]`. Status: active.
[Any initial context worth preserving beyond matter.md — e.g., "Opened in response to watch-service hit on `APEXLEAF` in class 25."]
```

## Cross-matter context

The practice-level CLAUDE.md has a `Cross-matter context:` flag. When it's `off` (the default), a skill working in matter A **never reads** files in `matters/B/` for any other `B`. Period. This is the confidentiality guarantee the setting exists to provide.

When it's `on`, a skill may read files across matter folders only when the user explicitly asks it to (e.g., "show me every enforcement letter we've sent on this mark across matters"). Even when `on`, the default is to load only the active matter unless the user asks for a cross-matter view.

## What this skill does not do

- **Run a conflicts check.** Conflicts are the practitioner's/firm's job; the intake captures what the user declares.
- **Enforce retention.** Closing archives a matter; it does not delete. Retention policy is out of scope.
- **Auto-route outputs.** The substantive skill decides where to write; this skill tells it *which folder* is active, not what to put in it.
- **Decide whether cross-matter is appropriate.** It reads the flag and obeys.

© Anthropic · Apache-2.0 · anthropics/claude-for-legal

Similar skills

All skills for Finance and business →

matter-workspace by other authors comes first.

matter-workspace official anthropics matter-workspace — a skill for Claude Code, Codex, Cursor, GitHub Copilot and other platforms that creates isolated workspaces for each matter or client. CX Codex +1 633installs matter-workspace official Anthropic The matter-workspace Claude Code skill manages separate workspaces for legal matters. Create a matter, switch the active context, list matters, or archive a closed one. CX Codex +1 ★ 10,060repo stars matter-workspace official Anthropic matter-workspace — a skill for Claude Code that isolates client matter context in private legal practice. It manages separate folders for each engagement so contexts never mix. CX Codex +1 ★ 10,060repo stars matter-workspace official Anthropic The matter-workspace Claude Code skill manages separate workspaces for client matters. It creates, lists, switches, and archives matters, or clears the active matter. CX Codex +1 ★ 10,060repo stars matter-workspace official Anthropic The matter-workspace Claude Code skill manages separate workspaces for legal matters. It creates, lists, switches, and archives matters, or detaches the active one. CX Codex +1 ★ 10,060repo stars warm-path-workspace crustdata warm-path-workspace builds an interactive HTML deal workspace for target accounts: buying-group maps, stakeholder dossiers, and weighted warm-intro paths mapped from your team's LinkedIn exports. CX Codex +1 342installs python-workspace terrylica python-workspace converts MQL5 indicators to Python and exports MetaTrader 5 data headlessly with automated correlation checks. CX Codex +1 131installs physics-matter phaserjs physics-matter helps AI agents configure Matter.js physics in Phaser 4, including rigid bodies, composite shapes, constraints, and mouse dragging. CX Codex +1 937installs Dark Matter Analyzer daffy0208 Dark Matter Analyzer audits codebases for hidden friction, documentation inflation, and divergence between goals and commits. Useful before major refactorings. CX Codex +1 128installs nx-workspace nrwl A skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that gives AI agents the commands to navigate an Nx workspace. CX Codex +1 100,600installs orca-per-workspace-env stablyai The orca-per-workspace-env Claude Code skill sets up and checks Orca environment recipes for individual workspaces. It applies to environmentRecipes in orca.yaml, provider scripts, and orca vm recipe doctor failures. CX Codex +1 12,600installs

From the same set174

The whole set →
cold-start-interview The cold-start-interview Claude Code skill interviews users about their legal practice and suggests a starter set of skills. It runs during first-time setup or when someone asks how to get started. CX Codex +1 ★ 10,060repo stars registry-sync The registry-sync Claude Code subagent checks watched skill registries and sends a digest of changes. Run it with “sync registries,” “anything new,” or let it follow its schedule. CX Codex ★ 10,060repo stars customize The customize Claude Code skill edits a law student’s study profile one section at a time. It responds to requests to update classes, study preferences, or bar exam plans. CX Codex +1 ★ 10,060repo stars cold-start-interview The cold-start-interview Claude Code skill builds a law student’s study profile and gathers course materials. It starts during initial setup or when asked to get started. CX Codex +1 ★ 10,060repo stars customize The customize Claude Code skill updates selected settings in an IP practice profile. It runs when asked to edit the profile, risk posture, contacts, or review rules. CX Codex +1 ★ 10,060repo stars cold-start-interview The cold-start-interview Claude Code skill interviews an IP practice and saves its working profile. Run it during initial setup, a repeat onboarding, or an MCP integration check. CX Codex +1 ★ 10,060repo stars ip-renewal-watcher The ip-renewal-watcher Claude Code subagent tracks deadlines in an intellectual property portfolio. It creates a ranked report on schedule or in response to a portfolio query. CX Codex ★ 10,060repo stars matter-workspace The matter-workspace Claude Code skill manages workspaces for separate client matters. It creates and lists matters, switches the active one, and archives closed matters. CX Codex +1 ★ 10,060repo stars

Project sponsors

Companies that keep this analytics open