Content
78%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 strong, well-structured research-workflow skill: concrete formulas, estimation heuristics, an attribution checklist, and handled edge cases, with dated data properly pushed to a one-level-deep reference file. The residual weaknesses are the unspecified 'Visualizer tool' invocation, a small amount of context duplicated between the body and benchmarks.md, and no guidance for reconciling conflicting or missing search results.
Suggestions
Give step 5 a concrete anchor for the Visualizer tool — e.g., one example component spec or a pointer to a reference file with the chart template — so the visualization step is as executable as steps 2–4.
Deduplicate the macro context: keep only a one-line pointer in the Macro/AI Premium sections and let references/benchmarks.md carry the ZIRP premium and April 2026 drawdown details.
Add a short error-recovery note in step 1 or 2 for what to do when round data or ARR figures conflict or are missing (e.g., prefer dated primary sources, show the estimate range, and mark confidence).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and domain-specific with almost no padding — formulas, ARR estimation heuristics, and an attribution checklist that Claude cannot reconstruct from general knowledge. It sits at 4 rather than 5 because the ZIRP '~2–5x artificial premium' rule and the April 2026 meltdown context are stated inline in the Macro and AI Premium sections while also appearing in references/benchmarks.md, a small duplication that could be trimmed. Not 3 because there is no over-explanation of concepts Claude already knows. | 4 / 5 |
Actionability | Concrete, executable guidance dominates: exact metric formulas ('multiple_compression_pct = (later_multiple - earlier_multiple) / earlier_multiple × 100'), a data-model table with per-field extraction methods, numeric ARR heuristics by stage, a rated cause checklist, and five handled edge cases. It falls short of 5 because step 5 directs 'Use the Visualizer tool' and 'Follow the CSS variable system' without any concrete example or spec, leaving the visualization step the least executable. | 4 / 5 |
Workflow Clarity | Six clearly sequenced steps (gather → model → compute → attribute → visualize → summarize) with an explicit cause-rating checklist and data-integrity checkpoints ('note when a figure is estimated', 'flag your data confidence when ARR had to be estimated'). No error-recovery loop is specified — e.g., what to do when round data or ARR figures conflict or a search comes up empty for multiples — which keeps it below 5; the workflow is not destructive or batch-oriented, so no lower cap applies. | 4 / 5 |
Progressive Disclosure | The dated benchmark tables are correctly split into references/benchmarks.md (verified to exist), referenced inline at three well-signaled points and again in a 'Reference Files' section, one level deep with no nesting. The body reads as overview-plus-workflow and navigation is easy; the minor inline restatement of macro context is a hint rather than a duplicated data dump. | 5 / 5 |
Total | 17 / 20 Passed |