responsive-audit

Configuration (fill in before first run)

Replace these placeholders:

• [DEV_URL] - e.g. http://localhost:3000
• [LOGIN_ROUTE] - your login page path, e.g. login, signin, auth/login
• [SITEMAP_OR_ROUTE_LIST] - e.g. docs/sitemap.md or docs/routes.md
• [MOBILE_ROUTES] - comma-separated routes to test in quick mode (pick 4–6 most-used)
• [TEST_ACCOUNTS] - one or more email / password pairs per role (from your project's test accounts)
• [DEV_COMMAND] - e.g. npm run dev, pnpm dev
• [APP_SOURCE_GLOB] - e.g. src/**/*.{tsx,jsx}, app/**/*.{vue,svelte}, templates/**/*.html
• [SCOPE_NOTE] - which roles/pages are in scope vs excluded

If [DEV_URL] or [SITEMAP_OR_ROUTE_LIST] is not filled, the skill reports an error and exits.

Step 0 - Mode + target detection

Parse $ARGUMENTS:

Mode (controls breakpoints, route breadth, and WCAG checks):

• quick (or empty) → BP1 (375px) only, key routes per role. No WCAG checks.
• full → all breakpoints (375px + 768px + 1024px), all R-flagged routes. No WCAG checks.
• wcag → adds BP0 (320px) to the active breakpoint set + WCAG 1.4.4 resize text step (Step 5b). Stackable: full wcag = all breakpoints + WCAG compliance checks.

Target (filters the route list - applied on top of mode):

• target:role:<role_name> → routes accessible by that role only
• target:section:<name> → routes whose path contains <name>
• No target → NO filter - ALL R-flagged routes from [SITEMAP_OR_ROUTE_LIST] per the selected mode

STRICT PARSING - mandatory: derive mode and target ONLY from the explicit text in $ARGUMENTS. Do NOT infer target from conversation context, recent work, active block names, or project memory. If $ARGUMENTS contains no target: token → apply NO filter (all R-flagged routes per the selected mode).

Target scoping - comparative vs independent checks (mandatory): some audit skills contain comparative checks that derive a project-wide convention by counting usage across the whole inventory - those must ignore the target: filter. This skill has none: every check tests a route, breakpoint, or file against an absolute threshold (WCAG 1.4.10 reflow at 320px, 44px tap targets, 8px spacing, WCAG 1.4.4 at 200%).

• Comparative checks - full-project by design; the target: filter does NOT apply to them: none. No check derives its baseline by counting across the route inventory.
• Independent checks - target-safe: all checks (S1-S3 static pre-checks, R1-R9 breakpoint checks, VR1-VR6 visual checks, Step 5b WCAG 1.4.4) evaluate one route/file in isolation and safely honor the target: filter.
• When a target: is given: apply the filter to the working route list (Step 1) and to the static pre-check file scope; no check runs outside the target scope, and the report states the audited scope explicitly.