Skip to content

magallon/website-audit-toolkit

Repository files navigation

Website Audit Toolkit

Pre-production audit protocol for static websites hosted on cPanel. Ten sequential skills that cover every dimension of a production-ready site — from technical performance to visual design craft.

Built for vanilla HTML/CSS/JavaScript projects. Stack-agnostic within that scope — no framework dependencies.

Skills

Order Skill What it audits
1 audit-performance Core Web Vitals, image strategy, loading optimization, cPanel server config, animation runtime, WebGL/Canvas, inline SVG
2 audit-code-consistency CSS architecture, JavaScript quality, HTML consistency, cross-file coherence, DRY/KISS/YAGNI compliance
3 audit-accessibility WCAG 2.1 Level AA — Perceivable, Operable, Understandable, Robust
4 audit-responsive Mobile-first implementation, fluid typography, touch targets, viewport units, navigation adaptation
5 audit-cross-browser CSS/JS compatibility, vendor prefixes, Safari-specific issues, progressive enhancement
6 audit-conversion-ux B2B conversion flow, JTBD framework, CTA strategy, interactive demo states, form UX
7 audit-seo Crawlability, on-page optimization, structured data (JSON-LD), Open Graph, E-E-A-T signals
8 audit-security Security headers, file protection, information exposure, XSS prevention, CORS, webhook security
9 audit-copywriting Page structure, 7-sweep text quality review, narrative architecture, headline formulas, placeholder detection
10 audit-design-review Design system integrity, diagnostic tests (swap/squint/signature/token), component states, visual craft

Execution Order

The order is not arbitrary. Each audit assumes the previous layer is resolved — skipping steps or changing the sequence compromises later reviews.

1. Performance        → Technical foundation must be solid first
2. Code Consistency   → Clean code before reviewing behavior
3. Accessibility      → Requires stable HTML/CSS structure
4. Responsive         → Requires accessible structure resolved
5. Cross-Browser      → Requires responsive layout resolved
6. Conversion UX      → Requires all visual/functional layers stable
7. SEO                → Requires final content and structure
8. Security           → Requires clean code and defined endpoints
9. Copywriting        → Requires page structure and UX defined
10. Design Review     → Final gate — verifies coherence of everything above

Installation

Using the Skills CLI (recommended)

# Interactive install — choose which skills and agent
npx skills add magallon/website-audit-toolkit

# Install all skills to a specific agent
npx skills add magallon/website-audit-toolkit --all -a claude

# Install a single skill
npx skills add magallon/website-audit-toolkit --skill audit-performance

Manual installation

git clone https://github.com/magallon/website-audit-toolkit.git

# Copy individual skills to your agent's skills directory
cp -r website-audit-toolkit/audit-performance /path/to/your/skills/
cp -r website-audit-toolkit/audit-seo /path/to/your/skills/
# ... repeat for each skill you need

Usage

Run the full protocol

"Run the complete pre-production audit protocol on this project"

The agent will execute all 10 audits in order, generating a consolidated report.

Run a single audit

"Run the performance audit on this project"

"Audit accessibility on this site"

"Check cross-browser compatibility"

Run a subset

"Run audits 1 through 5 — technical foundation only"

"Run the content audits — SEO, copywriting, and design review"

Scope and Limitations

Designed for:

  • Static marketing sites and landing pages
  • Vanilla HTML/CSS/JavaScript (no frameworks)
  • cPanel shared hosting with .htaccess configuration
  • B2B commercial sites with webhook integrations

Not designed for:

  • Single-page applications (React, Vue, Angular)
  • Server-side rendered frameworks (Next.js, Nuxt)
  • E-commerce platforms
  • Content management systems (WordPress, etc.)

Each skill audits by reading code directly — no external tools required during the audit. Some skills reference external validation tools (PageSpeed Insights, Rich Results Test, securityheaders.com) for post-audit verification.

Project Structure

website-audit-toolkit/
├── README.md
├── LICENSE
├── CHANGELOG.md
├── CONTRIBUTING.md
│
├── audit-performance/
│   ├── SKILL.md
│   └── references/
│       ├── image-strategy.md
│       ├── animation-webgl-svg.md
│       └── checklist.md
│
├── audit-code-consistency/
│   ├── SKILL.md
│   └── references/
│       ├── javascript-patterns.md
│       └── checklist.md
│
├── audit-accessibility/
│   ├── SKILL.md
│   └── references/
│       ├── interactive-patterns.md
│       └── checklist.md
│
├── audit-responsive/
│   ├── SKILL.md
│   └── references/
│       ├── responsive-patterns.md
│       └── checklist.md
│
├── audit-cross-browser/
│   ├── SKILL.md
│   └── references/
│       ├── browser-differences.md
│       └── checklist.md
│
├── audit-conversion-ux/
│   ├── SKILL.md
│   └── references/
│       ├── conversion-patterns.md
│       └── checklist.md
│
├── audit-seo/
│   ├── SKILL.md
│   └── references/
│       ├── seo-templates.md
│       └── checklist.md
│
├── audit-security/
│   ├── SKILL.md
│   └── references/
│       └── checklist.md
│
├── audit-copywriting/
│   ├── SKILL.md
│   └── references/
│       ├── copywriting-patterns.md
│       ├── narrative-architecture.md
│       └── checklist.md
│
└── audit-design-review/
    ├── SKILL.md
    └── references/
        ├── design-system-docs.md
        └── checklist.md

Severity Levels

All skills use the same four-level severity scale:

Level Action
Critical Fix before any other work
High Fix before launch
Medium Fix within first week
Low Fix when convenient

Contributing

See CONTRIBUTING.md for guidelines on submitting improvements or new audit skills.

License

MIT — see LICENSE for details.

About

Pre-production audit protocol for static websites — 10 sequential skills covering performance, accessibility, SEO, security, and more

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors