Agent skill

Webspatial Avp Iwdp

by webspatial in webspatial/webspatial-sdk

Programmatic WebSpatial debugging on the Apple Vision Pro simulator via ios-webkit-debug-proxy and tools/scripts/iwdp-sim.py.

MITAuto-check passedDevelopment

Install Webspatial Avp Iwdp

skills CLI
$ npx skills add webspatial/webspatial-sdk --skill webspatial-avp-iwdp -a claude-code

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

GitHub CLI
$ gh skill install webspatial/webspatial-sdk webspatial-avp-iwdp --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/webspatial/webspatial-sdk.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/webspatial-avp-iwdp .claude/skills/webspatial-avp-iwdp && 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
webspatial-avp-iwdp
GitHub stars
152
Token cost
~739 tokens
SKILL.md length
160 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Programmatic WebSpatial debugging on the Apple Vision Pro simulator via ios-webkit-debug-proxy and tools/scripts/iwdp-sim.py.

  • Works in 4 steps: Run list — titles wrong → fix data-name… → iwdp won't start → boot simulator; set… → Click ineffective → --wait-ms 2000; use… → …
  • Automating AVP simulator tests
  • SKILL.md covers Read first, Core model (must internalize), Standard agent workflow and Other WebSpatial apps, plus 2 more sections
  • Calls python3 and npm

What it does

Webspatial Avp Iwdp is an agent skill from webspatial/webspatial-sdk. Programmatic WebSpatial debugging on the Apple Vision Pro simulator via ios-webkit-debug-proxy and tools/scripts/iwdp-sim.py. Use when automating AVP simulator tests, driving SpatialDiv WKWebViews without Safari clicks, reading DOM/CSS from portal webviews, or debugging any WebSpatial app (not only test-server). Triggers on iwdp, ios-webkit-debug-proxy, visionOS simulator automation, data-name inspector targets, SpatialDiv webview eval, or AVP screenshot gates.

Its SKILL.md is about 740 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. It works with iOS. The repository describes itself as: Unlock native-level spatial power with the WebSpatial SDK without losing the power of the web. The licence is MIT.

When your agent uses it

  • Automating AVP simulator tests
  • Driving SpatialDiv WKWebViews without Safari clicks
  • Reading DOM/CSS from portal webviews
  • Debugging any WebSpatial app (not only test-server)

Example prompts

  • “/webspatial-avp-iwdp”

Requirements

  • Python 3

Workflow steps

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

  1. Run list — titles wrong → fix data-name or wait.
  2. iwdp won't start → boot simulator; set IWDP_SIM_SOCKET (see IWDP-SIM.md).
  3. Click ineffective → --wait-ms 2000; use Pointer-friendly click subcommand.
  4. Wrong webview → match title from list, not guessed WebSpatial.

What it can do on your machine

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

    • python3
    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use npm, 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 no API keys, tokens, secrets or passwords.

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

Context cost

Webspatial Avp Iwdp loads about 739 tokens when it runs. Until then it costs about 121 tokens; SKILL.md has 160 words of instructions outside code blocks.

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

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 webspatial/webspatial-sdk at commit 82a765c, republished under its MIT licence (© webspatial). 160 words, ~739 tokens.

Download SKILL.mdSave it as .claude/skills/webspatial-avp-iwdp/SKILL.md (or your agent's skills folder).
name
webspatial-avp-iwdp
description
Programmatic WebSpatial debugging on the Apple Vision Pro simulator via ios-webkit-debug-proxy and tools/scripts/iwdp-sim.py. Use when automating AVP simulator tests, driving SpatialDiv WKWebViews without Safari clicks, reading DOM/CSS from portal webviews, or debugging any WebSpatial app (not only test-server). Triggers on iwdp, ios-webkit-debug-proxy, visionOS simulator automation, data-name inspector targets, SpatialDiv webview eval, or AVP screenshot gates.

WebSpatial AVP — iwdp automation

Read first

Full guide: tools/scripts/IWDP-SIM.md

Script: python3 tools/scripts/iwdp-sim.py

Core model (must internalize)

  • Each enable-xr SpatialDiv = separate WKWebView in Safari Develop / iwdp.
  • data-name → inspector title (use unique stable names).
  • WebSpatial title = host app webview (often sidebar shell); portal DOM lives in SpatialDiv titles.
  • No simctl tap on visionOS; no iwdp console.log — use dom / probe / page-log mirrors.

Standard agent workflow

bash
# 1. Dev server running (adjust origin for other apps)
npm run dev

# 2. Launch app + route + wait for SpatialDiv
python3 tools/scripts/iwdp-sim.py launch --terminate --route <route> \
  --wait-title "<SpatialDiv data-name>"

# 3. Discover targets
python3 tools/scripts/iwdp-sim.py list

# 4. Drive UI in the correct webview (SpatialDiv title, not WebSpatial)
python3 tools/scripts/iwdp-sim.py click "<data-name>" "<css-selector>" --wait-ms 2000

# 5. Read DOM / CSS / probes
python3 tools/scripts/iwdp-sim.py dom "<data-name>" "<selector>" --rect --text
python3 tools/scripts/iwdp-sim.py css "<data-name>" "<selector>"
python3 tools/scripts/iwdp-sim.py probe "<data-name>" webspatialOverlayPush

# 6. Visual check
python3 tools/scripts/iwdp-sim.py screenshot /tmp/avp.png

Multi-step shells: export IWDP_KEEP_ALIVE=1

Other WebSpatial apps

bash
export WEBSPATIAL_BUNDLE_ID=com.your.app
export WEBSPATIAL_DEV_ORIGIN=http://localhost:3000
python3 tools/scripts/iwdp-sim.py launch --route your-hash-route --wait-title "Your Panel"

App code: add data-name on every SpatialDiv you need to automate.

Assertions — prefer these over console

NeedCommand
Element existsdom … "[selector]"
Layoutdom … --rect
Stylescss …
Dev probeprobe … <datasetKey>
Visualscreenshot + image review
Arbitraryeval …

Do not expect Console.messageAdded over iwdp on WebKit.

When stuck

  1. Run list — titles wrong → fix data-name or wait.
  2. iwdp won't start → boot simulator; set IWDP_SIM_SOCKET (see IWDP-SIM.md).
  3. Click ineffective → --wait-ms 2000; use Pointer-friendly click subcommand.
  4. Wrong webview → match title from list, not guessed WebSpatial.

Manual Safari path (human): skill webspatial-visionos-debugging.

© webspatial, 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 .codex/skills/webspatial-avp-iwdp of webspatial/webspatial-sdk.

Open the folder on GitHubat commit 82a765c

Compare with similar skills

Webspatial Avp Iwdp 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.

Webspatial Avp Iwdp compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Webspatial Avp Iwdp this skillwebspatial/webspatial-sdk152—~739Automated safety check: PassMIT
CanvasBitterbot-AI/bitterbot-desktop2.5k—~1.4kAutomated safety check: PassMIT
Dogfoodcallstackincubator/agent-skills1.7k1 repos~1.7kAutomated safety check: PassMIT
Grix Code Reviewaskie/grix153—~799Automated safety check: PassCustom licence
iOS Crash Log Debuggingconorluddy/xclaude-plugin183—~4.9kAutomated safety check: PassMIT
iOS FixMacMagazine/app-iOS170—~957Automated safety check: PassNone

Similar skills

  • Canvas

    Bitterbot-AI/bitterbot-desktop

    Display and control HTML content on connected Bitterbot nodes (Mac, iOS, Android) via the canvas host server.

    2.5k GitHub stars~1.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Dogfood

    callstackincubator/agent-skills

    Official

    Systematically explore and test a mobile app on iOS/Android with agent-device to find bugs, UX issues, and other problems.

    1.7k GitHub starsUsed in 1 repo~1.7k tokens
    DevelopmentAuto-check passed
  • Audit Grix diffs and pull requests for correctness, regressions, security, lifecycle safety, and cross-component contract consistency.

    153 GitHub stars~799 tokensUpdated today
    DevelopmentAuto-check passed
  • iOS Crash Log Debugging

    conorluddy/xclaude-plugin

    Walks through retrieving, symbolicating and diagnosing iOS crash logs, turning a cryptic stack trace into the function names that actually failed.

    183 GitHub stars~4.9k tokensUpdated 29 days ago
    DevelopmentAuto-check passed
  • iOS Fix

    MacMagazine/app-iOS

    Bug-fix and refactoring workflow for MacMagazine — root cause analysis, pattern-matching fix, regression verification.

    170 GitHub stars~957 tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • AppsFlyer Unity Bridge Debugging

    AppsFlyerSDK/appsflyer-unity-plugin

    Traces a failing call or callback between C# and the native Android or iOS wrappers of the AppsFlyer Unity plugin to find the first broken link.

    178 GitHub stars~492 tokensUpdated 7 days ago
    DevelopmentAuto-check passed

More from webspatial/webspatial-sdk

  • Webspatial Release

    webspatial/webspatial-sdk

    WebSpatial SDK 仓库的版本发布与 Changesets 使用规范. An agent skill from webspatial/webspatial-sdk.

    152 GitHub stars~836 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Webspatial Avp Iwdp

What does Webspatial Avp Iwdp do?

Programmatic WebSpatial debugging on the Apple Vision Pro simulator via ios-webkit-debug-proxy and tools/scripts/iwdp-sim.py. Webspatial Avp Iwdp is an agent skill from webspatial/webspatial-sdk.py.

When should I use Webspatial Avp Iwdp?

Webspatial Avp Iwdp fits situations like: automating AVP simulator tests; driving SpatialDiv WKWebViews without Safari clicks; reading DOM/CSS from portal webviews; debugging any WebSpatial app (not only test-server).

How do I install Webspatial Avp Iwdp in Claude Code?

Run `npx skills add webspatial/webspatial-sdk --skill webspatial-avp-iwdp -a claude-code`. Or copy the skill folder (.codex/skills/webspatial-avp-iwdp in webspatial/webspatial-sdk) into .claude/skills/webspatial-avp-iwdp in your project. Claude Code loads it when a task matches its description.

How do I install Webspatial Avp Iwdp in Codex?

Run `npx skills add webspatial/webspatial-sdk --skill webspatial-avp-iwdp -a codex`. Or copy the skill folder (.codex/skills/webspatial-avp-iwdp in webspatial/webspatial-sdk) into .agents/skills/webspatial-avp-iwdp in your project. Codex loads it when a task matches its description.

Can I use Webspatial Avp Iwdp 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 webspatial/webspatial-sdk --skill webspatial-avp-iwdp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/webspatial-avp-iwdp, .gemini/skills/webspatial-avp-iwdp, .github/skills/webspatial-avp-iwdp and .opencode/skills/webspatial-avp-iwdp in your project.

What does Webspatial Avp Iwdp need to run?

Going by SKILL.md and its folder, Webspatial Avp Iwdp needs the command-line tools its instructions call (python3 and npm). Our summary lists: Python 3.

Does Webspatial Avp Iwdp access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Webspatial Avp Iwdp 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 Webspatial Avp Iwdp use?

Webspatial Avp Iwdp 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 Webspatial Avp Iwdp use?

About 739 tokens (SKILL.md is roughly 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 Webspatial Avp Iwdp?

Skills that share tags, products or a category with Webspatial Avp Iwdp: Canvas (Bitterbot-AI/bitterbot-desktop, 2.5k stars), Dogfood (callstackincubator/agent-skills, 1.7k stars), Grix Code Review (askie/grix, 153 stars) and iOS Crash Log Debugging (conorluddy/xclaude-plugin, 183 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Webspatial Avp Iwdp?

webspatial (a GitHub organization) maintains it in webspatial/webspatial-sdk, which has 152 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 10, 2026.

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