Install the "debug-node-tracing" agent skill from https://github.com/worldcoin/world-chain/tree/main/.agents/skills/debug-node-tracing into .claude/skills/debug-node-tracing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "debug-node-tracing", 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.
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 worldcoin/world-chain --skill debug-node-tracing -a codex
Project install goes to .agents/skills/; add -g for ~/.codex/skills/.
Install the "debug-node-tracing" agent skill from https://github.com/worldcoin/world-chain/tree/main/.agents/skills/debug-node-tracing into .agents/skills/debug-node-tracing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "debug-node-tracing", 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 worldcoin/world-chain --skill debug-node-tracing -a cursor
Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.
Install the "debug-node-tracing" agent skill from https://github.com/worldcoin/world-chain/tree/main/.agents/skills/debug-node-tracing into .cursor/skills/debug-node-tracing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "debug-node-tracing", 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.
--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 worldcoin/world-chain --skill debug-node-tracing -a gemini-cli
Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.
Install the "debug-node-tracing" agent skill from https://github.com/worldcoin/world-chain/tree/main/.agents/skills/debug-node-tracing into .gemini/skills/debug-node-tracing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "debug-node-tracing", 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.
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 worldcoin/world-chain --skill debug-node-tracing -a github-copilot
Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.
Install the "debug-node-tracing" agent skill from https://github.com/worldcoin/world-chain/tree/main/.agents/skills/debug-node-tracing into .github/skills/debug-node-tracing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "debug-node-tracing", 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 worldcoin/world-chain --skill debug-node-tracing -a opencode
OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
Install the "debug-node-tracing" agent skill from https://github.com/worldcoin/world-chain/tree/main/.agents/skills/debug-node-tracing into .opencode/skills/debug-node-tracing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "debug-node-tracing", 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
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.
1Filter Datadog logs by environment, pod, target, and the capture window. If DEBUG/TRACE is not shipped, inspect bounded pod logs or the…
2Correlate block, payload, transaction, and peer identifiers relevant to the symptom. Avoid collecting unrelated payloads or logging secrets.
3Let the TTL expire, or restore early by calling the same method with the returned revertsTo as directives and ttlSecs: 1. Do this only…
4Check for the world_chain::admin revert message or a revert failure. If restoration cannot be observed, report it as unverified. Stop the…
5Report 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.
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:
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:
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
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.
Correlate block, payload, transaction, and peer identifiers relevant to the symptom. Avoid collecting unrelated payloads or logging secrets.
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.
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.
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.
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
Skill
Stars
Used in
Tokens
Auto-check
Licence
Repo updated
Debug Node Tracing this skillworldcoin/world-chain
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…
Builds and debugs Arcium encrypted computation apps on Solana: Arcis circuits, Anchor orchestration, encrypted inputs and the init, queue and callback flow.
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…
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.
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.
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.
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.