Content
81%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, methodology-driven skill body with an explicit multi-stage workflow, strong validation gates, and clean progressive disclosure into references and scripts. The main weaknesses are minor repetition of the sourcing rule, two dangling example-file references, and a largely procedural (rather than directly executable) analytical core.
Suggestions
Create the referenced examples/ directory with standard-analysis-example.md and forensic-analysis-example.md, or remove the Stage 8 instruction to read them before writing.
Consolidate the 'aggregators are navigation aids, filings are the source' rule into a single canonical statement and back-reference it, instead of restating it in Non-negotiables, Official records, and Stage 1.
Tighten the opening 'principle' X/Y illustration to one or two sentences so the skill reaches its procedural workflow sooner.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean and assumes Claude's competence (no 'what is a P/E' padding), but the aggregator-is-navigation-not-source rule is restated three times and the opening X/Y software-vs-distribution illustration is illustrative framing that could be trimmed. | 4 / 5 |
Actionability | Provides concrete copy-paste commands ('python scripts/verify_data.py <intake>.json', '--template', '--help'), a sector router table mapping company types to specific playbooks, and a concrete output naming convention, though the bulk of analytical guidance is procedural direction into references rather than inline executable steps. | 4 / 5 |
Workflow Clarity | Stages 0–10 are clearly sequenced with explicit validation checkpoints and feedback loops — the recency gate, 'Fix every error-level finding before proceeding' for verify_data.py, and the blocking lint_report.py gate — plus escalation rules and a depth-mode selection table. | 5 / 5 |
Progressive Disclosure | Clear overview with a reference-index table and one-level-deep references that are well signaled, but Stage 8 points to examples/standard-analysis-example.md and examples/forensic-analysis-example.md which do not exist, leaving two broken navigation links. | 4 / 5 |
Total | 17 / 20 Passed |