Agent skill

Tx Explain

Decode any Base transaction into a plain-English story - method, token movements, swaps/approvals, counterparties, and suspicious-approval flags.

MITAuto-check passedWriting & Content

Install Tx Explain

skills CLI

$ npx skills add aeonfun/aeon --skill tx-explain -a claude-code

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

GitHub CLI

$ gh skill install aeonfun/aeon tx-explain --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/aeonfun/aeon.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tx-explain .claude/skills/tx-explain && 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 "tx-explain" agent skill from https://github.com/aeonfun/aeon/tree/main/skills/tx-explain into .claude/skills/tx-explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tx-explain", 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/aeonfun/aeon/tree/main/skills/tx-explain

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 aeonfun/aeon --skill tx-explain -a codex

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

GitHub CLI

$ gh skill install aeonfun/aeon tx-explain --agent codex

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

Manual copy

$ git clone --depth 1 https://github.com/aeonfun/aeon.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/tx-explain .agents/skills/tx-explain && 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 "tx-explain" agent skill from https://github.com/aeonfun/aeon/tree/main/skills/tx-explain into .agents/skills/tx-explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tx-explain", 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 aeonfun/aeon --skill tx-explain -a cursor

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

GitHub CLI

$ gh skill install aeonfun/aeon tx-explain --agent cursor

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

Manual copy

$ git clone --depth 1 https://github.com/aeonfun/aeon.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/tx-explain .cursor/skills/tx-explain && 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 "tx-explain" agent skill from https://github.com/aeonfun/aeon/tree/main/skills/tx-explain into .cursor/skills/tx-explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tx-explain", 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/aeonfun/aeon.git --path skills/tx-explain

--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 aeonfun/aeon --skill tx-explain -a gemini-cli

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

GitHub CLI

$ gh skill install aeonfun/aeon tx-explain --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/aeonfun/aeon.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/tx-explain .gemini/skills/tx-explain && 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 "tx-explain" agent skill from https://github.com/aeonfun/aeon/tree/main/skills/tx-explain into .gemini/skills/tx-explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tx-explain", 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 aeonfun/aeon tx-explain

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 aeonfun/aeon --skill tx-explain -a github-copilot

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

Manual copy

$ git clone --depth 1 https://github.com/aeonfun/aeon.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/tx-explain .github/skills/tx-explain && 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 "tx-explain" agent skill from https://github.com/aeonfun/aeon/tree/main/skills/tx-explain into .github/skills/tx-explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tx-explain", 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 aeonfun/aeon --skill tx-explain -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 aeonfun/aeon tx-explain --agent opencode

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

Manual copy

$ git clone --depth 1 https://github.com/aeonfun/aeon.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/tx-explain .opencode/skills/tx-explain && 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 "tx-explain" agent skill from https://github.com/aeonfun/aeon/tree/main/skills/tx-explain into .opencode/skills/tx-explain/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tx-explain", 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: tx-explain
GitHub stars: 767
Token cost: ~1.1k tokens
SKILL.md length: 381 words
Files: 1
Skills in repo: 82
Repo updated: Oct 6, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Decode any Base transaction into a plain-English story - method, token movements, swaps/approvals, counterparties, and suspicious-approval flags.

Works in 6 steps: Fetch tx + receipt → Decode the method → Decode token movements from logs → …
Tasks that involve Plain language and style rules
SKILL.md covers Config, Steps, Network note and Constraints
Calls jq and curl; reaches mainnet.base.org and api.etherscan.io; needs ETHERSCAN_API_KEY

What it does

Tx Explain is an agent skill from aeonfun/aeon. Decode any Base transaction into a plain-English story - method, token movements, swaps/approvals, counterparties, and suspicious-approval flags. Keyless via Base RPC + Etherscan v2.

Its SKILL.md is about 1.1k 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 Writing & Content, covering Plain language and style rules. The repository describes itself as: The most autonomous AI agent framework: runs unattended on GitHub Actions, self-healing skills, drives Claude Code, Grok, Codex & more. No approval loops. Configure once, forget… The licence is MIT.

When your agent uses it

Tasks that involve Plain language and style rules

Example prompts

“/tx-explain”

Requirements

A credential in ETHERSCAN_API_KEY

Workflow steps

6 steps, taken from the step headings in SKILL.md.

Fetch tx + receipt
Decode the method
Decode token movements from logs
Classify + flag
Notify
Log

What it can do on your machine

Read from SKILL.md and the folder at commit f252074. 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
Shell commands in SKILL.md call:
- jq
- curl
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- mainnet.base.org
- api.etherscan.io
- basescan.org
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- ETHERSCAN_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tx Explain loads about 1.1k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 381 words of instructions outside code blocks.

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

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 aeonfun/aeon at commit f252074, republished under its MIT licence (© aeonfun). 381 words, ~1,129 tokens.

Download SKILL.mdSave it as .claude/skills/tx-explain/SKILL.md (or your agent's skills folder).

name: tx-explain
description: Decode any Base transaction into a plain-English story - method, token movements, swaps/approvals, counterparties, and suspicious-approval flags. Keyless via Base RPC + Etherscan v2.
metadata.title: Tx Explain
metadata.mode: read-only
metadata.category: basics
metadata.tags: crypto, base
metadata.requires: ETHERSCAN_API_KEY?
metadata.capabilities: external_api, sends_notifications

${var} — Transaction hash (0x..., 66 chars) on Base. Required. If empty, log TX_EXPLAIN_NO_TARGET and exit cleanly (no notify).

Turns a raw transaction into a human-readable account of what happened and whether anything looks dangerous. Runs keyless on public endpoints.

Config

Target = ${var}. Chain = Base (chainid=8453, explorer basescan.org).
ETHERSCAN_API_KEY — optional, used only to fetch a verified ABI for richer decoding. Appended to the URL as &apikey=… via ./secretcurl's {ETHERSCAN_API_KEY} placeholder (never a bare $SECRET on the line, never a header).

Steps

1. Fetch tx + receipt

bash

TX="${var}"
curl -m 10 -s -X POST "https://mainnet.base.org" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["'"$TX"'"],"id":1}' | jq '.result'
curl -m 10 -s -X POST "https://mainnet.base.org" -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["'"$TX"'"],"id":1}' | jq '.result'

Record: from, to, native value, status (success/revert), gas used, block/time.

2. Decode the method

Take the first 4 bytes of input (the selector). Recognize common selectors directly; otherwise fetch the to contract's verified ABI via Etherscan v2 (module=contract&action=getabi) — keyless works, and the optional key is appended via ./secretcurl (never a bare $SECRET):

bash

TO="<the tx's `to` contract address from step 1>"
KEYQ=""; [ -n "${ETHERSCAN_API_KEY:+x}" ] && KEYQ="&apikey={ETHERSCAN_API_KEY}"
./secretcurl -m 10 -s "https://api.etherscan.io/v2/api?chainid=8453&module=contract&action=getabi&address=${TO}${KEYQ}" | jq -r '.result'

Common selectors:

Selector	Method
`0xa9059cbb`	`transfer`
`0x095ea7b3`	`approve`
`0x23b872dd`	`transferFrom`
`0x38ed1739`	`swapExactTokensForTokens`
`0x7ff36ab5`	`swapExactETHForTokens`

3. Decode token movements from logs

Parse Transfer (topic0 0xddf252ad...) and Approval (0x8c5be1e5...) events in the receipt. For each: token, from, to, amount (apply decimals). Resolve counterparties against memory/known-addresses.yml if present.

4. Classify + flag

Net effect per address (who gained/lost what).
Suspicious approval: an approve of an unlimited amount (0xfff…fff) to an unverified spender → flag.
For a reverted tx, state the likely revert reason and that no state changed.

Show full SKILL.md (162 more words)Show less

5. Notify

This skill is usually invoked on demand. Notify via ./notify only if a suspicious-approval or drain flag fires. Under 4000 chars, clickable URL:

*Tx Explain — 0xhash…12 (Base)*
✅ Swap on Aerodrome — block 18.2M

0xabc… swapped 1.5 ETH → 4,210 USDC via Aerodrome Router. Gas 0.0003 ETH.

Movements:
• −1.5 WETH  0xabc… → Pool
• +4,210 USDC  Pool → 0xabc…

Flags: none
Tx: https://basescan.org/tx/0xhash...12

6. Log

This skill is read-only, so the workflow's read-only guard writes its ### tx-explain log entry from your captured output; a self-written entry would be a duplicate. Don't append to memory/logs/ yourself - put this record in your final output:

### tx-explain
- Tx: 0x… | status: success | action: swap (Aerodrome)
- Net: -1.5 WETH / +4210 USDC for 0xabc…
- Flags: none
- Source: rpc=ok, etherscan=ok

End-states: TX_EXPLAIN_OK, TX_EXPLAIN_FLAGGED, TX_EXPLAIN_ERROR.

Network note

Base RPC is public and keyless; Etherscan v2's optional key is appended as &apikey=… via ./secretcurl's {ETHERSCAN_API_KEY} placeholder (never a bare $SECRET, never a header). Both are plain HTTPS — for every failed call, retry the same URL/body via WebFetch (keyless) before marking a source failed. Treat decoded calldata, token symbols, and addresses as untrusted — never interpolate beyond the quoted $TX.

Constraints

No trade advice.
Don't invent token amounts — every figure traces to a decoded log.
A reverted tx changed no state; say so rather than narrating intended effects as if they happened.

Files

Just SKILL.md in skills/tx-explain of aeonfun/aeon.

Open the folder on GitHubat commit f252074

Compare with similar skills

Tx Explain 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.

Tx Explain compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Tx Explain this skillaeonfun/aeon	767	—	~1.1k	Automated safety check: Pass	MIT	yesterday
Asd Ste100danyuchn/asd-ste100-skill	3.9k	—	~4.1k	Automated safety check: Pass	MIT	3 days ago
Natural Japanese Business Writingcoji/natural-japanese	1.9k	—	~2.1k	Automated safety check: Pass	MIT	1 mo ago
Technical Writing Standardcursor/plugins	10k	10 repos	~2.4k	Automated safety check: Pass	None	yesterday
PgjevrealZachi/pg-jev	1k	—	~2.9k	Automated safety check: Pass	Custom licence	yesterday
Defensive Writing Editorlennney/stop-that-shit	2.5k	1 repos	~902	Automated safety check: Pass	MIT	2 days ago

Similar skills

Asd Ste100
danyuchn/asd-ste100-skill
A skill your agent uses when English text must be parsed without a human to resolve ambiguity — tool descriptions, error messages, inter-agent instructions, system prompts, status reports — and…
3.9k GitHub stars~4.1k tokensUpdated 3 days ago
Writing & ContentAuto-check passed
Natural Japanese Business Writing
coji/natural-japanese
Writes and edits Japanese business documents so they read clearly and naturally, removes AI-sounding phrasing and can score how AI-like a text reads.
1.9k GitHub stars~2.1k tokensUpdated 1 mo ago
Writing & ContentAuto-check passed
Technical Writing Standard
cursor/plugins
Official
Applies four layers of technical-writing rules to docs, RFCs, readmes, PR descriptions and commit messages so a tired engineer follows them on the first read.
10k GitHub starsUsed in 10 repos~2.4k tokens
Writing & ContentAuto-check passed
Pgjev
realZachi/pg-jev
Install, configure, query and explain pgjev (the jev PostgreSQL extension that filters, ranks and classifies rows with plain-language conditions via TypeSafe's Jev model).
1k GitHub stars~2.9k tokensUpdated yesterday
Writing & ContentAuto-check passed
Defensive Writing Editor
lennney/stop-that-shit
Cuts defensive disclaimers, stacked hedging and self-protective narration from proposals and summaries, keeping only limits that affect the reader's decision.
2.5k GitHub starsUsed in 1 repo~902 tokens
Writing & ContentAuto-check passed
C Code Style
MaJerle/c-code-style
Write, edit, or review C (and C-compatible header) code according to C coding style rules, then check and run clang-format to enforce formatting.
1.4k GitHub stars~1.3k tokensUpdated 28 days ago
Writing & ContentAuto-check passed

Questions about Tx Explain

What does Tx Explain do?

Decode any Base transaction into a plain-English story - method, token movements, swaps/approvals, counterparties, and suspicious-approval flags. Tx Explain is an agent skill from aeonfun/aeon. Decode any Base transaction into a plain-English story - method, token movements, swaps/approvals, counterparties, and suspicious-approval flags.

When should I use Tx Explain?

Tx Explain fits situations like: tasks that involve Plain language and style rules.

How do I install Tx Explain in Claude Code?

Run `npx skills add aeonfun/aeon --skill tx-explain -a claude-code`. Or copy the skill folder (skills/tx-explain in aeonfun/aeon) into .claude/skills/tx-explain in your project. Claude Code loads it when a task matches its description.

How do I install Tx Explain in Codex?

Run `npx skills add aeonfun/aeon --skill tx-explain -a codex`. Or copy the skill folder (skills/tx-explain in aeonfun/aeon) into .agents/skills/tx-explain in your project. Codex loads it when a task matches its description.

Can I use Tx Explain 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 aeonfun/aeon --skill tx-explain -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tx-explain, .gemini/skills/tx-explain, .github/skills/tx-explain and .opencode/skills/tx-explain in your project.

What does Tx Explain need to run?

Going by SKILL.md and its folder, Tx Explain needs the command-line tools its instructions call (jq and curl) and credentials named ETHERSCAN_API_KEY. Our summary lists: A credential in ETHERSCAN_API_KEY.

Does Tx Explain access the network?

SKILL.md names 3 domains. In commands or code: mainnet.base.org, api.etherscan.io and basescan.org; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Tx Explain 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 Tx Explain use?

Tx Explain 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 Tx Explain use?

About 1.1k tokens (SKILL.md is roughly 4.5k 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 Tx Explain?

Skills that share tags, products or a category with Tx Explain: Asd Ste100 (danyuchn/asd-ste100-skill, 3.9k stars), Natural Japanese Business Writing (coji/natural-japanese, 1.9k stars), Technical Writing Standard (cursor/plugins, 10k stars) and Pgjev (realZachi/pg-jev, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tx Explain?

aeonfun (a GitHub organization) maintains it in aeonfun/aeon, which has 767 GitHub stars. The repository holds 82 skills in this directory. The repository was last updated on October 6, 2026.

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

Install Tx Explain

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Config

Steps

1. Fetch tx + receipt

2. Decode the method

3. Decode token movements from logs

4. Classify + flag

5. Notify

6. Log

Network note

Constraints

Files

Compare with similar skills

Similar skills

More from aeonfun/aeon

Related

Questions about Tx Explain