Website Creator Skill — 27-Point Quality Audit Methodology
Context
Built a comprehensive audit methodology for reference/technique skills applied to ~/.claude/skills/website-creator/. The skill covers 8 phases of website creation from requirements gathering through deployment.
Methodology
Categorize findings into 3 tiers: Critical (6 — missing templates/phases causing agent hallucination), Moderate (12 — quality-reducing gaps), Corner Cases (9 — edge conditions). Fix order: Critical first, then batch moderate + corner cases.
Key Findings Pattern
- No Phase 0 = no user onboarding — Skill jumped to scaffolding without asking user requirements. Added 12-question elicitation table.
- Missing code templates = agent hallucination — When a skill says “create X” without providing template code, the agent invents its own (often wrong). Templates for ThemeProvider, error.tsx, loading.tsx, not-found.tsx, contact form Server Action were critical additions.
- Playwright CLI integration — VPS has
playwright-clifor live visual verification. Integrated 42 mentions across Phase 3, 6, and testing-pipeline.md. This is a unique capability advantage. - “use client” confusion — Without explicit rules about when to add the directive, agents inconsistently apply it. Added concrete rules in Phase 2.
Verification Technique
After all fixes, grep for mention counts of key features across all skill files to confirm coverage:
grep -c "playwright-cli" SKILL.md references/*.md
grep -c '"use client"' SKILL.md
grep -c "skip" SKILL.md # skip linksReusable For
Any skill audit — the 3-tier categorization (Critical/Moderate/Corner) and the “mention count verification” technique apply universally.