matter-workspace

Manage matter workspaces — new, list, switch, close, or detach (practice-level). Use when a multi-client practitioner needs to create a matter, switch the active matter, list matters, archive a matter, or detach to practice-level context, or when another skill needs to know which matter it's working in.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

77%Weight 40%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-sequenced skill body with strong validation checkpoints for its file-management operations. Its main weakness is conciseness — several sections duplicate content already stated earlier — and a monolithic layout where the templates could be split into reference files.

Suggestions

Remove the duplicate overview paragraph after the second '---' (lines 43-45) and the top-level 'Subcommands' list, keeping only the detailed 'Subcommand logic' section to eliminate redundancy.

Move the `matter.md` template and `history.md` seed into reference files under `references/` and link to them one level deep, slimming the main SKILL.md into an overview.

Consolidate the slug rule and the archiving-vs-deletion note so each appears once rather than in both the Notes and the detail sections.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and assumes competence (no explaining what a matter is), but the body repeats itself: the overview at line 43 re-explains the line-13 premise, the top "Subcommands" list duplicates the "Subcommand logic" section, and "Slugs are lowercase with hyphens" plus "archiving is not deletion" appear in both Notes and the detailed sections.	2 / 3
Actionability	Fully actionable: exact filesystem paths, the precise CLAUDE.md line to edit ("Active matter:"), a complete matter.md template, a history.md seed, and concrete directory moves — copy-paste ready with no pseudocode.	3 / 3
Workflow Clarity	Each subcommand is a clearly numbered sequence with explicit validation checkpoints — slug-collision check in `new`, existence check with fallback offer in `switch`, "confirm before writing", and the destructive `close` confirm→log→move→deactivate chain with feedback on the active-matter case.	3 / 3
Progressive Disclosure	Well-organized into clear sections, but it is a ~180-line monolithic file with no bundle references; the matter.md and history.md templates are reference-grade material that lives inline, fitting the anchor where content that should be separate is kept in the main file.	2 / 3
	Total	10 / 12 Passed

Description

100%Weight 40%Scale 1-3

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete actions, natural trigger terms, explicit what-and-when guidance, and a distinct niche scoped to multi-client legal practitioners. It concisely avoids fluff while covering both user-facing and skill-facing invocation cases.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "new, list, switch, close, or detach" — each a distinct operation, matching the anchor for listing several specific concrete actions rather than vague domain-naming.	3 / 3
Completeness	Explicitly answers both: what ("Manage matter workspaces — new, list, switch, close, or detach") and when ("Use when a multi-client practitioner needs to... or when another skill needs to know which matter it's working in"), satisfying the explicit-trigger anchor.	3 / 3
Trigger Term Quality	Uses natural practitioner phrasing — "create a matter, switch the active matter, list matters, archive a matter, or detach to practice-level context" — the terms a user would actually say, with good variation coverage.	3 / 3
Distinctiveness Conflict Risk	The "matter workspaces" niche for multi-client practitioners is a clear, distinct scope unlikely to fire for unrelated skills; third-person voice ("Manage") keeps it clean.	3 / 3
	Total	12 / 12 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: anthropics/claude-for-legal
Path: commercial-legal/skills/matter-workspace/SKILL.md
Commit: 4a6c651

Reviewed: 6 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.