Agent skill

Recovery Parent

by worldcoin in 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.

MITAuto-check passedAI & LLM Engineering

Install Recovery Parent

skills CLI
$ npx skills add worldcoin/world-chain --skill recovery-parent -a claude-code

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

GitHub CLI
$ gh skill install worldcoin/world-chain recovery-parent --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/recovery-parent .claude/skills/recovery-parent && 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
recovery-parent
GitHub stars
116
Token cost
~570 tokens
SKILL.md length
285 words
Files
2 (incl. scripts)
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

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

  • Tasks that involve Speech recognition and synthesis
  • Runs Python scripts from its folder; calls python3

What it does

Recovery Parent is an agent skill from 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.

Its SKILL.md is about 570 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/find_parent.py`).

It sits in AI & LLM Engineering, covering Speech recognition and synthesis. The licence is MIT.

When your agent uses it

  • Tasks that involve Speech recognition and synthesis

Example prompts

  • “/recovery-parent”

Requirements

  • Python 3

What it can do on your machine

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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    No URLs in SKILL.md.

    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

Recovery Parent loads about 570 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 285 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~570

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); the scripts in this folder are not scanned.

SKILL.md

The full file from worldcoin/world-chain at commit 0733816, republished under its MIT licence (© worldcoin). 285 words, ~570 tokens.

Download SKILL.mdSave it as .claude/skills/recovery-parent/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
recovery-parent
description
Find the nearest defender-winning, ASR claim-valid game backward in a WIP-1006 lineage for the proposer and defender recovery-parent flag.

Run python3 scripts/find_parent.py <game-address> <mainnet|sepolia>, resolving the script relative to this skill directory. Execute directly; read the script only when troubleshooting. Interpret "seoplia" as sepolia. Requires Python's standard library and the adjacent investigate-game RPC helper. No transactions are submitted.

Use ETHEREUM_PROVIDER for mainnet and ETHEREUM_SEPOLIA_PROVIDER for sepolia. The script checks chain ID, initial game type 1006, and registration in the discovered ASR's factory. Supply --expected-factory <address> when a trusted deployment factory is available from user context. Otherwise retain the returned provenance warning; self-reported registry/factory wiring is not canonical deployment authentication. Never expose provider URLs or credentials.

The starting game is included: return it if it qualifies, otherwise follow parentRef() until the first game with status() == DEFENDER_WINS and ASR.isGameClaimValid(game) == true. This includes registration, blacklist, retirement, pause, respected-type and finality-delay checks. A qualifying legacy game may also be returned. Stop at the ASR sentinel; it is not a recovery parent. Cycles, unavailable getters, malformed RPC data, and exceeding 200 parent hops fail explicitly. All reads use one latest canonical block hash so a recent blacklist is not intentionally hidden behind a finalized snapshot. One reorg restart is allowed; RPC requests time out after 20 seconds.

On success, report the full recovery_parent address first, then --recovery-parent <address>, network, L2 block number, parent-hop count, snapshot, and any warning. Explain briefly that the script checks onchain claim validity; the services additionally verify the canonical L2 root. Replacing an occupied factory UUID still requires a new proof domain or an onchain retry mechanism.

Exit 1 means an incomplete/failed lookup, not proof that no valid ancestor exists. Exit 2 means the traversal reached the ASR sentinel without a qualifying game. In either case, do not recommend a parent address from partial results.

© 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

SKILL.md and 1 other file (scripts) in .agents/skills/recovery-parent of worldcoin/world-chain.

  • SKILL.md
  • scripts/find_parent.py

Open the folder on GitHubat commit 0733816

Compare with similar skills

Recovery Parent 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.

Recovery Parent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Recovery Parent this skillworldcoin/world-chain116—~570Automated safety check: PassMIT
TriageTalAter/annyang6.8k—~810Automated safety check: NotesMIT
Yichen Asrmcncarl/yichen-skills4.4k—~780Automated safety check: PassCustom licence
Dingtalk MinutesDingTalk-Real-AI/dingtalk-workspace-cli3.2k—~2.3kAutomated safety check: PassApache-2.0
Youtube FetcherJimmySadek/youtube-fetcher-to-markdown485—~3.1kAutomated safety check: PassMIT
Yichen Web Researchmcncarl/yichen-skills4.4k—~1.9kAutomated safety check: PassCustom licence

Similar skills

  • Triage

    TalAter/annyang

    Triage and close GitHub issues on TalAter/annyang. An agent skill from TalAter/annyang.

    6.8k GitHub stars~810 tokensUpdated 4 days ago
    AI & LLM EngineeringAuto-check: notes
  • Yichen Asr

    mcncarl/yichen-skills

    逸尘自用的统一音视频转写入口,在 StepFun Step ASR 与火山引擎豆包 ASR 之间按输出需求、安全边界和可用状态路由。用于本地音频或视频的纯文本转写、时间戳、SRT 字幕、口播粗剪,以及转写前体检;用户明确指定服务商时不得静默切换。Use when a local audio or video file needs transcription and the correct…

    4.4k GitHub stars~780 tokensUpdated 7 days ago
    AI & LLM EngineeringAuto-check passed
  • Dingtalk Minutes

    DingTalk-Real-AI/dingtalk-workspace-cli

    钉钉 AI 听记。Use when 查询或修改听记摘要、完整逐字稿、关键词、标签、行动项、录音、上传、思维导图、发言人洞察、ASR 热词/识别词配置或分享权限。写文档走 dingtalk-doc;建待办走 dingtalk-todo;日程走 dingtalk-calendar。命令前缀:dws minutes。

    3.2k GitHub stars~2.3k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Youtube Fetcher

    JimmySadek/youtube-fetcher-to-markdown

    Retrieve transcripts from YouTube, Instagram, TikTok, X, Vimeo and other video sites, summarize or analyze what was said (and shown on screen), or save an Obsidian-ready Markdown knowledge-base note…

    485 GitHub stars~3.1k tokensUpdated 4 days ago
    AI & LLM EngineeringAuto-check passed
  • Yichen Web Research

    mcncarl/yichen-skills

    逸尘自用的互联网研究总入口。用于跨平台且跨阶段、用户尚未确定工具,或明确要求对公司、产品、人物、技术、行业和领域做横纵分析、发展史加现状对比或有来源约束的系统深度研究;先生成有截止日期和证据闸门的计划,再把搜索发现、候选核验、有限归档、按需转写和证据综合路由到…

    4.4k GitHub stars~1.9k tokensUpdated 7 days ago
    AI & LLM EngineeringAuto-check passed
  • Volcengine Asr

    ysyecust/lecture-to-notes

    Transcribe local audio or video with Volcengine Doubao file ASR, including BigASR 1.0 Turbo direct upload and asynchronous 1.0 standard, 1.0 idle, or 2.0 standard jobs through TOS.

    273 GitHub stars~783 tokensUpdated 8 days ago
    AI & LLM EngineeringAuto-check passed

More from worldcoin/world-chain

  • Debug Node Tracing

    worldcoin/world-chain

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

    116 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • 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
  • 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 2 days ago
    Auto-check passed

Questions about Recovery Parent

What does Recovery Parent do?

Find the nearest defender-winning, ASR claim-valid game backward in a WIP-1006 lineage for the proposer and defender recovery-parent flag. Recovery Parent is an agent skill from 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.

When should I use Recovery Parent?

Recovery Parent fits situations like: tasks that involve Speech recognition and synthesis.

How do I install Recovery Parent in Claude Code?

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

How do I install Recovery Parent in Codex?

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

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

What does Recovery Parent need to run?

Going by SKILL.md and its folder, Recovery Parent needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Recovery Parent 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 Recovery Parent 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Recovery Parent use?

Recovery Parent 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 Recovery Parent use?

About 570 tokens (SKILL.md is roughly 2.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 Recovery Parent?

Skills that share tags, products or a category with Recovery Parent: Triage (TalAter/annyang, 6.8k stars), Yichen Asr (mcncarl/yichen-skills, 4.4k stars), Dingtalk Minutes (DingTalk-Real-AI/dingtalk-workspace-cli, 3.2k stars) and Youtube Fetcher (JimmySadek/youtube-fetcher-to-markdown, 485 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Recovery Parent?

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 11, 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.