Content
65%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 knowledge-rich, token-efficient reference with genuinely non-obvious domain data (impact thresholds, historical patterns, treasury red flags) and an actionable output template, but it reads as an encyclopedia rather than a procedure: no explicit step sequence, no validation checkpoints, and all reference material inlined in a long single file. Moving tables/calendars into reference files and numbering the analysis workflow would lift the two weakest dimensions.
Suggestions
Add an explicit numbered workflow (e.g., 1. fetch unlock calendar from tokenunlocks.app, 2. compute supply_pct and volume_multiple, 3. run treasury_signal, 4. assemble output per the template) with a validation step such as cross-checking unlock amounts against protocol docs.
Split the allocation taxonomy table, historical price-pattern table, and protocol unlock calendar into one-level-deep reference files (e.g., references/taxonomy.md, references/unlock-calendar.md) to shorten SKILL.md to an overview.
Provide a concrete, executable data-retrieval path (URL patterns or API calls for tokenunlocks.app / Messari) so the analysis code can run end-to-end instead of requiring hand-entered inputs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with domain-specific material Claude doesn't already know — threshold tables ("supply_pct > 10 → critical"), historical price-impact data, recipient-type multipliers — and never explains basic concepts. Minor over-explanation exists (e.g., the seven-row allocation taxonomy table and the "Tier 1 protocols to track" table are partially redundant with the analysis frameworks), keeping it below 5; it is well above 3 because nearly every section adds non-obvious, domain-specific data. | 4 / 5 |
Actionability | Provides mostly executable guidance: two complete Python functions with concrete thresholds, a data-source list (tokenunlocks.app, messari.io), a five-tier impact classifier, and a full output-format template. It stays below 5 because the code is framework logic without any data-retrieval path (the Notes admit unlock data "not available via OKX API" with no substitute command), so it isn't fully copy-paste end-to-end; it's above 3 because the code is real, executable Python rather than pseudocode. | 4 / 5 |
Workflow Clarity | The implicit workflow (gather tokenomics → assess unlock impact → evaluate emissions → check treasury → produce output) is discernible from section order and the output template, but steps are never sequenced explicitly and there are no validation checkpoints or feedback loops (e.g., cross-checking unlock data against multiple sources). It is analysis rather than a destructive/batch operation, so the rubric's cap-3 rule applies naturally: sequence present but implicit, checkpoints missing. | 3 / 5 |
Progressive Disclosure | Sections are well-organized with clear headers, but this is a 270-line single file with no bundle files at all (no references/, scripts/, or assets/), and substantial reference material (the allocation taxonomy table, the protocol unlock calendar, historical price tables) is inlined where it could live in one-level-deep reference files. Since the skill exceeds 50 lines and inlines content that clearly belongs in separate files, it fits the 'some structure but content that should be separate is inline' anchor rather than the well-split 4 or 5. | 3 / 5 |
Total | 14 / 20 Passed |