Content
87%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is concise and highly actionable with executable commands and efficient tables, and it discloses detail cleanly via one-level references. Its main gap is workflow clarity: it presents parallel commands rather than a sequenced, validated workflow, and the bundle contains an unreferenced, stale implementation.md.
Suggestions
Add a brief validation/error-recovery step in the body for when a command fails or returns default values (e.g., "If `current` reports `source: default`, check RPC connectivity per references/errors.md"), giving the read-only workflow an explicit feedback loop.
Surface a short sequenced workflow (e.g., the "Before a Large Transaction" check-optimal-predict-estimate flow currently only in examples.md) directly in the body so the multi-step process is visible without following a reference.
Remove or rewrite references/implementation.md: it is not referenced from the body and contains generic crypto boilerplate (Bash(crypto:gas-*), crypto-apis.env, crypto-reports/) that does not match this skill's actual scripts and references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and assumes Claude's competence — no explanation of what gas fees or blockchains are, uses compact tables for chains/tiers, and every section is actionable; matches the lean-and-efficient anchor rather than the mostly-efficient-but-could-tighten level 2. | 3 / 3 |
Actionability | All commands are fully executable and copy-paste ready (e.g. "cd ${CLAUDE_SKILL_DIR}/scripts && python3 gas_optimizer.py current --chain polygon") with real flags and example values, matching the fully-executable anchor rather than the pseudocode/incomplete level 2. | 3 / 3 |
Workflow Clarity | The numbered instructions are a menu of seven independent commands, not a sequenced process, and the body has no validation checkpoints or error-recovery feedback loops; this matches the steps-listed-but-checkpoints-missing anchor, falling short of level 3 which requires explicit validation steps. | 2 / 3 |
Progressive Disclosure | The body is a clean overview with well-signaled, one-level-deep references to errors.md and examples.md (both verified real files) and content appropriately split into tables and pointer sections, matching the clear-overview-with-one-level-references anchor; not level 2 because references are clearly signaled and content is properly separated. | 3 / 3 |
Total | 11 / 12 Passed |