design-audit

Audits published article pages visually using Cloudflare Browser Rendering screenshots and Llava vision analysis.

Updated Jul 21, 2026
One-click install
npx skills add https://github.com/techfundoffice/cats-seo-aiagent-staging --skill design-audit-techfundoffice
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-audit
Source: https://github.com/techfundoffice/cats-seo-aiagent-staging/tree/main/.claude/skills/design-audit
Command: npx skills add https://github.com/techfundoffice/cats-seo-aiagent-staging --skill design-audit-techfundoffice

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Published articles can ship with visual defects—broken CTAs, generic intros, missing hero headlines—that text-only QC never catches. This Skill captures live desktop and mobile screenshots of a published page, runs vision-model analysis on them, and routes only the copy-fixable findings into the rewrite pipeline. ## Core Features & Use Cases - Dual-viewport capture: Takes desktop (1440x900) and mobile (390x844) screenshots via Cloudflare Browser Rendering and archives them to R2 under design-audits/{slug}/. - Vision analysis with classification: Analyzes screenshots with Llava through AI Gateway, dedupes issues, and classifies them as content-addressable (cta, content, hero, nav) versus CSS-only (layout, typography, color, mobile). - Pipeline integration: Runs as Step 11.5 after KV deploy and indexing, feeding content-addressable findings into the QC Review and Polish agents so the article gets rewritten. - Use Case: After publishing an article on catsluvus.com, run the audit to discover the hero headline renders as "Untitled" and the CTA button has no text, then have the Polish agent regenerate that copy automatically. ## Quick Start Run a design audit on https://catsluvus.com/cats/my-article and report the content-addressable visual issues.

Frequently Asked Questions about design-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I visually audit a published web page with a vision model?

Capture desktop and mobile screenshots of the live URL with Cloudflare Browser Rendering, then send each image to a vision model like Llava through AI Gateway. The audit returns a structured report of deduped issues classified by category.

How to take screenshots of a live page from a Cloudflare Worker?

Use the Browser Rendering REST API with an API token that has Browser Rendering: Edit permission. The capturePageScreenshot function posts to the /screenshot endpoint and stores the resulting JPEG in an R2 bucket.

What API token permissions does Cloudflare Browser Rendering need?

The token needs Browser Rendering: Edit for the screenshot endpoint, Workers AI: Run for invoking Llava, and AI Gateway: Run for the gateway route. Missing scopes produce 401 or 403 errors such as code 10000 on /screenshot.

Why does the design audit skip or return no issues?

The audit skips when Browser Rendering bindings or CLOUDFLARE_ACCOUNT_ID are unset, returning a skipped report with a skipReason. Silent vision parse failures can be debugged via the rawVisionResponses field in the /api/verify-design-audit report.

Can I swap Llava for a different vision model on Workers AI?

Yes, change the VISION_MODEL constant in the vision-audit tool to another Workers AI vision model such as Llama 3.2 Vision when available. The rest of the capture, classification, and pipeline flow stays unchanged.