Agent skill

Add Explorer

Adds or repairs Diffyscan explorer API routing and response adapters for a new host, chain or payload format.

Install Add Explorer

skills CLI

$ npx skills add lidofinance/diffyscan --skill add-explorer -a claude-code

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

GitHub CLI

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

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 lidofinance/diffyscan --skill add-explorer -a codex

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

GitHub CLI

$ gh skill install lidofinance/diffyscan add-explorer --agent codex

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

Manual copy

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

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

GitHub CLI

$ gh skill install lidofinance/diffyscan add-explorer --agent cursor

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

Manual copy

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

--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 lidofinance/diffyscan --skill add-explorer -a gemini-cli

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

GitHub CLI

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

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 lidofinance/diffyscan --skill add-explorer -a github-copilot

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

Manual copy

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

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

Manual copy

$ git clone --depth 1 https://github.com/lidofinance/diffyscan.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/add-explorer .opencode/skills/add-explorer && 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 "add-explorer" agent skill from https://github.com/lidofinance/diffyscan/tree/main/.claude/skills/add-explorer into .opencode/skills/add-explorer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-explorer", 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: add-explorer
GitHub stars: 142
Token cost: ~1k tokens
SKILL.md length: 450 words
Files: 2 (incl. references)
Skills in repo: 5
Repo updated: Oct 6, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Adds or repairs Diffyscan explorer API routing and response adapters for a new host, chain or payload format.

Works in 3 steps: Decide whether code is needed → Implement and test → Document the supported behavior
Explorer support is missing
SKILL.md covers 1. Decide whether code is needed, 2. Implement and test and 3. Document the supported…
Calls uv

What it does

Add Explorer is an agent skill from lidofinance/diffyscan. Adds or repairs Diffyscan explorer API routing and response adapters for a new host, chain or payload format. Use when explorer support is missing or dispatches incorrectly. If an existing adapter supports the deployment, continue with new-config instead of changing code.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/response-mapping.md`).

It sits in Backend & APIs, covering Smart contracts. It works with Solidity. The repository describes itself as: Diffyscan detects deployment drift by comparing GitHub source with explorer-verified source and on-chain bytecode across EVM networks. The licence is MIT.

When your agent uses it

Explorer support is missing
Dispatches incorrectly

Example prompts

“/add-explorer”

Workflow steps

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

Decide whether code is needed
Implement and test
Document the supported behavior

What it can do on your machine

Read from SKILL.md and the folder at commit 9fd6833. 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:
- uv
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.
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

Add Explorer loads about 1k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 71 tokens; SKILL.md has 450 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~71
When it runs · the whole SKILL.md, loaded when a task matches: ~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~1.9k

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 lidofinance/diffyscan at commit 9fd6833, republished under its MIT licence (© lidofinance). 450 words, ~1,025 tokens.

Download SKILL.mdSave it as .claude/skills/add-explorer/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: add-explorer
description: Adds or repairs Diffyscan explorer API routing and response adapters for a new host, chain or payload format. Use when explorer support is missing or dispatches incorrectly. If an existing adapter supports the deployment, continue with new-config instead of changing code.
argument-hint: [explorer-name]
disable-model-invocation: true

Find the smallest change that supports the requested explorer. Run commands from the repository root.

1. Decide whether code is needed

Read the supported-explorer section of configuration and _get_explorer_fetcher in diffyscan/utils/explorer.py. Check the actual host and current official API documentation or a response fixture; a legacy config does not prove current service availability.

Existing Etherscan-compatible API: use its supported endpoint configuration. Etherscan v2 uses api.etherscan.io plus explorer_chain_id.
Existing Blockscout host match: config-only. Unrecognized domains fall through to Etherscan, which may return incomplete sources rather than an immediate error.
New Blockscout host: use exact hostname equality for a single requested host. Add a separate exact-match branch if necessary; this does not require refactoring existing routes. Use a domain suffix only when subdomain support is part of the task, with a dot boundary. Test near-misses including evil-<hostname>; copying a permissive existing endswith pattern would silently broaden the new route.
Different response format: add an adapter and dispatch rule, with token behavior based on the API requirements.

For config-only work use new-config. Avoid adding a fetcher for a chain already served by an existing one.

Read response mapping when implementing a fetcher or diagnosing lost source/settings fields; it covers payload keys, argument shapes and normalization pitfalls.

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

2. Implement and test

Inspect get_contract_from_explorer, the selected fetcher and helpers in diffyscan/utils/explorer.py. Dispatch returns (fetcher, requires_token); the caller chooses arguments from that flag. Runtime token loading happens before dispatch, even when an adapter does not send a token.

Use fetch from diffyscan/utils/http_client.py for shared headers, per-host pacing, bounded transient GET retries and error handling. Validate response objects and consumed field types before indexing them; malformed or unverified responses must raise ExplorerError. Normalize through existing helpers where applicable:

_build_source_files: primary and additional sources;
_build_solc_input: sources and compiler settings;
_build_contract_payload and _attach_contract_metadata: name, compiler, solcInput, constructor arguments, EVM version and linked libraries.

Preserve available settings and source paths. Distinguish missing constructor metadata from an empty value; resolve libraries to defining files. The zkSync adapter currently returns sources without the solcInput required downstream: treat this as an existing compatibility gap, not a template.

Add mocked tests in tests/test_explorer_utils.py for dispatch, normalized payload, error/unverified responses and relevant metadata. Isolate cache use so prior responses cannot make the tests pass. A routing-only change still needs a regression test.

uv run pytest -q tests/test_explorer_utils.py tests/test_http_client.py
uv run mypy
uv run black --check diffyscan tests

For broader adapter changes run the full suite. With credentials and a deployment fixture, run uv run diffyscan path/to/config.yaml --json and inspect source and bytecode results using JSON output. Mocked parsing tests do not prove end-to-end chain support.

3. Document the supported behavior

Update configuration when routing changes. Add a deployment config or .env.example entry only if needed for the task. Report behavior, tests and any unverified live integration.

Files

SKILL.md and 1 other file (references) in .claude/skills/add-explorer of lidofinance/diffyscan.

SKILL.md
references/response-mapping.md

Open the folder on GitHubat commit 9fd6833

Compare with similar skills

Add Explorer 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.

Add Explorer compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Add Explorer this skilllidofinance/diffyscan	142	—	~1k	Automated safety check: Pass	MIT	3 days ago
Foundry Deploy Fixturesaviggiano/security	144	—	~634	Automated safety check: Pass	MIT	24 days ago
function Object() { [native code] } Patternsccashwell/evm-cortex	131	—	~1.7k	Automated safety check: Pass	MIT	9 days ago
Test Fixturesccashwell/evm-cortex	131	—	~1.9k	Automated safety check: Pass	MIT	9 days ago
Fizz Convertpashov/skills	1.2k	2 repos	~3.7k	Automated safety check: Pass	MIT	4 days ago
Feynman Auditor0xiehnnkta/nemesis-auditor	243	1 repos	~11k	Automated safety check: Pass	MIT	6 mo ago

Similar skills

Foundry Deploy Fixtures
aviggiano/security
Create or refactor Foundry deployment fixtures for Solidity tests.
144 GitHub stars~634 tokensUpdated 24 days ago
Backend & APIsAuto-check passed
function Object() { [native code] } Patterns
ccashwell/evm-cortex
Constructor and initializer patterns for deploying Solidity contracts.
131 GitHub stars~1.7k tokensUpdated 9 days ago
Backend & APIsAuto-check passed
Test Fixtures
ccashwell/evm-cortex
A skill your agent uses when setting up test environments for Solidity protocols.
131 GitHub stars~1.9k tokensUpdated 9 days ago
Backend & APIsAuto-check passed
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
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

Questions about Add Explorer

What does Add Explorer do?

Adds or repairs Diffyscan explorer API routing and response adapters for a new host, chain or payload format. Add Explorer is an agent skill from lidofinance/diffyscan. Adds or repairs Diffyscan explorer API routing and response adapters for a new host, chain or payload format.

When should I use Add Explorer?

Add Explorer fits situations like: explorer support is missing; dispatches incorrectly.

How do I install Add Explorer in Claude Code?

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

How do I install Add Explorer in Codex?

Run `npx skills add lidofinance/diffyscan --skill add-explorer -a codex`. Or copy the skill folder (.claude/skills/add-explorer in lidofinance/diffyscan) into .agents/skills/add-explorer in your project. Codex loads it when a task matches its description.

Can I use Add Explorer 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 lidofinance/diffyscan --skill add-explorer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-explorer, .gemini/skills/add-explorer, .github/skills/add-explorer and .opencode/skills/add-explorer in your project.

What does Add Explorer need to run?

Going by SKILL.md and its folder, Add Explorer needs the command-line tools its instructions call (uv).

Does Add Explorer access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Add Explorer 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 Add Explorer use?

Add Explorer 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 Add Explorer use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 890 tokens, read only when the agent opens those files.

What are the alternatives to Add Explorer?

Skills that share tags, products or a category with Add Explorer: Foundry Deploy Fixtures (aviggiano/security, 144 stars), function Object() { [native code] } Patterns (ccashwell/evm-cortex, 131 stars), Test Fixtures (ccashwell/evm-cortex, 131 stars) and Fizz Convert (pashov/skills, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add Explorer?

lidofinance (a GitHub organization) maintains it in lidofinance/diffyscan, which has 142 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 6, 2026.

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

Add Explorer

Install Add Explorer

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

1. Decide whether code is needed

2. Implement and test

3. Document the supported behavior

Files

Compare with similar skills

Similar skills

Foundry Deploy Fixtures

function Object() { [native code] } Patterns

Test Fixtures

Fizz Convert

Feynman Auditor

Smart Contract Audit

More from lidofinance/diffyscan

Allowed Diffs

New Config

Validate Config

Debug Diff

Questions about Add Explorer

Install Add Explorer

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

1. Decide whether code is needed

2. Implement and test

3. Document the supported behavior

Files

Compare with similar skills

Similar skills

More from lidofinance/diffyscan

Related

Questions about Add Explorer