Skill v1.21.0
currentAutomated scan100/1007 files
name: audit description: "Use when the user wants a complete, whole-site audit that combines search visibility, front-end defects, and design quality in one pass. Runs all 13 specialist sub-agents across SEO, accessibility/interaction/layout/code defects, and UX/visual/motion/content design, then merges them into one scored report with a prioritized action plan. Use for: 'audit my whole site', 'complete site audit', 'full website review', 'audit everything', 'is my site good', 'review my site end to end'. For a search-only audit use /seo audit; for defect-only use /inspect; for design-only use /siteasy audit." version: 1.21.0 user-invocable: true argument-hint: "[url] | [full|seo|defects|design|quick|verify|checks|report] [url|file] | compare [A] [B]" allowed-tools:
- Read
- Write
- WebFetch
- Glob
- Grep
- Task
- Bash(node *)
- Bash(python3 *)
Complete-audit toolkit for websites. One pass that orchestrates the plugin's three other skills (/seo, /inspect, /siteasy), dispatches all 13 specialist sub-agents across search visibility, front-end defects, and design quality, then merges their scored sections into a single Site Health Score with a prioritized action plan. The audit skill owns no detection logic of its own. It schedules the existing sub-agents, shares one fetch across them, and consolidates the results.
Commands
| Command | What it does | Reference | |
|---|---|---|---|
full [url] | All 13 sub-agents across SEO, defects, and design; unified report + action plan | references/full.md | |
seo [url] | Search-visibility group only (5 SEO sub-agents) | references/full.md | |
defects [url] | Front-end defect group only (4 inspect sub-agents) | references/full.md | |
design [url] | Design-quality group only (4 siteasy sub-agents) | references/full.md | |
quick [url] | One representative sub-agent per group for a fast triage | references/full.md | |
checks [url] | Deterministic pre-pass only: computed checks plus SITE-AUDIT.json, no sub-agents | references/checks.md | |
verify [url] | Consensus re-check: re-runs the gating dimensions (a11y, interaction, technical) K times and reconciles them by majority vote | references/full.md | |
compare [A] [B] | Diff two targets (before/after a site, or A vs B): per-check verdict changes and score deltas | references/compare.md | |
report [file] | Format an existing audit into a client-ready report, a self-contained HTML page, or PDF | references/report.md + references/html-report.md |
Nine commands, five references. The five agent run modes (full, seo, defects, design, quick) share the orchestration playbook in references/full.md and differ only in which agent group is dispatched. verify additionally re-runs the gating dimensions and reconciles them by majority vote. checks runs the deterministic pre-pass with no sub-agents and is documented in references/checks.md; it is also the ground-truth layer the agent modes consume in their fetch phase. compare diffs two targets (references/compare.md) and report formats an already-produced audit (references/report.md).
How to run a command
When the user invokes a command:
- Read the matching reference file with the Read tool (
full.mdfor the agent run modes,checks.mdfor the deterministic pre-pass,compare.mdfor compare,report.mdfor formatting). - Follow the instructions in that reference exactly. Do not improvise scoring weights or skip a dimension.
- If no command is specified:
- With a URL, the bare invocation runs
fullagainst that URL. - With no URL, ask the user for the site URL before dispatching any agent.
Relationship to the other skills
The three audit groups map one-to-one onto the plugin's three other skills and reuse their sub-agents directly. There is a single source of truth per dimension and no duplicated detection logic. The audit skill changes only the scheduling (parallel, shared fetch) and the consolidation (one merged report).
| Group | Backing skill | Sub-agents reused | |
|---|---|---|---|
| Search visibility | /seo (see /seo audit) | seo-agent-technical, seo-agent-content, seo-agent-schema, seo-agent-performance, seo-agent-geo | |
| Front-end defects | /inspect (detect, review) | inspect-agent-a11y, inspect-agent-interaction, inspect-agent-layout, inspect-agent-code | |
| Design quality | /siteasy (see /siteasy audit) | siteasy-agent-ux, siteasy-agent-visual, siteasy-agent-motion, siteasy-agent-content |
Because the agents are shared, a fix surfaced here can be re-run or deepened with the owning skill (for example /seo technical for a flagged crawl issue, or /siteasy clarify for flagged copy) without re-auditing the whole site.
Output
Each agent run mode produces two markdown files (see references/full.md for the templates) plus a machine-readable SITE-AUDIT.json:
SITE-AUDIT-REPORT.mdholds the full findings for every group that ran, with each agent's returned section embedded verbatim.SITE-ACTION-PLAN.mdholds the consolidated, de-duplicated fix list ordered Critical, High, Medium, Low.SITE-AUDIT.jsonholds the machine-readable result (scores plus per-check verdicts plus a cost ledger) that powerscompare, CI gating and score-over-time. Thechecksmode writes only this file. Schema:tools/audit/schema/site-audit.schema.json.
The overall Site Health Score weights Search Visibility at 35 percent, Front-end Defects at 35 percent, and Design Quality at 30 percent. Any critical accessibility or interaction defect caps the Defects group regardless of other passes. The exact weights and the cap rule live in references/full.md.
When NOT to use
| Situation | Use instead | |
|---|---|---|
| You only need search visibility | /seo audit | |
| You only need deterministic front-end defects | /inspect detect or /inspect review | |
| You only need subjective design and UX review | /siteasy audit | |
| You want to build, fix, or redesign the interface | /siteasy build |
A single-dimension request does not need all 13 agents. Routing it to the one owning skill is faster and cheaper. The audit skill is for the whole-site, cross-dimension pass.