Content
75%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.
A well-structured, highly actionable body with verified scripts, concrete decision defaults, and a clean one-level-deep reference structure. The main cost is token efficiency: the Keywords section and the inline regulatory/contract detail duplicate content already carried by the frontmatter and reference files, and workflows lack explicit re-validation loops.
Suggestions
Trim or remove the Keywords section: it duplicates trigger terms already in the frontmatter description, which is what the skill-matching system reads.
Reduce body/reference duplication: replace the full 10-row regulatory trigger table with a compressed 3-4 trigger quick-reference and defer the complete mapping to references/ip_and_regulatory.md.
Add an explicit validation loop to Workflow 1 (e.g., re-run contract_risk_scanner.py on the counter-proposal redline and confirm HIGH findings are cleared before engaging outside counsel).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and practitioner-dense (no padding explaining concepts Claude already knows), but the ~40-term Keywords section largely duplicates the frontmatter description's trigger terms, and the regulatory trigger table and contract-type lists overlap content carried by the three reference files. This fits 'mostly efficient but could be tightened' better than level 4's 'minor instances of over-explanation', though it is well short of level 2's padded verbosity. | 3 / 5 |
Actionability | Quick Start commands are copy-paste ready and verified against the actual scripts ('python scripts/contract_risk_scanner.py path/to/contract.txt', 'term_sheet_analyzer.py' with optional path and embedded sample), workflows name concrete tools ('pip-licenses', 'license-checker' for npm), and decision defaults are specific ('1x non-participating is standard; 1x participating or 2x is hostile'; 'Standard: 12 months of fees'). An output template caps it off — specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | Four workflows are clearly numbered with concrete steps and explicit human-in-the-loop checkpoints ('Always have a securities/venture attorney review before signing', 'For each HIGH risk finding, draft a counter-proposal', 'Negotiate the worst 3 clauses'). Not level 5 because there are no explicit validate-and-retry loops (e.g., re-running the scanner after a redline); not level 3 because checkpoints like the attorney gate and severity filter are explicit rather than implicit. | 4 / 5 |
Progressive Disclosure | Scored against the actual bundle: three one-level-deep reference files exist, match their inline 'See references/...' signals, and contain no nested references; two scripts match the documented interface. Structure is good with a clear References section and Quick Start. Not level 5 due to body/reference duplication (trigger table and term-sheet clauses appear both inline and in the references) and the Adjacent Skills section pointing to ecosystem paths outside this bundle; not level 3 because navigation is clear and the split is largely appropriate. | 4 / 5 |
Total | 16 / 20 Passed |