site-audit

Audits websites across 20 research angles using parallel agents and produces a synthesis report with quick wins and a 90-day roadmap.

Updated Nov 7, 2023
One-click install
npx skills add https://github.com/lstellway/nixfiles --skill site-audit-lstellway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-audit
Source: https://github.com/lstellway/nixfiles/tree/main/modules/home-manager/claude/skills/site-audit
Command: npx skills add https://github.com/lstellway/nixfiles --skill site-audit-lstellway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lighthouse, @axe-core/cli, pa11y, playwright, linkinator, lychee.

What problem does it solve? New owners of acquired or inherited websites lack a structured way to understand the site's current state, risks, and opportunities. This Skill automates a comprehensive multi-angle audit so nothing important is missed. ## Core Features & Use Cases - Phased parallel research: Runs 20 research agents across four phases covering experience, offer/market, business infrastructure, risk/compliance, content/brand, and technical dimensions. - Automated tooling: Collects Lighthouse, axe, pa11y, screenshots, HTTP headers, sitemaps, whois, and link-integrity data as evidence for the audit agents. - Synthesis deliverable: Produces a synthesis.md with an executive summary, quick wins grid, top 3 risks, and a 90-day roadmap. - Use Case: After acquiring a content website, run the audit to get 20 research artifacts plus a prioritized action plan before making any changes. ## Quick Start Audit the website https://www.example.com and produce a full new-owner assessment with quick wins and a 90-day roadmap.

Frequently Asked Questions about site-audit

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

FAQPage Schema
How do I audit a website I just acquired?

Provide the site URL and any known context such as acquisition price or goals. The skill runs a Phase 0 overview, then fans out parallel research agents across 20 angles, and finishes with a synthesis report containing quick wins, top risks, and a 90-day roadmap.

What tools does a website audit need installed?

The pre-flight check looks for curl, whois, lychee, node, and npx. Node-based tools like Lighthouse, pa11y, axe-core, linkinator, and Playwright are invoked via npx. Missing tools degrade specific angles but the audit can proceed with user confirmation.

What output does the site audit produce?

It writes 20 individual markdown artifacts under research/<site-slug>/artifacts/, phase summary files, tool outputs like lighthouse.json and screenshots, and a final synthesis.md with an executive summary, quick wins grid, top 3 risks, and a 90-day roadmap.

Can the audit handle sites without ecommerce or reviews?

Yes. Phase 0 emits a scope gate JSON that prunes inapplicable angles, such as pricing-value and revenue-model for non-ecommerce sites. The scope gate is a floor, so unexpected findings can add angles back rather than only removing them.

What happens if an audit agent fails or a page is inaccessible?

Failed agents are skipped with a one-line note in the phase summary and surfaced in the final report. Inaccessible surfaces like login walls or bot-blocked pages are flagged as [inaccessible] rather than hallucinated, and listed in the synthesis confidence appendix.