Content
87%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A lean, well-structured instruction skill that delegates detail to a clearly signaled reference skill. Its main weakness is the batch-processing workflow, which lacks an explicit validation/coverage checkpoint before reporting results.
Suggestions
Add a verification checkpoint before reporting surfaced items — e.g., step 3.5: confirm every batch item was reviewed and reconcile the coverage log against the sources checklist before showing the surface ratio.
Make the coverage gate explicit in the workflow: only prompt to update the sources checklist after confirming the batch was fully processed with no ingestion or parse errors.
Specify what to do on a failed/partial batch (retry, flag, log a gap) so the batch operation has a feedback loop rather than a single forward pass.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean body (~25 lines) with no concept-explanation padding; it assumes Claude's competence and points to detail elsewhere. The opening sentence lightly restates the description, but overall every section earns its place. Not a 2 because there is no unnecessary explanation beyond that minor restate. | 3 / 3 |
Actionability | Instructions name exact, executable targets — the path '~/.claude/plugins/config/claude-for-legal/employment-legal/CLAUDE.md', 'the internal-investigation reference skill and run Mode 2 (Add data)', and concrete outputs (surface ratio, surfaced items, sources checklist). For an instruction-only skill this is specific and actionable. | 3 / 3 |
Workflow Clarity | Steps 1–4 are clearly sequenced, but this is a batch operation ('Processes document batches') with no validation/verification checkpoint before reporting surfaced items; the rubric caps batch workflows at 2 when feedback loops are missing. Not a 3 because there is no explicit validate-then-proceed step; not a 1 because the sequence itself is present. | 2 / 3 |
Progressive Disclosure | Clear overview with a single, well-signaled one-level-deep reference — the blockquote states the detailed needle-finding process, log format, surface-ratio rules, and checklist tracking 'live in the internal-investigation reference skill — load it before doing substantive work'. Content is appropriately split and easy to navigate. | 3 / 3 |
Total | 11 / 12 Passed |