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.
A strong, actionable legal-review skill with concrete checklists, a handoff schema, and well-sequenced validation checkpoints. Its main weaknesses are length/commentary padding and a monolithic single-file structure with no progressive disclosure into bundle references.
Suggestions
Trim editorial commentary (e.g. the "airlines negotiate ticket terms" line, "When (not if) we leave this vendor") to reduce token cost without losing the substantive guidance.
Move the detailed AI/ML 7-point procedure and the jurisdiction-delta table into a references/ file (e.g. SAAS-DEEP-DIVE.md) and link to it from SKILL.md to achieve one-level-deep progressive disclosure.
The "Reference: " prefix on the description frontmatter looks like a templating artifact; confirm whether it is intentional or should be removed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient, opinion-laden, playbook-specific guidance Claude would not already know (e.g. the 7-point AI/ML procedure, liability-cap decision procedure), but at ~246 lines it carries commentary padding such as "SaaS vendors, especially large ones, negotiate their paper about as willingly as airlines negotiate ticket terms" and "When (not if) we leave this vendor" that could be tightened. | 2 / 3 |
Actionability | Despite being instruction-only with no code, the guidance is highly concrete and copy-paste ready: per-term bullet checklists (renewal term length, notice-to-cancel window, notice method, price on renewal), a verbatim YAML handoff schema with exact fields, and a full markdown output memo template. | 3 / 3 |
Workflow Clarity | A clear end-to-end sequence (matter context → side determination → playbook → SaaS overlay 1-6 → AI/ML 7 steps → liability cap 4 steps → jurisdiction delta → output → handoffs) with explicit validation/stop checkpoints such as "If the matching side is [Not configured], stop and tell the user" and the "No silent supplement" stop-and-report block. | 3 / 3 |
Progressive Disclosure | The file is well-organized with clear headers, but it is a monolithic ~246-line SKILL.md with no bundle reference files (references/scripts/assets absent) and no one-level-deep "See X.md" splits — content like the AI/ML checklist and jurisdiction delta table that could live in separate files is all inline, so it is not a 3. | 2 / 3 |
Total | 10 / 12 Passed |