Terminal
Terminal/Skill
Captures the rendered element hierarchy of a web page with positions, backgrounds and overlays, for layout and structure analysis.
By Adobe
Works with
npx skills add adobe/skills --skill page-treeCapture a spatial hierarchy of rendered DOM elements from any webpage via
playwright-cli. Returns three outputs for downstream consumption.
playwright-cli available (run playwright-cli --help to verify)if [[ -n "${CLAUDE_SKILL_DIR:-}" ]]; then
VT_BUNDLE="${CLAUDE_SKILL_DIR}/scripts/page-tree-bundle.js"
else
VT_BUNDLE="$(find ~/.claude \
-path "*/page-tree/scripts/page-tree-bundle.js" \
-type f 2>/dev/null | head -1)"
fi
Verify the path is non-empty before continuing.
| Parameter | Default | Description |
|---|---|---|
minWidth | 900 | Minimum element width in px. Elements narrower than this are excluded. position: fixed elements always pass regardless. Lower for more detail (e.g., 300 for mobile). |
Run the script location block above and store the path in VT_BUNDLE.
If the path is empty, report an error and stop.
Inject the bundle via initScript in the playwright-cli config, then
capture with a pure expression eval. Do NOT use inline $(cat) or IIFE
wrappers — playwright-cli eval only accepts pure expressions (it wraps
them as () => (EXPR) internally, so function bodies with statements
fail).
URL="<target URL>"
MINWIDTH=900 # or caller-specified value
# Build config with initScript — injects bundle before navigation
VT_CONFIG="/tmp/vt-config-$$.json"
echo "{\"browser\":{\"initScript\":[\"$VT_BUNDLE\"]}}" > "$VT_CONFIG"
# Open page (or use existing session) — bundle creates window.__visualTree
playwright-cli --config="$VT_CONFIG" open "$URL"
sleep 2
# Capture — pure expression, no IIFE
VT_RESULT=$(playwright-cli eval \
"JSON.stringify(window.__visualTree.captureVisualTree($MINWIDTH))")
rm -f "$VT_CONFIG"
Parse the returned JSON string.
Present three sections to the caller:
1. Visual Tree (text format)
The primary output for LLM consumers. Show in a code block:
r @0,0 1440x5667
rc1 [3x1] @0,0 1440x83 "Header text..."
rc2 @0,83 1440x5216
rc2c1 [bg:image] @0,83 1440x410 "Hero text..."
...
Format: ID [role] [CxR] [bg:type] @x,y wxh "text..."
2. Node Map
Positional ID to metadata lookup. Show as JSON. Each entry contains:
selector: CSS selector for the DOM elementbackground (optional): { type, value, raw, source }overlay (optional): { occluding: [sibling IDs this node covers] }Overlay entries indicate the node was promoted from a deeper DOM position to root level because it rendered outside its parent's bounds (e.g., cookie banners, fixed navs, modals).
3. JSON Tree
Full structured tree. Show as JSON only if the caller requests it, otherwise mention it is available. Each node contains: tag, selector, bounds, text, role, layout, background, children.
playwright-cli goto <url> then
wait for network idle) for best results.