Content
68%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 tight, code-centric security reference with executable hardened patterns and a practical checklist, well-structured for in-context use. Its main weakness is workflow clarity: the audit/checklist flow lacks explicit validation feedback loops, capping that dimension.
Suggestions
Add an explicit audit workflow with validation checkpoints, e.g. 'Run slither; if findings appear, triage by category below and re-run; only proceed to fuzzing when slither is clean.'
Resolve undefined helper placeholders (_calculateOut, _executeSwap) in the slippage example or mark them as intentionally abstracted.
Consider splitting the per-pattern examples into a references/ file and keeping SKILL.md as an overview + checklist, which would push progressive disclosure toward a 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: short prose takeaways ('Do not write your own guard when a hardened library exists.', 'Track internal accounting and measure actual tokens received.') and code-first examples with minimal preamble, though the 'How It Works' line and 'Execution Safety' paragraphs could be trimmed slightly. | 4 / 5 |
Actionability | Provides copy-paste-ready Solidity snippets for each vulnerability pattern plus real audit commands (slither, echidna, forge), but a few examples reference undefined helpers like _calculateOut/_executeSwap, leaving minor gaps. | 4 / 5 |
Workflow Clarity | It offers a usable sequence — review entrypoints against categories, apply the Security Checklist, then run audit tools — but validation checkpoints are implicit and there is no explicit 'if tool X fails, do Y' feedback loop, which the rubric treats as a validation gap. | 3 / 5 |
Progressive Disclosure | Well-organized into clear sections (When to Use, How It Works, Execution Safety, Examples, Security Checklist, Audit Tools) with no nested or buried references; no bundle files exist so all content lives appropriately in SKILL.md, with only minor opportunity to split the examples library. | 4 / 5 |
Total | 15 / 20 Passed |