Skip to content

feat(.claude): atomic web.dev-aligned skill & reviewer suite#138

Merged
TheMeinerLP merged 6 commits into
mainfrom
claude/improve-lighthouse-reports-S9kl4
May 16, 2026
Merged

feat(.claude): atomic web.dev-aligned skill & reviewer suite#138
TheMeinerLP merged 6 commits into
mainfrom
claude/improve-lighthouse-reports-S9kl4

Conversation

@TheMeinerLP
Copy link
Copy Markdown
Collaborator

Summary

Restructure the accessibility and quality assurance framework from a monolithic a11y-review skill and single accessibility-reviewer agent 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:

    • Deleted .claude/skills/a11y-review/SKILL.md (48-line comprehensive checklist)
    • Deleted .claude/agents/accessibility-reviewer.md (30-line catch-all reviewer)
  • Added 40+ atomic skills (one topic each):

    • Accessibility (7): a11y-semantic-structure, a11y-keyboard-focus, a11y-names-labels-i18n, a11y-forms, a11y-aria-dynamic, a11y-contrast-motion, a11y-typography
    • Best Practices (4): bp-bfcache, bp-clean-console, bp-no-hydration-mismatch, bp-no-prod-source-maps
    • Network (5): net-cache-lifetimes, net-critical-request-chain, net-font-loading, net-resource-hints, net-text-compression
    • Performance (9): perf-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-css
    • Privacy (3): privacy-consent-gating, privacy-data-minimisation, privacy-transparency
    • Security (5): sec-content-security-policy, sec-dependency-safety, sec-no-mixed-content, sec-response-headers, sec-safe-links-embeds
    • SEO (5): seo-canonical-hreflang, seo-crawlable-content, seo-indexability, seo-page-metadata, seo-structured-data
  • Added 40+ matching reviewer agents (one per skill):

    • Each reviewer is scoped to exactly one skill topic
    • Consistent structure: reads changed files, applies the skill checklist, reports findings only
    • Defers all other concerns to their own atomic reviewers
  • Updated AGENTS.md:

    • Introduced the atomic principle: every skill addresses one topic with a matching reviewer
    • Clarified that skills should be applied during development; reviewers delegated before PR
    • Listed all accessibility skills (now split by topic) with guidance on when to use each
    • Emphasized using only the skills/agents the change actually touches
  • Updated component-scaffold/SKILL.md:

    • Added section "Build the web.dev quality pillars in from the start"
    • Listed which atomic skills to apply during scaffolding (accessible, performant, secure, SEO, privacy)
    • Reinforced the pattern of applying skills early, not retrofitting

Implementation Details

  • Each skill file is concise (~18–25 lines) with a single-topic description and checklist
  • Each reviewer agent has the same structure: git diff, read changed files, apply the skill, report findings
  • Skills are organized by pillar (a11y, perf, sec, seo, privacy, bp, net) for discoverability
  • The atomic principle ensures reviewers can be delegated independently without overlap
  • All skills reference the Nuxt 4 / Vue 3 / Tailwind v4 / Cloudflare Workers stack

https://claude.ai/code/session_01KoQywVk4Mj9EqgxScc4Yrr

claude added 6 commits May 16, 2026 14:45
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
@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

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

@TheMeinerLP TheMeinerLP changed the title Refactor a11y and quality reviews into atomic skills and reviewers feat(.claude): atomic web.dev-aligned skill & reviewer suite May 16, 2026
@TheMeinerLP TheMeinerLP merged commit 22cb2df into main May 16, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants