Skip to content

FAT Agent with Superpowers

Fix, Audit, Test -- the modular post-launch QA audit skill for Claude Code.

FAT Agent with Superpowers systematically audits deployed websites across SEO, security, accessibility, performance, and 12 additional specialist modules -- then walks you through fixing every issue found.

How It Works

After you deploy a site, say "run FAT agent" and it will:

  1. Gather context -- asks about your site, stack, and critical user flows
  2. Auto-detect modules -- analyses your HTML for e-commerce, local business, i18n, and email signals
  3. Audit -- runs core + detected modules against your live URL
  4. Report -- generates a prioritised punch list, HTML dashboard, Word and PowerPoint reports
  5. Fix -- offers to generate code fixes for every issue found
  6. Re-test -- after you redeploy, verifies the fixes are live

Modules at a Glance

FAT Agent ships with 16 audit modules organised into two tiers.

Core Modules (always enabled)

Module What It Checks
SEO Title, meta, headings, OG tags, structured data, sitemap, robots.txt, Core Web Vitals
Security HSTS, CSP, X-Frame-Options, Referrer-Policy, mixed content, Permissions-Policy
Accessibility Alt text, labels, landmarks, ARIA, skip links, focus management, motion, zoom
Performance HTML size, render-blocking scripts, lazy loading, resource hints, font loading

Conditional Modules (auto-detected or user-selected)

Module Trigger Signal What It Checks
Local SEO LocalBusiness schema, Google Maps, tel: links NAP, GBP, service area, trust signals, CTAs
E-commerce Product schema, cart elements Product schema validation, payment badges, breadcrumbs
Email Deliverability Contact forms with email inputs SPF, DKIM, DMARC records
Internationalisation hreflang tags, language switcher Hreflang validation, x-default, RTL support, lang attribute
Link Checker Always available Internal/external links, broken anchors, noopener, mailto validation
DNS & Infrastructure Opt-in DNSSEC, CAA, SSL expiry, CDN detection, HTTP/2
JS Bundle Analysis Script tags detected Heavy libraries, async/defer, module scripts, bundle patterns
Content Quality Included in full profile Word count, readability, keyword overlap, placeholder text
Cookie & GDPR Included in security profile Consent platforms, privacy policy, cookie policy, tracking consent
PWA Readiness Included in full profile Web app manifest, service worker, theme colour, viewport
Schema Validation Included in SEO/full profiles JSON-LD syntax, @context, @type, required properties
Sitemap Analysis Included in SEO/full profiles XML sitemap structure, URL coverage, lastmod dates, robots.txt references

Quick Install

claude plugins add https://github.com/wrxck/fat-agent-with-superpowers

git clone https://github.com/wrxck/fat-agent-with-superpowers ~/.claude/skills/fat-agent

Then in any conversation:

You: Run FAT agent on https://mysite.com
You: /fat-audit https://example.com
You: Audit my site with the local business profile

See the Installation guide for full setup instructions.

Scoring

Category Weight
SEO 30%
Security 25%
Accessibility 30%
Performance 15%

Module scores (Local SEO, E-commerce, etc.) are reported separately as supplementary scores.

Grades: A >= 90, B >= 80, C >= 70, D >= 60, F < 60.

Key Features

  • 8 audit profiles -- quick, full, local, ecommerce, seo, security, accessibility, content
  • Multi-page BFS crawler with robots.txt support
  • Bulk site auditing from JSON site lists
  • Self-contained HTML dashboard with colour-coded grades
  • Lighthouse CLI integration for accurate Core Web Vitals
  • Visual regression screenshot comparison across viewports
  • CI/CD quality gate with configurable thresholds
  • Client-facing mode transforms jargon into plain English
  • Competitive analysis side-by-side score comparisons
  • 320+ tests across 17 test files

Project

Built by Spruik Co -- Digital Marketing & SEO Consultancy.

Maintained by wrxck. Licensed under MIT.