Agent skill

Debug Node Tracing

by worldcoin in worldcoin/world-chain

Debug World Chain nodes with temporary admintracingDirectives log filters and targeted log collection.

MITAuto-check passedDevelopment

Install Debug Node Tracing

skills CLI
$ npx skills add worldcoin/world-chain --skill debug-node-tracing -a claude-code

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

GitHub CLI
$ gh skill install worldcoin/world-chain debug-node-tracing --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/worldcoin/world-chain.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/debug-node-tracing .claude/skills/debug-node-tracing && 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
debug-node-tracing
GitHub stars
116
Token cost
~1.1k tokens
SKILL.md length
525 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Debug World Chain nodes with temporary admintracingDirectives log filters and targeted log collection.

  • Works in 5 steps: Filter Datadog logs by environment, pod,… → Correlate block, payload, transaction,… → Let the TTL expire, or restore early by… → …
  • Live Flashblocks
  • SKILL.md covers Check the target, Connect and apply, Collect and restore and Failures
  • Calls kubectl; needs ETH_RPC_JWT_SECRET

What it does

Debug Node Tracing is an agent skill from worldcoin/world-chain. Debug World Chain nodes with temporary admintracingDirectives log filters and targeted log collection. Use for live Flashblocks, networking, pool, builder, or validator debugging; not EVM transaction traces.

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 Development, covering Debugging and Smart contracts. The licence is MIT.

When your agent uses it

  • Live Flashblocks
  • Validator debugging
  • Not EVM transaction traces

Example prompts

  • “/debug-node-tracing”

Requirements

  • A credential in ETH_RPC_JWT_SECRET

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Filter Datadog logs by environment, pod, target, and the capture window. If DEBUG/TRACE is not shipped, inspect bounded pod logs or the…
  2. Correlate block, payload, transaction, and peer identifiers relevant to the symptom. Avoid collecting unrelated payloads or logging secrets.
  3. Let the TTL expire, or restore early by calling the same method with the returned revertsTo as directives and ttlSecs: 1. Do this only…
  4. Check for the world_chain::admin revert message or a revert failure. If restoration cannot be observed, report it as unverified. Stop the…
  5. Report the target/image, filter, capture window, evidence, and restoration status. Do not restart a node or change its deployment unless…

What it can do on your machine

Read from SKILL.md and the folder at commit 2b7dfe8. 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:

    • kubectl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use kubectl, 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:

    • ETH_RPC_JWT_SECRET

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

Context cost

Debug Node Tracing loads about 1.1k tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 525 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
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 worldcoin/world-chain at commit 2b7dfe8, republished under its MIT licence (© worldcoin). 525 words, ~1,084 tokens.

Download SKILL.mdSave it as .claude/skills/debug-node-tracing/SKILL.md (or your agent's skills folder).
name
debug-node-tracing
description
Debug World Chain nodes with temporary admin_tracingDirectives log filters and targeted log collection. Use for live Flashblocks, networking, pool, builder, or validator debugging; not EVM transaction traces.

Debug node tracing

Use World Chain's admin_tracingDirectives RPC to change a running node's log filter for a bounded time. Adapted from the local nodl skill; verify behavior against crates/rpc/src/admin.rs, crates/cli/src/app.rs, and crates/node/src/add_ons.rs.

Check the target

  • Establish the environment, pod, symptom, and time window from the debugging request. Start with one pod and a narrow target at debug for 120 seconds; use trace only when needed.
  • Check the deployed image and startup flags. Reload requires admin in an enabled --http.api or --ws.api at startup. This RPC uses that HTTP/WS server, not the Engine API on 8551.
  • Inspect startup stdout and file filters before changing them. Reload affects all reloadable outputs; expiry restores the stdout startup filter to every output. A different file filter is lost until restart. Preserve existing diagnostic coverage when choosing whether to use this RPC.
  • Overrides are process-wide. A new call replaces the active override and its timer. Do not interrupt another debugging session; renew deliberately before expiry when more time is needed.

Connect and apply

Builders require VPN access and pod port-forwarding in world-chain-builder. Contexts are tfh-crypto-{dev,stage,prod}-eu-central-2. Load the matching JWT from the configured secret store without printing it; port 8545 also requires authentication in this deployment.

Stage example; change the context, pod, and credential together for another target:

bash
kubectl --context tfh-crypto-stage-eu-central-2 -n world-chain-builder \
  port-forward --address 127.0.0.1 --pod-running-timeout=30s \
  pod/world-chain-builder-0 18545:8545

Keep that process running while collecting logs. Select targets from the deployed code's target: fields; examples in this repository include flashblocks::p2p, flashblocks::payload_builder, and flashblocks::state_executor.

The following example assumes the stdout baseline is info. Preserve any required baseline directives in the replacement filter:

bash
ETH_RPC_JWT_SECRET="$JWT_STAGE" cast rpc admin_tracingDirectives \
  '{"directives":"info,flashblocks::p2p=debug","ttlSecs":120}' \
  --rpc-url http://localhost:18545 --rpc-timeout 15

cast mints the bearer token from the raw JWT secret. Its flag is --jwt-secret; nodl uses --jwt and does not wrap this custom method. Never print credentials or enable shell tracing around authenticated commands.

Use camelCase ttlSecs. The allowed TTL is 1–3600 seconds; trimmed directives must be nonempty and at most 1024 bytes. Save the successful response's applied, ttlSecs, and revertsTo fields. A timeout leaves application uncertain; inspect logs before retrying, since a retry replaces the timer.

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

Collect and restore

  1. Filter Datadog logs by environment, pod, target, and the capture window. If DEBUG/TRACE is not shipped, inspect bounded pod logs or the configured on-pod log file.
  2. Correlate block, payload, transaction, and peer identifiers relevant to the symptom. Avoid collecting unrelated payloads or logging secrets.
  3. Let the TTL expire, or restore early by calling the same method with the returned revertsTo as directives and ttlSecs: 1. Do this only while your override still owns the session; do not overwrite a newer operator's filter.
  4. Check for the world_chain::admin revert message or a revert failure. If restoration cannot be observed, report it as unverified. Stop the port-forward you started.
  5. Report the target/image, filter, capture window, evidence, and restoration status. Do not restart a node or change its deployment unless the task authorizes it.

Failures

  • 401: verify the environment's JWT and forwarded port; do not remove authentication.
  • -32601 Method not found: check the deployed version, namespace, and port. Local source alone does not establish deployed support.
  • tracing reload is not active: startup did not install reload support. Report the required startup flag change; it cannot be enabled through this RPC.

© worldcoin, 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 .agents/skills/debug-node-tracing of worldcoin/world-chain.

Open the folder on GitHubat commit 2b7dfe8

Compare with similar skills

Debug Node Tracing 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.

Debug Node Tracing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Debug Node Tracing this skillworldcoin/world-chain116—~1.1kAutomated safety check: PassMIT
Linea Dependency MaintenanceConsensys-Incorporated/linea-attestation-registry1771 repos~3.7kAutomated safety check: WarnMIT
Logging Patternsdecebals/claude-code-java7511 repos~3.3kAutomated safety check: PassMIT
Arcium Encrypted Solana Computationsendaifun/skills130—~2.8kAutomated safety check: PassMIT
Debugging Local Task Agent RunsPostHog/posthog40k—~2.1kAutomated safety check: NotesCustom licence
Pashov Audit Pipelineccashwell/evm-cortex131—~5.5kAutomated safety check: PassMIT

Similar skills

  • Linea Dependency Maintenance

    Consensys-Incorporated/linea-attestation-registry

    Safely plan and execute dependency maintenance for JavaScript/TypeScript (npm, pnpm) and GitHub Actions, including npm lockfiles, pnpm workspaces, catalogs, overrides, SHA-pinned action versions…

    177 GitHub starsUsed in 1 repo~3.7k tokens
    DevelopmentAuto-check: warnings
  • Logging Patterns

    decebals/claude-code-java

    Java logging best practices with SLF4J, structured logging (JSON), and MDC for request tracing.

    751 GitHub starsUsed in 1 repo~3.3k tokens
    DevelopmentAuto-check passed
  • Builds and debugs Arcium encrypted computation apps on Solana: Arcis circuits, Anchor orchestration, encrypted inputs and the init, queue and callback flow.

    130 GitHub stars~2.8k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Official

    Debug the output of local PostHog task runs — the wizard cloud-run path that executes inside a Docker sandbox under the local Temporal process-task workflow (the wizard that integrates PostHog, then…

    40k GitHub stars~2.1k tokensUpdated today
    DevelopmentAuto-check: notes
  • Pashov Audit Pipeline

    ccashwell/evm-cortex

    A skill your agent uses when performing a comprehensive smart contract security audit.

    131 GitHub stars~5.5k tokensUpdated 8 days ago
    Backend & APIsAuto-check passed
  • Native Data Fetching

    CherryHQ/cherry-studio-app

    A skill your agent uses when implementing or debugging ANY network request, API call, or data fetching.

    4k GitHub starsUsed in 6 repos~2.9k tokens
    DevelopmentAuto-check: notes

More from worldcoin/world-chain

  • Check Wip1006 Config

    worldcoin/world-chain

    Inspect the active WIP-1006 factory configuration from an L1 AnchorStateRegistry at one finalized snapshot, including safety state, Nitro PCR approvals, and optional implementation comparison.

    116 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Investigate Game

    worldcoin/world-chain

    Verify an Ethereum address is a WIP1006 dispute game and report its status, claim, bonds, proof configuration, and proposal context in a compact debugging table.

    116 GitHub stars~533 tokensUpdated today
    Auto-check passed
  • Pending Games

    worldcoin/world-chain

    List unresolved WIP1006 dispute game addresses by scanning backward through at most the newest 2000 entries in a supplied factory.

    116 GitHub stars~550 tokensUpdated today
    Auto-check passed
  • Recovery Parent

    worldcoin/world-chain

    Find the nearest defender-winning, ASR claim-valid game backward in a WIP-1006 lineage for the proposer and defender recovery-parent flag.

    116 GitHub stars~570 tokensUpdated today
    Auto-check passed
  • Scan Invalid Games

    worldcoin/world-chain

    Scan WIP1006 games inside their challenge deadline for root claims that disagree with a supplied L2 consensus RPC at finalized L2 blocks, including challenge status and game creator.

    116 GitHub stars~532 tokensUpdated today
    Auto-check passed
  • Invalid Parent

    worldcoin/world-chain

    Trace a WIP1006 INVALIDPARENT cascade to its first ancestor with a different status or invalidation reason.

    116 GitHub stars~295 tokensUpdated today
    Auto-check passed

Questions about Debug Node Tracing

What does Debug Node Tracing do?

Debug World Chain nodes with temporary admintracingDirectives log filters and targeted log collection. Debug Node Tracing is an agent skill from worldcoin/world-chain. Debug World Chain nodes with temporary admintracingDirectives log filters and targeted log collection.

When should I use Debug Node Tracing?

Debug Node Tracing fits situations like: live Flashblocks; validator debugging; not EVM transaction traces.

How do I install Debug Node Tracing in Claude Code?

Run `npx skills add worldcoin/world-chain --skill debug-node-tracing -a claude-code`. Or copy the skill folder (.agents/skills/debug-node-tracing in worldcoin/world-chain) into .claude/skills/debug-node-tracing in your project. Claude Code loads it when a task matches its description.

How do I install Debug Node Tracing in Codex?

Run `npx skills add worldcoin/world-chain --skill debug-node-tracing -a codex`. Or copy the skill folder (.agents/skills/debug-node-tracing in worldcoin/world-chain) into .agents/skills/debug-node-tracing in your project. Codex loads it when a task matches its description.

Can I use Debug Node Tracing 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 worldcoin/world-chain --skill debug-node-tracing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/debug-node-tracing, .gemini/skills/debug-node-tracing, .github/skills/debug-node-tracing and .opencode/skills/debug-node-tracing in your project.

What does Debug Node Tracing need to run?

Going by SKILL.md and its folder, Debug Node Tracing needs the command-line tools its instructions call (kubectl) and credentials named ETH_RPC_JWT_SECRET. Our summary lists: A credential in ETH_RPC_JWT_SECRET.

Does Debug Node Tracing 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 Debug Node Tracing 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 Debug Node Tracing use?

Debug Node Tracing 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 Debug Node Tracing use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Debug Node Tracing?

Skills that share tags, products or a category with Debug Node Tracing: Linea Dependency Maintenance (Consensys-Incorporated/linea-attestation-registry, 177 stars), Logging Patterns (decebals/claude-code-java, 751 stars), Arcium Encrypted Solana Computation (sendaifun/skills, 130 stars) and Debugging Local Task Agent Runs (PostHog/posthog, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Debug Node Tracing?

worldcoin (a GitHub organization) maintains it in worldcoin/world-chain, which has 116 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 8, 2026.

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