wordpress-workspace-preview-routing-debug

Debug WordPress Workspace Agent preview, edit-mode, authentication, proxy, and URL-routing behavior across simple WordPress.com, Jetpack, and Atomic sites. Use when preview panels load blank pages, show the wrong URL, leak effective preview URLs, fail authentication, or behave differently by site type.

Jump to install

Repository: Automattic/workspace
Last source activity: May 22, 2026 at 08:56
Detected SKILL.md language: English
Stars: 5
Forks: 2

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/Automattic/workspace --skill wordpress-workspace-preview-routing-debug

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

2 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

wordpress-workspace-agent-ux-consistency-check

Review WordPress Workspace Agent, site picker, conversation history, Quick Ask, QuickLauncher, settings, and sidebar UX for consistency with the repo's plain, explicit, site-scoped interaction patterns. Use when changing Agent UI, site switching, starred/all-sites behavior, conversation pagination, or settings copy.

2026-05-22

wordpress-workspace-doc-consistency-check

Review WordPress Workspace README, PRD, release notes, public copy, and product documentation for consistency with this repo and the current WordPress Workspace positioning. Use when editing docs, checking copy drift, or reviewing product claims for this macOS app.

2026-05-22

wordpress-workspace-release-runbook

Guide WordPress Workspace build, packaging, signing, notarization, OAuth secret injection, release checks, and release documentation for this repo. Use when the user asks to build, package, sign, notarize, publish, smoke test, or explain release operations.

2026-05-22

View all from this repository

WordPress Workspace Preview Routing Debug

Use this skill for preview/auth/editor-mode problems in the WordPress Agent window or detached preview.

Workflow

Ground the report in the current code path.

Inspect Sources/WordPressAgentPreviewURLResolver.swift, Sources/WordPressAgentWindowView.swift, Sources/WPCOMClient.swift, and relevant Sources/AppState.swift preview methods.
Search with rg -n "preview|frame_nonce|jetpack_frame_nonce|unmapped|Atomic|cookie|requested|effective|private|proxy" Sources.

Preserve the preview trust rules.

Show the requested user-facing URL in UI.
Do not expose effective preview URLs, frame nonces, auth bootstrap URLs, or private preview details.
Reject localhost and private-network URLs.

Check site type and mode.

Simple WordPress.com, Jetpack, and Atomic sites can require different preview URL, unmapped-host, nonce, cookie, or read-access handling.
Distinguish signed-out view, authenticated preview, and editor mode.

Check proxy and routing overrides.

Inspect Sources/NetworkRoutingSettings.swift and the WordPress.com auth-cookie bootstrap in Sources/WPCOMClient.swift.
The app has a developer setting to bypass the macOS system proxy for sandbox routing, but the preview cookie-bootstrap flow intentionally uses a one-off direct session because proxy routing has produced wp-login.php 200 responses with empty auth cookies.
Keep normal API traffic aligned with the user's network setting unless the code path is specifically browser-cookie infrastructure.

Reproduce with focused signals.

Prefer app logs, existing preview loading states, and targeted code inspection before inventing shell-only repros.
Verify loading/preparation states, navigation updates, requested-vs-effective URL display, and mode switch behavior.

Keep comments where behavior is non-obvious.

Proxy bypass, cookie bootstrap, nonce handling, and URL rewriting deserve concise code comments when changed.

Output

Lead with the failing route or trust boundary.

Include file references and the specific site/mode assumptions.

Recommend tests for public URL, same-site URL, preview URL, editor URL, internal navigation, and rejected private URL.

WordPress Workspace Preview Routing Debug

Use this skill for preview/auth/editor-mode problems in the WordPress Agent window or detached preview.

Workflow

Ground the report in the current code path.

Inspect Sources/WordPressAgentPreviewURLResolver.swift, Sources/WordPressAgentWindowView.swift, Sources/WPCOMClient.swift, and relevant Sources/AppState.swift preview methods.
Search with rg -n "preview|frame_nonce|jetpack_frame_nonce|unmapped|Atomic|cookie|requested|effective|private|proxy" Sources.

Preserve the preview trust rules.

Show the requested user-facing URL in UI.
Do not expose effective preview URLs, frame nonces, auth bootstrap URLs, or private preview details.
Reject localhost and private-network URLs.

Check site type and mode.

Simple WordPress.com, Jetpack, and Atomic sites can require different preview URL, unmapped-host, nonce, cookie, or read-access handling.
Distinguish signed-out view, authenticated preview, and editor mode.

Check proxy and routing overrides.

Inspect Sources/NetworkRoutingSettings.swift and the WordPress.com auth-cookie bootstrap in Sources/WPCOMClient.swift.
The app has a developer setting to bypass the macOS system proxy for sandbox routing, but the preview cookie-bootstrap flow intentionally uses a one-off direct session because proxy routing has produced wp-login.php 200 responses with empty auth cookies.
Keep normal API traffic aligned with the user's network setting unless the code path is specifically browser-cookie infrastructure.

Reproduce with focused signals.

Prefer app logs, existing preview loading states, and targeted code inspection before inventing shell-only repros.
Verify loading/preparation states, navigation updates, requested-vs-effective URL display, and mode switch behavior.

Keep comments where behavior is non-obvious.

Proxy bypass, cookie bootstrap, nonce handling, and URL rewriting deserve concise code comments when changed.

Output

Lead with the failing route or trust boundary.

Include file references and the specific site/mode assumptions.

Recommend tests for public URL, same-site URL, preview URL, editor URL, internal navigation, and rejected private URL.

name	wordpress-workspace-preview-routing-debug
description	Debug WordPress Workspace Agent preview, edit-mode, authentication, proxy, and URL-routing behavior across simple WordPress.com, Jetpack, and Atomic sites. Use when preview panels load blank pages, show the wrong URL, leak effective preview URLs, fail authentication, or behave differently by site type.

wordpress-workspace-preview-routing-debug

Source facts

Install options

Review the source files

More from this repository