Merged
Conversation
Add project guidance file and four custom skills: - /new-config: generate verification configs for new contracts - /validate-config: validate config files before running - /debug-diff: diagnose failed verifications - /add-explorer: guide for adding new blockchain explorer support
Contributor
There was a problem hiding this comment.
Pull request overview
Adds Claude Code–oriented repository guidance and a set of Claude skills intended to streamline creating, validating, debugging, and extending Diffyscan configurations/explorer support.
Changes:
- Introduces
CLAUDE.mdwith project commands, architecture notes, config schema summary, and style conventions. - Adds four Claude skills under
.claude/skills/for config generation/validation, troubleshooting diff failures, and adding new explorer support. - Documents explorer hostnames/tokens, common config pitfalls (YAML hex quoting), and suggested rerun/debug workflows.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 9 comments.
Show a summary per file
| File | Description |
|---|---|
CLAUDE.md |
Repository guidance for Claude Code: commands, architecture overview, config schema, env vars, style. |
.claude/skills/new-config/SKILL.md |
Skill instructions for generating new verification configs, including explorer hostname/token reference table. |
.claude/skills/validate-config/SKILL.md |
Skill instructions for validating config structure, addresses, and common mistakes before running Diffyscan. |
.claude/skills/debug-diff/SKILL.md |
Skill instructions for diagnosing failed runs via digest outputs and common root causes. |
.claude/skills/add-explorer/SKILL.md |
Skill instructions for adding a new explorer integration aligned with explorer.py dispatch/parsing. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
All 4 skills rewritten by writer agents and verified by devil's
advocate reviewer against actual source code.
Key fixes:
- new-config: fix hallucinated function name (_resolve_explorer_backend
-> _get_explorer_fetcher); add network field to template; prefer YAML
format; clarify explorer_hostname_env_var is CI convention only
- validate-config: accurate YAML hex validation description; clarify
what code validates vs best-practice recommendations; document
explorer_hostname_env_var as CI-only
- debug-diff: correct all paths (digest/{timestamp}/diffs/); real error
messages verified against code; clarify immutable diff returns False
- add-explorer: document Etherscan v2 as preferred; full dispatcher
table; all 4 fetcher endpoints and response formats documented
- new-config: scrollscan uses ETHERSCAN_EXPLORER_TOKEN fallback, not "no token" - debug-diff: complete the truncated library error message to match source
Contributor
There was a problem hiding this comment.
Pull request overview
Adds Claude Code-specific project guidance and reusable “skills” to help generate, validate, and troubleshoot diffyscan verification configs and explorer integrations.
Changes:
- Add
CLAUDE.mdwith repo commands, architecture overview, config schema summary, and style conventions. - Add Claude Code skills under
.claude/skills/for config creation, validation, diff debugging, and adding explorer support.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
CLAUDE.md |
New Claude Code guidance: commands, architecture, config schema summary, env vars, style. |
.claude/skills/new-config/SKILL.md |
Skill to generate new verification configs (schema + explorer hostname guidance). |
.claude/skills/validate-config/SKILL.md |
Skill to validate configs against TypedDict/runtime behavior + common pitfalls. |
.claude/skills/debug-diff/SKILL.md |
Skill to diagnose source/bytecode mismatches using digest outputs and common error signatures. |
.claude/skills/add-explorer/SKILL.md |
Skill describing explorer dispatch architecture and steps to add new explorer support. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- CLAUDE.md: add network key to config schema snippet - new-config: routescan hostname uses Etherscan fetcher, not Blockscout - add-explorer: document zkSync fetcher as outlier missing solcInput
- debug-diff: remove "suggests fixes" from description, drop discouraged --skip-binary-comparison and --log-level/--quiet flags - add-explorer: note limitations with flattened/single-file contracts - new-config: add best practices for strict configs
TheDZhon
approved these changes
Mar 16, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
.claude/skills/:/new-config— generate a verification config for a new contract/deployment, with full schema reference and per-chain explorer hostnames/validate-config— validate a config file before running (addresses, required fields, YAML quoting, cross-references)/debug-diff— diagnose failed verifications: walks through digest output, identifies root causes, suggests fixes/add-explorer— step-by-step guide for adding a new blockchain explorer API, covering the dispatch architecture inexplorer.pyTest plan
/new-configgenerates a valid config when invoked in Claude Code/validate-configcatches common mistakes (missing fields, unquoted YAML hex, bad addresses)/debug-diffprovides useful guidance after a faileddiffyscanrun/add-explorerinstructions are accurate against currentexplorer.pystructure