feat(.claude): atomic web.dev-aligned skill & reviewer suite#138
Merged
Conversation
Adds repo-tailored .claude tooling derived from the mobile/desktop Lighthouse reports for onelitefeather.net/de: skills for performance (TBT, CLS, third-party scripts, render-blocking) and best-practices (console errors, third-party cookies, bf-cache, source maps), plus an independent lighthouse-performance-reviewer subagent. Documented in AGENTS.md as the single source of truth. https://claude.ai/code/session_01KoQywVk4Mj9EqgxScc4Yrr
Corrects the lighthouse-best-practices skill so valid-source-maps is an accepted trade-off (hidden, privately uploaded maps only — no public .map / sourceMappingURL). Adds google-web-guidelines-reviewer subagent that audits against Core Web Vitals, Lighthouse Best Practices and web.dev, with the no-prod-source-maps policy as an explicit override. https://claude.ai/code/session_01KoQywVk4Mj9EqgxScc4Yrr
Adds repo-tailored skill + independent reviewer agent pairs for the
remaining web.dev pillars: security ("Safe"), SEO/discoverability
("Discoverable"), privacy/consent, and network/caching ("Fast" loading).
Each is grounded in the actual Lighthouse findings for onelitefeather.net
and documented in AGENTS.md as the single source of truth.
https://claude.ai/code/session_01KoQywVk4Mj9EqgxScc4Yrr
Restructures a11y-review around web.dev "Accessible" topics (adds ARIA & dynamic content, forms, manual review method), embeds accessibility-reviewer as the a11y pillar of the web.dev-aligned reviewer set, and makes component-scaffold bake in the web.dev quality pillars (Accessible, Fast, Discoverable, Safe, Privacy) from the start instead of retrofitting. https://claude.ai/code/session_01KoQywVk4Mj9EqgxScc4Yrr
Replaces the 7 composite pillar skills and 7 broad reviewer agents with 35 atomic skills (one topic each: perf-*, bp-*, net-*, sec-*, seo-*, privacy-*, a11y-*) and a matching <skill>-reviewer agent per topic. component-scaffold and AGENTS.md updated to reference the atomic units; the no-prod-source-maps policy is preserved as bp-no-prod-source-maps. https://claude.ai/code/session_01KoQywVk4Mj9EqgxScc4Yrr
web.dev cross-check found three uncovered topics (two also flagged in the Lighthouse reports): perf-image-delivery (web.dev Performance "Images" / image-delivery-insight), perf-main-thread-work (web.dev "Web Workers" / INP, mainthread-work/bootup/TBT), and a11y-typography (web.dev Accessibility "Typography"). Each adds a matching atomic <skill>-reviewer agent; AGENTS.md updated. https://claude.ai/code/session_01KoQywVk4Mj9EqgxScc4Yrr
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
launchpad | bc04d2a | Commit Preview URL Branch Preview URL |
May 16 2026, 03:14 PM |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Restructure the accessibility and quality assurance framework from a monolithic
a11y-reviewskill and singleaccessibility-revieweragent into a fine-grained, atomic skill/reviewer system. Each skill now addresses exactly one topic (e.g., semantic structure, keyboard focus, contrast, forms) with a matching single-topic reviewer agent. This enables more focused, delegable reviews and clearer guidance on which skills apply to each change.Key Changes
Removed monolithic skill/agent:
.claude/skills/a11y-review/SKILL.md(48-line comprehensive checklist).claude/agents/accessibility-reviewer.md(30-line catch-all reviewer)Added 40+ atomic skills (one topic each):
a11y-semantic-structure,a11y-keyboard-focus,a11y-names-labels-i18n,a11y-forms,a11y-aria-dynamic,a11y-contrast-motion,a11y-typographybp-bfcache,bp-clean-console,bp-no-hydration-mismatch,bp-no-prod-source-mapsnet-cache-lifetimes,net-critical-request-chain,net-font-loading,net-resource-hints,net-text-compressionperf-cls-layout-stability,perf-defer-third-party-scripts,perf-image-delivery,perf-lcp-element,perf-main-thread-work,perf-minify-js,perf-no-legacy-js,perf-reduce-unused-js,perf-render-blocking-cssprivacy-consent-gating,privacy-data-minimisation,privacy-transparencysec-content-security-policy,sec-dependency-safety,sec-no-mixed-content,sec-response-headers,sec-safe-links-embedsseo-canonical-hreflang,seo-crawlable-content,seo-indexability,seo-page-metadata,seo-structured-dataAdded 40+ matching reviewer agents (one per skill):
Updated
AGENTS.md:Updated
component-scaffold/SKILL.md:Implementation Details
git diff, read changed files, apply the skill, report findingshttps://claude.ai/code/session_01KoQywVk4Mj9EqgxScc4Yrr