evm-token-decimals

Prevent silent decimal mismatch bugs across EVM chains. Covers runtime decimal lookup, chain-aware caching, bridged-token precision drift, and safe normalization for bots, dashboards, and DeFi tools. Use when handling token amounts across EVM chains, or when a balance, price, or transfer amount is off by orders of magnitude.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tight, code-first skill body with executable examples across Python, TypeScript, Solidity, and CLI, plus a defensive fallback pattern and a clear rules summary. The main gaps are minor: undefined helper functions in examples, a distributed rather than explicitly ordered workflow, and all multi-language content inlined in a single file.

Suggestions

Define or note the 'get_web3_for_chain' helper (e.g., 'user-provided; returns a Web3 instance for the chain') so the caching example is fully copy-paste runnable.

Present the core procedure as one numbered sequence (query → cache by (chain_id, token) → exact math → defensive fallback → normalize) with an explicit verification step before pricing or comparison.

Consider moving the per-language examples into references/ files (e.g., examples/typescript.md) to keep SKILL.md as a leaner overview with one-level-deep, clearly signaled references.

Dimension	Reasoning	Score
Conciseness	The body is lean: a two-sentence motivating intro, a two-sentence 'How It Works', compact code examples, and terse rules — no explanations of concepts Claude already knows and no padding. Every token earns its place, matching the top anchor.	5 / 5
Actionability	The web3 Python, ethers TypeScript, Solidity, and 'cast' examples are concrete and near copy-paste ready, but the caching example depends on an undefined 'get_web3_for_chain' helper and the defensive snippet floats without its enclosing function. This is 'concrete code with minor gaps' rather than fully executable throughout.	4 / 5
Workflow Clarity	The sequence (query decimals at runtime → cache by (chain_id, token_address) → use exact math → normalize before comparison) is present via 'How It Works' and 'Rules', and the try/except logging is a checkpoint, but the steps are distributed rather than presented as one ordered workflow with validation checkpoints. Not a destructive or batch operation, so the cap at 3 does not apply.	4 / 5
Progressive Disclosure	The body (~123 lines) exceeds the under-50-line simple-skill exception, and all three languages' examples are inlined with clear section headers and no external references. Structure is good and content is mostly appropriately placed, but the multi-language examples could arguably be split into reference files, so it sits at the 'good structure; minor organization gaps' anchor.	4 / 5
	Total	17 / 20 Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it states concrete capabilities in third-person voice, includes an explicit 'Use when...' trigger clause with natural symptom-based phrasing, and occupies a distinct niche. Keyword coverage is good but misses a few common terms (e.g., 'ERC-20', 'token decimals', 'wei') that users would naturally say.

Suggestions

Add common trigger synonyms such as 'ERC-20', 'token decimals', or 'wei precision' to the 'Use when' clause to broaden natural keyword coverage.

Consider naming the token standard explicitly (ERC-20/ERC-20Metadata) so users searching by standard rather than symptom also match.

Dimension	Reasoning	Score
Specificity	The description lists multiple concrete capabilities — 'runtime decimal lookup', 'chain-aware caching', 'bridged-token precision drift', and 'safe normalization' — giving comprehensive coverage of the skill's actions. It clearly matches the anchor for multiple specific concrete actions rather than the level below, which allows minor gaps.	5 / 5
Completeness	It explicitly answers both what ('Prevent silent decimal mismatch bugs... Covers runtime decimal lookup, chain-aware caching, bridged-token precision drift, and safe normalization') and when ('Use when handling token amounts across EVM chains, or when a balance, price, or transfer amount is off by orders of magnitude') with concrete trigger phrases, matching the top anchor exactly.	5 / 5
Trigger Term Quality	Natural user phrasings like 'balance, price, or transfer amount is off by orders of magnitude' and 'handling token amounts across EVM chains' are present, but common variations such as 'ERC-20', 'token decimals', or 'wei' are missing. This fits the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive synonym coverage of 5.	4 / 5
Distinctiveness Conflict Risk	The EVM token-decimals niche is clear and the triggers (decimal mismatches, balances off by orders of magnitude, bridged-token precision) are distinct from generic token or DeFi skills. Minimal conflict risk with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: affaan-m/ECC
Path: skills/evm-token-decimals/SKILL.md
Commit: c70874f

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.