Periscope — E2E & QA Testing for Web Apps/SPAs

Periscope gives an AI agent the browser's reality, not the server's HTML: JavaScript executed, styles computed, network captured, real input latency measured. This skill is the distilled operating guide for its 74 MCP tools — so the agent drives them expertly instead of discovering the conventions by trial and error.

WHAT THE AGENT LEARNS • A task→workflow decision table: audit one page or a whole site (test_project = crawl + 6 audits per page in one call), drive interactive sessions, test behind logins (form/basic/cookies + interactive 2FA/SSO login), debug broken pages via console/network/response bodies, mock APIs to reproduce error states, visual-regression baselines, responsive checks, real INP measurement, capture whole sites as Markdown. • Token economy: the observe parameter (skip screenshots through setup steps), semantic page maps instead of images, conditional web_fetch. • The pitfall list that saves turns: substring-not-regex URL patterns, dialog handler ordering, silently failing drag-and-drop, portal-overlay click fallbacks, auth-loss semantics, never-idle page handling. • Bug reporting: agents file evidence-grade issues for tool bugs they hit — most of Periscope's fixes started that way.

PREREQUISITES The Periscope MCP server connected to your client (Claude Code or any MCP client). Install: git clone https://github.com/segentic-lab/periscope-mcp && cd periscope-mcp && ./install.sh — then register the generated mcp-config.json. The skill auto-triggers on web-testing tasks ("test my site", "check accessibility", "why is this form returning 400"...).

EXAMPLES "Test https://example.com for accessibility and SEO issues" → project audit with JSON report. "Log into my staging app and test the checkout flow" → authenticated session, page map, assertions, HTML+PDF session report. "Why does my form return 400?" → network log + actual response body diagnosis.

The skill defers depth to the running server (describe_tools, periscope_system) so it never goes stale as Periscope evolves.