Content
86%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is a well-structured advisory skill: concrete commands and defaults make it immediately actionable, workflows are clearly sequenced with sensible attorney-review gates, and detail is appropriately split into one-level-deep reference files that all exist. The main inefficiency is a Keywords section that duplicates the frontmatter description and light boilerplate at the footer.
Suggestions
Remove the Keywords section — trigger terms belong in the frontmatter description (where they already appear); a 40-term keyword list in the body costs tokens without helping execution.
Make workflow checkpoints explicit validate-style gates (e.g., in Workflow 1: '4. Only after counter-proposals are drafted, bring the redline to outside counsel') to earn full workflow-clarity credit.
Trim the footer boilerplate ('Status: Production Ready') and fold the Adjacent Skills list into the References section to save tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — it maps 'Healthcare data → HIPAA' and 'Money movement → BSA/AML' without explaining what those regimes are, and gives concrete defaults ('1x non-participating is standard; 1x participating or 2x is hostile'). However, the Keywords section (~40 terms) duplicates trigger keywords that already live in the frontmatter description and serves no in-context purpose, and the footer ('Status: Production Ready') plus adjacent-skills list add boilerplate. That is minor trimmable material — matching anchor 4 — rather than the unnecessary explanations that would push it to 3. | 4 / 5 |
Actionability | Quick Start gives copy-paste-ready commands ('python scripts/contract_risk_scanner.py path/to/contract.txt', 'python scripts/term_sheet_analyzer.py path/to/term_sheet.json'), workflows name specific tools ('pip-licenses', 'license-checker'), the term sheet section gives concrete founder-friendly defaults, and the Output Standard is an exact fill-in template. Per the rubric's code-vs-instruction note, this instruction-only skill provides fully actionable, specific guidance covering the common cases. | 5 / 5 |
Workflow Clarity | Four workflows are clearly numbered and sequenced with review gates ('Always have a securities/venture attorney review before signing', 'engage a specialist counsel before building', 'Negotiate the worst 3 clauses'). Checkpoints are present but implicit rather than explicit validate-then-proceed steps, and there are no error-recovery feedback loops — anchor 4, not 5. No destructive or batch operations are involved, so the workflow-clarity cap of 3 does not apply. | 4 / 5 |
Progressive Disclosure | The SKILL.md is a well-organized overview: decision aids (trigger table, key questions, term sheet defaults) stay inline, while detail is pushed one level deep to three real, clearly signaled reference files ('contracts_playbook.md', 'ip_and_regulatory.md', 'term_sheet_decoder.md') listed with descriptions in a References section, plus two executable scripts. All referenced files exist and the references contain no nested references, so navigation is easy and one level deep. | 5 / 5 |
Total | 18 / 20 Passed |