Content
77%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.
The body is highly actionable with a clear sequenced workflow, concrete template, and sensible defaults. Its main weaknesses are redundancy between the Step 2 section descriptions and the Step 4 template, and a monolithic structure that could offload the template into a reference file.
Suggestions
Consolidate the Step 2 section descriptions and the Step 4 template into a single authoritative structure to remove the duplicated section list.
Move the full NDA output template into a reference file (e.g., references/nda-template.md) and keep SKILL.md as an overview pointing to it, improving progressive disclosure.
Add a brief final verification step (e.g., confirm all 15 required sections and a plain-English annotation are present) to close the workflow with an explicit output check.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely necessary domain content and avoids explaining basics Claude knows, but the Step 2 section-by-section descriptions duplicate the Step 4 output template (same sections restated with "[clause]"/"[Annotation]" placeholders), which could be consolidated; this fits level 2's "mostly efficient but could be tightened." | 2 / 3 |
Actionability | It provides a concrete output template, file-naming convention (NDA-[Party1]-[Party2]-[date].md), specific defaults (2-year term, 3/5-year survival), a fixed annotation block format, and per-section content guidance — actionable, specific instruction rather than vague direction, matching level 3 for an instruction-only skill. | 3 / 3 |
Workflow Clarity | The four steps are clearly sequenced with explicit gating checkpoints ("ask the user before proceeding" for missing critical info; "ask before generating" for jurisdiction) and a checklist of 15 required sections plus required/optional info, satisfying level 3's clear sequence with checkpoints; no destructive/batch operation cap applies. | 3 / 3 |
Progressive Disclosure | The skill is a well-sectioned single SKILL.md but is a monolithic ~280-line document with no bundle files, and the full output template (content that could live in a separate reference file) is inline, matching level 2's "content that should be separate is inline." | 2 / 3 |
Total | 10 / 12 Passed |