Audit
Skill timeyour/agentskills-audit-collection/.claude/skills/audit
AI delivery acceptance and audit system for vibe-coded websites, web apps, and agent-built products.
npx -y skills add timeyour/agentskills-audit-collection --skill auditAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
End-to-end agent skill for auditing websites, web apps, open-source projects, AI-built products, and vibe-coded examples. Use when the user wants a full workflow covering source evidence, live feature testing, visual/aesthetic quality, deployment readiness, five-pass acceptance, issue cards, copyable fixes, and accumulated learning.
SKILL.md
6.9 KB, as published. Nobody here has run it
Audit
Use this skill as the single entry point for the full audit workflow.
The goal is to make a product or website testable, visible, and fixable:
target -> intake -> surface discovery -> permission boundary -> source pass -> live flow test -> visual/aesthetic audit -> product-pattern audit -> deployment audit -> five-pass acceptance -> issue cards -> copyable fixes -> learning ledger
When To Use
Use /audit when the user gives:
- a live website URL;
- a web app;
- an open-source repository;
- a vibe-coded project;
- a design tool/resource;
- a batch of sites;
- a request to test every function;
- a request to judge page quality, visual style, deployment gaps, or workflow breakage.
Core Rules
- Separate source evidence from live evidence.
- Do not treat gallery claims, docs, or marketing copy as proof that a workflow works.
- Every issue needs a live position or source locator.
- Every important feature needs expected vs actual behavior.
- Visual scores are source-based until screenshots or browser evidence exist.
- Tool claims require execution evidence before full acceptance.
- Repeat important audits through five passes and record what was learned.
- For multi-step audits, emit progressive updates so the user can see the audit trail before the final report.
- When the user wants live step visibility or a workbench view, follow
references/live-run-protocol.mdand updaterun-state.jsonplusrun-events.ndjsonundervalidation/artifacts/{runId}/. - Discover the web surface before detailed testing: pages, interactions, media, documents, network/API, storage, and security surfaces.
- Use the permission model before any live interaction; never perform risky production actions silently.
- For AI-built products, generated code, and product acceptance reviews, use
references/failure-modes.mdto check common hidden failures before declaring readiness. - Use the shared output shape when applicable: Scope, Evidence, Findings, Severity, Reproduction, Fix Suggestion, Regression Check, Lessons.
- Use
S0-S4severity for delivery impact.
Workflow
-
Intake
- Identify target type: URL, repo, batch list, local app, design artifact, or tool.
- Determine permission level using
references/permission-model.md: public read-only, safe click/navigation, test account flow, staging authorized, or production guarded. - If destructive/payment/private actions appear, mark them
SKIPPED-SAFE. - For audits with more than five meaningful steps, load
references/progressive-reporting.mdand announce the planned stages. - If the user wants real-time workbench visibility, run
scripts/audit-run-init.sh(or createvalidation/artifacts/{runId}/manually) and loadreferences/live-run-protocol.md.
-
Web surface discovery
- Before detailed testing, map pages, interaction controls, media assets, documents/downloads, network/API surfaces, storage/session surfaces, and security-sensitive entry points.
- Use
references/web-surface-discovery.md. - Prioritize surfaces as
P0,P1,P2,skip-safe, orunknown. - Emit a progress update summarizing the discovered surface and permission boundaries.
-
Source pass
- Collect source claims, docs, gallery metadata, repo files, community posts, and product promises.
- Record source locator and confidence.
- Use
references/source-evidence.md. - For AI-built or agent-built work, also scan for failure modes from
references/failure-modes.md: weak validation, unsafe mutations, N+1 or unbounded loading, swallowed exceptions, hallucinated APIs, secrets, placeholders, dependency drift, and missing extreme states. - Emit a progress update after completing the source pass when live or visual work remains.
-
Feature inventory
- List every visible or documented feature.
- Include navigation, CTA, forms, auth, dashboards, search, upload, copy/export/share, checkout/payment, admin/CMS, and deployment tools.
- Reconcile this inventory with the web surface discovery map.
-
Live functional audit
- Execute every safe flow as far as possible.
- Record URL, live position, locator, steps, expected result, actual result, evidence, risk, and status.
- Use
references/live-functional-audit.md, or invoke/flow-testfor a dedicated pass. - Emit progress updates after each major route, form, CTA group, auth boundary, or blocker.
-
Visual and aesthetic audit
- Inspect layout, hierarchy, spacing, typography, color, images, component consistency, responsiveness, trust, and AI slop signals.
- Use
references/webpage-audit-rubric.mdandreferences/aesthetic-quality-audit.md, or invoke/visual-qafor a dedicated pass.
6.5. Product-pattern audit
- For lifestyle, service, commerce, creator, and SaaS products, check scenario preparation, pattern fit, and conversion readiness.
- Use
../ai-product-audit/references/product-pattern-rubric.md, or invoke/ai-product-auditfor a dedicated pass.
-
Deployment readiness
- Check domain, SSL, env vars, backend/API, database, auth, email/SMS, storage, payment, CMS/admin, analytics, monitoring, SEO, privacy, backup, and rollback.
- Use
references/deployment-readiness.md.
-
Five-pass acceptance
- For important targets, run baseline, functional, edge/failure, visual/deployment, and retest/experience passes.
- Use
references/five-pass-acceptance.md, or invoke/accept-fivefor a dedicated pass.
-
Output
- Produce scope, evidence split, findings, severity, reproduction, fix suggestions, regression checks, lessons, feature maps, issue cards, deployment table, copyable fix pack, final verdict, and experience ledger.
- Use
references/report-format.md. - Convert progress updates into the final report instead of pasting a raw running log.
-
Learn
- Convert repeated findings into guardrails, checklist items, better prompts, or benchmark examples.
- If durable, update
CLAUDE.mdor relevant skill references.
Verdicts
PASS: core flows, visual quality, and deployment requirements are acceptable.PASS WITH NOTES: usable or useful, but gaps remain.FAIL: critical workflow, visual trust, security, or deployment blocker remains.INCOMPLETE: source pass happened, but live/visual/tool execution evidence is missing.
Anti-Patterns
- Calling a source-level pass a live audit.
- Reviewing only the homepage.
- Judging only aesthetics.
- Testing only the happy path.
- Ignoring mobile.
- Missing route aliases, deep links, and shared URLs.
- Reporting vague fixes like "improve UI".
- Failing to create copyable prompts.
- Running five passes without accumulating new experience.