Agent skill

Evm Token Decimals

Prevent silent decimal mismatch bugs across EVM chains. An agent skill from affaan-m/ECC.

Install Evm Token Decimals

skills CLI

$ npx skills add affaan-m/ECC --skill evm-token-decimals -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install affaan-m/ECC evm-token-decimals --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/evm-token-decimals .claude/skills/evm-token-decimals && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "evm-token-decimals" agent skill from https://github.com/affaan-m/ECC/tree/main/skills/evm-token-decimals into .claude/skills/evm-token-decimals/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "evm-token-decimals", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/affaan-m/ECC/tree/main/skills/evm-token-decimals

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add affaan-m/ECC --skill evm-token-decimals -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install affaan-m/ECC evm-token-decimals --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/evm-token-decimals .agents/skills/evm-token-decimals && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "evm-token-decimals" agent skill from https://github.com/affaan-m/ECC/tree/main/skills/evm-token-decimals into .agents/skills/evm-token-decimals/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "evm-token-decimals", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add affaan-m/ECC --skill evm-token-decimals -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install affaan-m/ECC evm-token-decimals --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/evm-token-decimals .cursor/skills/evm-token-decimals && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "evm-token-decimals" agent skill from https://github.com/affaan-m/ECC/tree/main/skills/evm-token-decimals into .cursor/skills/evm-token-decimals/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "evm-token-decimals", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/affaan-m/ECC.git --path skills/evm-token-decimals

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add affaan-m/ECC --skill evm-token-decimals -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install affaan-m/ECC evm-token-decimals --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/evm-token-decimals .gemini/skills/evm-token-decimals && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "evm-token-decimals" agent skill from https://github.com/affaan-m/ECC/tree/main/skills/evm-token-decimals into .gemini/skills/evm-token-decimals/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "evm-token-decimals", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install affaan-m/ECC evm-token-decimals

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add affaan-m/ECC --skill evm-token-decimals -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/evm-token-decimals .github/skills/evm-token-decimals && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "evm-token-decimals" agent skill from https://github.com/affaan-m/ECC/tree/main/skills/evm-token-decimals into .github/skills/evm-token-decimals/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "evm-token-decimals", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add affaan-m/ECC --skill evm-token-decimals -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install affaan-m/ECC evm-token-decimals --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/evm-token-decimals .opencode/skills/evm-token-decimals && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "evm-token-decimals" agent skill from https://github.com/affaan-m/ECC/tree/main/skills/evm-token-decimals into .opencode/skills/evm-token-decimals/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "evm-token-decimals", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: evm-token-decimals
GitHub stars: 277k
Used in: 2 other repos
Token cost: ~997 tokens
SKILL.md length: 178 words
Files: 1
Skills in repo: 683
Repo updated: Oct 11, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Prevent silent decimal mismatch bugs across EVM chains. An agent skill from affaan-m/ECC.

Handling token amounts across EVM chains
SKILL.md covers When to Use, How It Works, Examples and Rules
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
Transfer amount is off by orders of magnitude

What it does

Evm Token Decimals is an agent skill from affaan-m/ECC. 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.

Its SKILL.md is about 1000 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Smart contracts. The repository describes itself as: The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond. The licence is MIT.

When your agent uses it

Handling token amounts across EVM chains
Transfer amount is off by orders of magnitude

Example prompts

“/evm-token-decimals”

Requirements

Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 2d515e4. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are python, solidity, typescript and bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Evm Token Decimals loads about 997 tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 178 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~86
When it runs · the whole SKILL.md, loaded when a task matches: ~997

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from affaan-m/ECC at commit 2d515e4, republished under its MIT licence (© affaan-m). 178 words, ~997 tokens.

Download SKILL.mdSave it as .claude/skills/evm-token-decimals/SKILL.md (or your agent's skills folder).

name: evm-token-decimals
description: 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.
metadata.version: 1.0.0
metadata.origin: ECC direct-port adaptation

EVM Token Decimals

Silent decimal mismatches are one of the easiest ways to ship balances or USD values that are off by orders of magnitude without throwing an error.

When to Use

Reading ERC-20 balances in Python, TypeScript, or Solidity
Calculating fiat values from on-chain balances
Comparing token amounts across multiple EVM chains
Handling bridged assets
Building portfolio trackers, bots, or aggregators

How It Works

Never assume stablecoins use the same decimals everywhere. Query decimals() at runtime, cache by (chain_id, token_address), and use decimal-safe math for value calculations.

Examples

Query decimals at runtime

python

from decimal import Decimal
from web3 import Web3

ERC20_ABI = [
    {"name": "decimals", "type": "function", "inputs": [],
     "outputs": [{"type": "uint8"}], "stateMutability": "view"},
    {"name": "balanceOf", "type": "function",
     "inputs": [{"name": "account", "type": "address"}],
     "outputs": [{"type": "uint256"}], "stateMutability": "view"},
]

def get_token_balance(w3: Web3, token_address: str, wallet: str) -> Decimal:
    contract = w3.eth.contract(
        address=Web3.to_checksum_address(token_address),
        abi=ERC20_ABI,
    )
    decimals = contract.functions.decimals().call()
    raw = contract.functions.balanceOf(Web3.to_checksum_address(wallet)).call()
    return Decimal(raw) / Decimal(10 ** decimals)

Do not hardcode 1_000_000 because a symbol usually has 6 decimals somewhere else.

Cache by chain and token

python

from functools import lru_cache

@lru_cache(maxsize=512)
def get_decimals(chain_id: int, token_address: str) -> int:
    w3 = get_web3_for_chain(chain_id)
    contract = w3.eth.contract(
        address=Web3.to_checksum_address(token_address),
        abi=ERC20_ABI,
    )
    return contract.functions.decimals().call()

Handle odd tokens defensively

python

try:
    decimals = contract.functions.decimals().call()
except Exception:
    logging.warning(
        "decimals() reverted on %s (chain %s), defaulting to 18",
        token_address,
        chain_id,
    )
    decimals = 18

Log the fallback and keep it visible. Old or non-standard tokens still exist.

Normalize to 18-decimal WAD in Solidity

solidity

interface IERC20Metadata {
    function decimals() external view returns (uint8);
}

function normalizeToWad(address token, uint256 amount) internal view returns (uint256) {
    uint8 d = IERC20Metadata(token).decimals();
    if (d == 18) return amount;
    if (d < 18) return amount * 10 ** (18 - d);
    return amount / 10 ** (d - 18);
}

TypeScript with ethers

typescript

import { Contract, formatUnits } from 'ethers';

const ERC20_ABI = [
  'function decimals() view returns (uint8)',
  'function balanceOf(address) view returns (uint256)',
];

async function getBalance(provider: any, tokenAddress: string, wallet: string): Promise<string> {
  const token = new Contract(tokenAddress, ERC20_ABI, provider);
  const [decimals, raw] = await Promise.all([
    token.decimals(),
    token.balanceOf(wallet),
  ]);
  return formatUnits(raw, decimals);
}

Quick on-chain check

bash

cast call <token_address> "decimals()(uint8)" --rpc-url <rpc>

Rules

Always query decimals() at runtime
Cache by chain plus token address, not symbol
Use Decimal, BigInt, or equivalent exact math, not float
Re-query decimals after bridging or wrapper changes
Normalize internal accounting consistently before comparison or pricing

Files

Just SKILL.md in skills/evm-token-decimals of affaan-m/ECC.

Open the folder on GitHubat commit 2d515e4

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in affaan-m/ECC, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Evm Token Decimals next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Evm Token Decimals compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Evm Token Decimals this skillaffaan-m/ECC	277k	2 repos	~997	Automated safety check: Pass	MIT	today
Fizz Convertpashov/skills	1.2k	2 repos	~3.7k	Automated safety check: Pass	MIT	6 days ago
Solana Devsolana-foundation/solana-dev-skill	573	—	~3.8k	Automated safety check: Pass	MIT	2 days ago
Feynman Auditor0xiehnnkta/nemesis-auditor	243	1 repos	~11k	Automated safety check: Pass	MIT	6 mo ago
Smart Contract Auditgreatpie/smart-contract-audit-skill	101	—	~1.1k	Automated safety check: Pass	None	7 mo ago
RadarAuditware/radar	154	—	~2.1k	Automated safety check: Pass	GPL-3.0	1 mo ago

Similar skills

Fizz Convert
pashov/skills
Convert English-language properties in PROPERTIES.md (produced by the Fizz skill) into Solidity assertions inside the existing fuzz harness, then flip their checkboxes.
1.2k GitHub starsUsed in 2 repos~3.7k tokens
Backend & APIsAuto-check passed
Solana Dev
solana-foundation/solana-dev-skill
A skill your agent uses when user asks to "build a Solana dapp", "write an Anchor program", "create a token", "debug Solana errors", "set up wallet connection", "test my Solana program", "fuzz my…
573 GitHub stars~3.8k tokensUpdated 2 days ago
Backend & APIsAuto-check passed
Feynman Auditor
0xiehnnkta/nemesis-auditor
Deep business logic bug finder using the Feynman technique. An agent skill from 0xiehnnkta/nemesis-auditor.
243 GitHub starsUsed in 1 repo~11k tokens
Backend & APIsAuto-check passed
Smart Contract Audit
greatpie/smart-contract-audit-skill
Script-backed, out-of-box auditing workflow for Solidity/EVM repositories based on EVMbench detect/patch/exploit methodology.
101 GitHub stars~1.1k tokensUpdated 7 mo ago
Backend & APIsAuto-check passed
Radar
Auditware/radar
Use radar for smart contract security analysis, AST generation, and detection template development.
154 GitHub stars~2.1k tokensUpdated 1 mo ago
Backend & APIsAuto-check passed
Solidity Auditor
Gabson0x/bountyforge
Security audit of Solidity code while you develop. An agent skill from Gabson0x/bountyforge.
442 GitHub stars~3.7k tokensUpdated 24 days ago
Backend & APIsAuto-check passed

Questions about Evm Token Decimals

What does Evm Token Decimals do?

Prevent silent decimal mismatch bugs across EVM chains. An agent skill from affaan-m/ECC. Evm Token Decimals is an agent skill from affaan-m/ECC. Prevent silent decimal mismatch bugs across EVM chains.

When should I use Evm Token Decimals?

Evm Token Decimals fits situations like: handling token amounts across EVM chains; transfer amount is off by orders of magnitude.

How do I install Evm Token Decimals in Claude Code?

Run `npx skills add affaan-m/ECC --skill evm-token-decimals -a claude-code`. Or copy the skill folder (skills/evm-token-decimals in affaan-m/ECC) into .claude/skills/evm-token-decimals in your project. Claude Code loads it when a task matches its description.

How do I install Evm Token Decimals in Codex?

Run `npx skills add affaan-m/ECC --skill evm-token-decimals -a codex`. Or copy the skill folder (skills/evm-token-decimals in affaan-m/ECC) into .agents/skills/evm-token-decimals in your project. Codex loads it when a task matches its description.

Can I use Evm Token Decimals in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add affaan-m/ECC --skill evm-token-decimals -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/evm-token-decimals, .gemini/skills/evm-token-decimals, .github/skills/evm-token-decimals and .opencode/skills/evm-token-decimals in your project.

What does Evm Token Decimals need to run?

SKILL.md names no scripts, command-line tools or credentials: Evm Token Decimals is instructions for the agent only. Our summary lists: Python 3.

Does Evm Token Decimals access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Evm Token Decimals safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Evm Token Decimals use?

Evm Token Decimals is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Evm Token Decimals use?

About 997 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Evm Token Decimals?

Skills that share tags, products or a category with Evm Token Decimals: Fizz Convert (pashov/skills, 1.2k stars), Solana Dev (solana-foundation/solana-dev-skill, 573 stars), Feynman Auditor (0xiehnnkta/nemesis-auditor, 243 stars) and Smart Contract Audit (greatpie/smart-contract-audit-skill, 101 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Evm Token Decimals?

affaan-m (a GitHub user) maintains it in affaan-m/ECC, which has 276,673 GitHub stars. The repository holds 683 skills in this directory. The repository was last updated on October 11, 2026.

Source: affaan-m/ECC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Evm Token Decimals

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

EVM Token Decimals

When to Use

How It Works

Examples

Query decimals at runtime

Cache by chain and token

Handle odd tokens defensively

Normalize to 18-decimal WAD in Solidity

TypeScript with ethers

Quick on-chain check

Rules

Files

Used in 2 other repositories

Compare with similar skills

Similar skills

More from affaan-m/ECC

Related

Questions about Evm Token Decimals