Agent skill

New Config

by lidofinance in lidofinance/diffyscan

Creates or extends a Diffyscan verification config for a deployed contract or deployment.

MITAuto-check passedBackend & APIs

Install New Config

skills CLI
$ npx skills add lidofinance/diffyscan --skill new-config -a claude-code

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

GitHub CLI
$ gh skill install lidofinance/diffyscan new-config --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/new-config .claude/skills/new-config && 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/

Facts

Skill name
new-config
GitHub stars
142
Token cost
~1k tokens
SKILL.md length
437 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Creates or extends a Diffyscan verification config for a deployed contract or deployment.

  • Works in 3 steps: Establish the inputs → Write the config → Verify and hand off
  • Adding addresses
  • SKILL.md covers 1. Establish the inputs, 2. Write the config and 3. Verify and hand off
  • Calls uv; needs ETHERSCAN_EXPLORER_TOKEN and GITHUB_API_TOKEN

What it does

New Config is an agent skill from lidofinance/diffyscan. Creates or extends a Diffyscan verification config for a deployed contract or deployment. Use for adding addresses, pinning GitHub sources and dependencies, or setting up a chain in configs/. Existing failing runs belong to debug-diff; explorer adapter code belongs to add-explorer.

Its SKILL.md is about 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 Backend & APIs, covering Smart contracts and Deployment. It works with GitHub and 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

  • Adding addresses
  • Pinning GitHub sources and dependencies
  • Setting up a chain in configs/

Example prompts

  • “Use the new-config skill to create or extends a Diffyscan verification config for a deployed contract or deployment”
  • “/new-config”

Requirements

  • A credential in ETHERSCAN_EXPLORER_TOKEN
  • A credential in GITHUB_API_TOKEN

Workflow steps

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

  1. Establish the inputs
  2. Write the config
  3. Verify and hand off

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 these keys or tokens, usually read from environment variables:

    • ETHERSCAN_EXPLORER_TOKEN
    • GITHUB_API_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

New Config loads about 1k tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 437 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~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 lidofinance/diffyscan at commit 9fd6833, republished under its MIT licence (© lidofinance). 437 words, ~1,009 tokens.

Download SKILL.mdSave it as .claude/skills/new-config/SKILL.md (or your agent's skills folder).
name
new-config
description
Creates or extends a Diffyscan verification config for a deployed contract or deployment. Use for adding addresses, pinning GitHub sources and dependencies, or setting up a chain in configs/. Existing failing runs belong to debug-diff; explorer adapter code belongs to add-explorer.
argument-hint
[chain] [contract-address] [github-repo-url]
disable-model-invocation
true

Create a reproducible config covering the requested deployment. Run commands from the repository root.

1. Establish the inputs

Read configuration and a nearby config under configs/<project>/<mainnet|testnet>/. Confirm the chain, addresses and names, expected GitHub commit, source root, and explorer/RPC selection from deployment records and the user's context. Ask for information that cannot be established; do not invent a commit or shrink the requested contract set.

Use add-explorer if the host needs routing or API support. Check current official explorer documentation before choosing an endpoint; an old config does not establish current API availability.

2. Write the config

Use YAML unless another format is requested. Quote addresses and hexadecimal values. Follow project naming and include:

  • contracts: deployed address to explorer contract name;
  • explorer_hostname or explorer_hostname_env_var (the explicit hostname takes precedence);
  • explorer_chain_id when the chosen API needs it;
  • github_repo: url, full commit SHA, and relative_root;
  • dependencies: import-prefix mappings pinned to full commits, or {} for repository config tests.

network is optional descriptive metadata. Add other optional fields only when needed. Store credential environment-variable names, not secrets. Set explorer_token_env_var to an available token variable, or confirm the ETHERSCAN_EXPLORER_TOKEN fallback is available. The runtime loads an explorer token and GITHUB_API_TOKEN even for adapters that do not send the explorer token. Bytecode comparison also needs the configured RPC URL; confirm its chain.

Read bytecode comparison before adding manual overrides. Prefer explorer constructor metadata when it describes the deployment; manual calldata is not required for every constructor. Set only one of constructor_args and constructor_calldata per address. Key libraries by their definition file; the mapping applies to every contract in the config. Use deployment_from for a constructor that depends on its caller and extra_sources for required GitHub files missing from the explorer source set.

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

For proxies, distinguish proxy and implementation addresses and confirm requested scope from deployment records and on-chain state. Obtain missing calldata from the creation trace and exact creation-bytecode boundary, then ABI-decode it. An address substring is not a reliable boundary; matching addresses across chains alone do not establish identical calldata.

If constructor metadata is missing, follow calldata recovery before writing an override.

3. Verify and hand off

Apply validate-config, then run the requested verification when credentials are available:

sh
uv run diffyscan path/to/config.yaml --json -E -G

Read JSON output: check status, errors, contract coverage and enabled comparisons as well as the exit code. Caches help repeated diagnosis; omit -E when fresh explorer evidence is needed. For a failed run use debug-diff; for explained exceptions use allowed-diffs.

Keep unverified contracts visible as unresolved scope. Do not comment them out, disable comparison, or accept proxy immutables merely to obtain a passing run. Report config paths, deployment/source evidence, checks performed and unresolved verification.

© lidofinance, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/new-config of lidofinance/diffyscan.

Open the folder on GitHubat commit 9fd6833

Compare with similar skills

New Config 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.

New Config compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
New Config this skilllidofinance/diffyscan142—~1kAutomated safety check: PassMIT
Foundry Deploy Fixturesaviggiano/security144—~634Automated safety check: PassMIT
function Object() { [native code] } Patternsccashwell/evm-cortex131—~1.7kAutomated safety check: PassMIT
Test Fixturesccashwell/evm-cortex131—~1.9kAutomated safety check: PassMIT
Foundry Differential Testsaviggiano/security144—~613Automated safety check: PassMIT
Cross Chain Securityccashwell/evm-cortex131—~1.7kAutomated safety check: PassMIT

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
  • Test Fixtures

    ccashwell/evm-cortex

    A skill your agent uses when setting up test environments for Solidity protocols.

    131 GitHub stars~1.9k tokensUpdated 10 days ago
    Backend & APIsAuto-check passed
  • Foundry Differential Tests

    aviggiano/security

    Create Foundry differential tests comparing production Solidity contracts against an independent reference model.

    144 GitHub stars~613 tokensUpdated 24 days ago
    Backend & APIsAuto-check passed
  • Cross Chain Security

    ccashwell/evm-cortex

    Cross-chain security patterns for multi-chain Solidity deployments and bridge interactions.

    131 GitHub stars~1.7k tokensUpdated 10 days ago
    Backend & APIsAuto-check passed
  • Gh Update PR Description

    lidofinance/staking-modules

    Update the current-branch GitHub PR title, description, and labels with gh CLI using this repository's PR template.

    119 GitHub stars~568 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from lidofinance/diffyscan

  • Add Explorer

    lidofinance/diffyscan

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

    142 GitHub stars~1k tokensUpdated 4 days ago
    Auto-check passed
  • Allowed Diffs

    lidofinance/diffyscan

    Adds, reviews or tightens Diffyscan alloweddiffs rules for explained source or bytecode differences, including replacing any wildcards with granular rules.

    142 GitHub stars~1.2k tokensUpdated 4 days ago
    Auto-check passed
  • Validate Config

    lidofinance/diffyscan

    Reviews an existing Diffyscan YAML or JSON config for load errors, runtime prerequisites, pinned sources, address mappings and broad exceptions.

    142 GitHub stars~1.1k tokensUpdated 4 days ago
    Auto-check passed
  • Debug Diff

    lidofinance/diffyscan

    Diagnoses failed or incomplete Diffyscan runs, unexpected source or bytecode differences, compilation failures and explorer or RPC errors.

    142 GitHub stars~1.2k tokensUpdated 4 days ago
    Auto-check passed

Works with

Questions about New Config

What does New Config do?

Creates or extends a Diffyscan verification config for a deployed contract or deployment. New Config is an agent skill from lidofinance/diffyscan. Creates or extends a Diffyscan verification config for a deployed contract or deployment.

When should I use New Config?

New Config fits situations like: adding addresses; pinning GitHub sources and dependencies; setting up a chain in configs/.

How do I install New Config in Claude Code?

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

How do I install New Config in Codex?

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

Can I use New Config 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 new-config -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/new-config, .gemini/skills/new-config, .github/skills/new-config and .opencode/skills/new-config in your project.

What does New Config need to run?

Going by SKILL.md and its folder, New Config needs the command-line tools its instructions call (uv) and credentials named ETHERSCAN_EXPLORER_TOKEN and GITHUB_API_TOKEN. Our summary lists: A credential in ETHERSCAN_EXPLORER_TOKEN; A credential in GITHUB_API_TOKEN.

Does New Config 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 New Config 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 New Config use?

New Config 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 New Config use?

About 1k 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 New Config?

Skills that share tags, products or a category with New Config: 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 Foundry Differential Tests (aviggiano/security, 144 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains New Config?

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.