{"_id":"@ctxr/skill-frontend-excellence","_rev":"6-2dc49a672541442d4520a98dc75eef67","name":"@ctxr/skill-frontend-excellence","dist-tags":{"latest":"0.3.1"},"versions":{"0.1.1":{"name":"@ctxr/skill-frontend-excellence","version":"0.1.1","keywords":["agent-skills","agents-md","codex","claude-code","skill","frontend","lighthouse","accessibility","seo","ui-ux","design","performance","core-web-vitals","ai","agents","ctxr"],"license":"MIT","_id":"@ctxr/skill-frontend-excellence@0.1.1","maintainers":[{"name":"meshin","email":"dmitri.meshin@gmail.com"}],"homepage":"https://github.com/ctxr-dev/skill-frontend-excellence#readme","bugs":{"url":"https://github.com/ctxr-dev/skill-frontend-excellence/issues"},"ctxr":{"type":"skill","target":"folder"},"dist":{"shasum":"24a95214c0a846842e3bac276bc366b8e5e148ca","tarball":"https://registry.npmjs.org/@ctxr/skill-frontend-excellence/-/skill-frontend-excellence-0.1.1.tgz","fileCount":20,"integrity":"sha512-WPLkadq8J7ZdFC1n28evUfyNOulfSxdsoiScu7pJ0Cv/pfyYeLLQvwlXx2yMHcxa7/W5RaLpTo+Ke7rcvRSs6g==","signatures":[{"sig":"MEUCIHNo7jJC8Y1rnYiE/+0vw20kq1XZfd7/kaROjq9WSg11AiEA3Bb1+nbxXdBPVGl9nz8PMDhMyp+1QwpumNa2gdbq3JU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ctxr%2fskill-frontend-excellence@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":281445},"type":"module","engines":{"node":">=20"},"gitHead":"5957a867243f741a9e64848605d3061fc3f5ddc9","scripts":{"lint":"markdownlint-cli2 \"**/*.md\" \"#node_modules\"","prepare":"husky","lint:fix":"markdownlint-cli2 --fix \"**/*.md\" \"#node_modules\"","validate":"npm run validate:no-dashes && npm run lint","prepublishOnly":"npm run validate","validate:no-dashes":"node scripts/check-no-dashes.mjs"},"_npmUser":{"name":"meshin","email":"dmitri.meshin@gmail.com"},"repository":{"url":"git+https://github.com/ctxr-dev/skill-frontend-excellence.git","type":"git"},"_npmVersion":"10.9.7","description":"Agent Skills playbook (Claude Code, Codex CLI): framework-agnostic guide for shipping ultra-fast, accessible, search-friendly, visually distinctive web interfaces. Lighthouse mastery, UI/UX, design aesthetics, performance, accessibility, SEO, motion, form","directories":{},"_nodeVersion":"22.22.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.0","markdownlint-cli2":"^0.14.0"},"_npmOperationalInternal":{"tmp":"tmp/skill-frontend-excellence_0.1.1_1778447039453_0.9612814845146944","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@ctxr/skill-frontend-excellence","version":"0.1.2","keywords":["agent-skills","agents-md","codex","claude-code","skill","frontend","lighthouse","accessibility","seo","ui-ux","design","performance","core-web-vitals","ai","agents","ctxr"],"license":"MIT","_id":"@ctxr/skill-frontend-excellence@0.1.2","maintainers":[{"name":"meshin","email":"dmitri.meshin@gmail.com"}],"homepage":"https://github.com/ctxr-dev/skill-frontend-excellence#readme","bugs":{"url":"https://github.com/ctxr-dev/skill-frontend-excellence/issues"},"ctxr":{"type":"skill","target":"folder"},"dist":{"shasum":"a56d65c697fab8b5759ed18ca3bcad8c5a2f85b2","tarball":"https://registry.npmjs.org/@ctxr/skill-frontend-excellence/-/skill-frontend-excellence-0.1.2.tgz","fileCount":20,"integrity":"sha512-TcPDVJ3K5UIsNbACEB4m7851Ruu+V3XrohOz2Y6clWybvpBPrTEOPPQF4J4/CaDj1NMln2CSTy0cR9PGhtRI0Q==","signatures":[{"sig":"MEYCIQCBNsajIEl2ffBUYMIVsKFH9Xcu8OR6yl+496vXuCMCEAIhAMy3soPweIL/J8Rdy3/aQp3HwZI0P7Ib2T2C1vMAVTM6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ctxr%2fskill-frontend-excellence@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":311409},"type":"module","engines":{"node":">=20"},"gitHead":"085c282f291fc7d7f4ccdbbe14f251a108fdbb54","scripts":{"lint":"markdownlint-cli2 \"**/*.md\" \"#node_modules\"","prepare":"husky","lint:fix":"markdownlint-cli2 --fix \"**/*.md\" \"#node_modules\"","validate":"npm run validate:no-dashes && npm run lint","prepublishOnly":"npm run validate","validate:no-dashes":"node scripts/check-no-dashes.mjs"},"_npmUser":{"name":"meshin","email":"dmitri.meshin@gmail.com"},"repository":{"url":"git+https://github.com/ctxr-dev/skill-frontend-excellence.git","type":"git"},"_npmVersion":"10.9.8","description":"Agent Skills playbook (Claude Code, Codex CLI): framework-agnostic guide for shipping ultra-fast, accessible, search-friendly, visually distinctive web interfaces. Lighthouse mastery, UI/UX, design aesthetics, performance, accessibility, SEO, motion, form","directories":{},"_nodeVersion":"22.22.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.0","markdownlint-cli2":"^0.14.0"},"_npmOperationalInternal":{"tmp":"tmp/skill-frontend-excellence_0.1.2_1779823130431_0.4379250539505737","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@ctxr/skill-frontend-excellence","version":"0.2.0","keywords":["agent-skills","agents-md","codex","claude-code","skill","frontend","lighthouse","accessibility","seo","ui-ux","design","performance","core-web-vitals","ai","agents","ctxr"],"license":"MIT","_id":"@ctxr/skill-frontend-excellence@0.2.0","maintainers":[{"name":"meshin","email":"dmitri.meshin@gmail.com"}],"homepage":"https://github.com/ctxr-dev/skill-frontend-excellence#readme","bugs":{"url":"https://github.com/ctxr-dev/skill-frontend-excellence/issues"},"ctxr":{"type":"skill","target":"folder"},"dist":{"shasum":"503939eb551836faf9f56c21d81ebdda9e15b15e","tarball":"https://registry.npmjs.org/@ctxr/skill-frontend-excellence/-/skill-frontend-excellence-0.2.0.tgz","fileCount":32,"integrity":"sha512-oGtw/xfD0yw90VGgYGQbBY+D2lpnyrRHqx9G0ai0vaWrJyVU7PsUgj3ceV+oCDDTR5RDgZLnnlEubn8BYjTI3w==","signatures":[{"sig":"MEUCIQCYN0v8UvRhPb6tjx0VNz1f74zM1A5nUV8ZA5BVde2DlAIgYLa2a3RP4arOfl279c4T2VF7v5hdYbxUgpOM5mPxSwM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ctxr%2fskill-frontend-excellence@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":680535},"type":"module","engines":{"node":">=20"},"gitHead":"8f4ced5f2a5334aa6c0cc8364c10fe147b745dab","scripts":{"lint":"markdownlint-cli2 \"**/*.md\" \"#node_modules\"","prepare":"husky","lint:fix":"markdownlint-cli2 --fix \"**/*.md\" \"#node_modules\"","validate":"npm run validate:no-dashes && npm run lint","prepublishOnly":"npm run validate","validate:no-dashes":"node scripts/check-no-dashes.mjs"},"_npmUser":{"name":"meshin","email":"dmitri.meshin@gmail.com"},"repository":{"url":"git+https://github.com/ctxr-dev/skill-frontend-excellence.git","type":"git"},"_npmVersion":"10.9.8","description":"Agent Skills playbook (Claude Code, Codex CLI): framework-agnostic guide for shipping ultra-fast, accessible, search-friendly, visually distinctive web interfaces. Lighthouse mastery, UI/UX, design aesthetics, performance, accessibility, SEO, motion, form","directories":{},"_nodeVersion":"22.22.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.0","markdownlint-cli2":"^0.14.0"},"_npmOperationalInternal":{"tmp":"tmp/skill-frontend-excellence_0.2.0_1780061530634_0.400805737242494","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@ctxr/skill-frontend-excellence","version":"0.2.1","keywords":["agent-skills","agents-md","codex","claude-code","skill","frontend","lighthouse","accessibility","seo","ui-ux","design","performance","core-web-vitals","ai","agents","ctxr"],"license":"MIT","_id":"@ctxr/skill-frontend-excellence@0.2.1","maintainers":[{"name":"meshin","email":"dmitri.meshin@gmail.com"}],"homepage":"https://github.com/ctxr-dev/skill-frontend-excellence#readme","bugs":{"url":"https://github.com/ctxr-dev/skill-frontend-excellence/issues"},"ctxr":{"type":"skill","target":"folder"},"dist":{"shasum":"cc04399cead75a5937c1845928c189c8982bb76b","tarball":"https://registry.npmjs.org/@ctxr/skill-frontend-excellence/-/skill-frontend-excellence-0.2.1.tgz","fileCount":32,"integrity":"sha512-S3E/NZk87psi9jZymjkweSgDMvXTUjfK+WTIanmXcXsb+gS71iapLCSEjn5AW4dzcP5SVsYZ0AvJGeQ/Ta/TQQ==","signatures":[{"sig":"MEUCIEgSX5YhIlZI+70N6nePpUzXweU30ZdEH/eBvY6ecfYcAiEAzLYVsapGsA7EukScubSAc0WNGzZavi3RSr7NQX248XU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ctxr%2fskill-frontend-excellence@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":680764},"type":"module","engines":{"node":">=20"},"gitHead":"a5013db8953b9bba1161e02c76151eab139bbee7","scripts":{"lint":"markdownlint-cli2 \"**/*.md\" \"#node_modules\"","prepare":"husky","lint:fix":"markdownlint-cli2 --fix \"**/*.md\" \"#node_modules\"","validate":"npm run validate:no-dashes && npm run lint","prepublishOnly":"npm run validate","validate:no-dashes":"node scripts/check-no-dashes.mjs"},"_npmUser":{"name":"meshin","email":"dmitri.meshin@gmail.com"},"repository":{"url":"git+https://github.com/ctxr-dev/skill-frontend-excellence.git","type":"git"},"_npmVersion":"10.9.8","description":"Agent Skills playbook (Claude Code, Codex CLI): framework-agnostic guide for shipping ultra-fast, accessible, search-friendly, visually distinctive web interfaces. Lighthouse mastery, UI/UX, design aesthetics, performance, accessibility, SEO, motion, form","directories":{},"_nodeVersion":"22.22.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.0","markdownlint-cli2":"^0.14.0"},"_npmOperationalInternal":{"tmp":"tmp/skill-frontend-excellence_0.2.1_1780091998300_0.1823967271822684","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@ctxr/skill-frontend-excellence","version":"0.3.0","keywords":["agent-skills","agents-md","codex","claude-code","skill","frontend","lighthouse","accessibility","seo","ui-ux","design","performance","core-web-vitals","ai","agents","ctxr"],"license":"MIT","_id":"@ctxr/skill-frontend-excellence@0.3.0","maintainers":[{"name":"meshin","email":"dmitri.meshin@gmail.com"}],"homepage":"https://github.com/ctxr-dev/skill-frontend-excellence#readme","bugs":{"url":"https://github.com/ctxr-dev/skill-frontend-excellence/issues"},"ctxr":{"type":"skill","target":"folder"},"dist":{"shasum":"85d948da78bd1da464b47ef0ec0ab3627c3dcc67","tarball":"https://registry.npmjs.org/@ctxr/skill-frontend-excellence/-/skill-frontend-excellence-0.3.0.tgz","fileCount":33,"integrity":"sha512-ijbfIYovOFVvePQDy8AOYkXI9CzCuZQv5D8Ws6cPGifjph//dhy56n/abhdWLJJJkrfB2ABZqdyTMW/JVmw30A==","signatures":[{"sig":"MEUCIQDdTHtoky4sZ+N44+W5urvKZXOMgopiw3TBlX63E0d2vgIgMq9a9bvMMZa5sqNS6D66D9hoF7HS0U7pU6iQx9HLCic=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ctxr%2fskill-frontend-excellence@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":632321},"type":"module","engines":{"node":">=20"},"gitHead":"bcdd3a5fee4723e8ec1d206a5e3bf1553afa5b53","scripts":{"lint":"markdownlint-cli2 \"**/*.md\" \"#node_modules\"","prepare":"husky","lint:fix":"markdownlint-cli2 --fix \"**/*.md\" \"#node_modules\"","validate":"npm run validate:no-dashes && npm run validate:structure && npm run lint","prepublishOnly":"npm run validate","validate:no-dashes":"node scripts/check-no-dashes.mjs","validate:structure":"node scripts/validate-structure.mjs","validate:structure:fix":"node scripts/validate-structure.mjs --fix"},"_npmUser":{"name":"meshin","email":"dmitri.meshin@gmail.com"},"repository":{"url":"git+https://github.com/ctxr-dev/skill-frontend-excellence.git","type":"git"},"_npmVersion":"10.9.8","description":"Agent Skills playbook (Claude Code, Codex CLI): framework-agnostic guide for shipping ultra-fast, accessible, search-friendly, visually distinctive web interfaces. Lighthouse mastery, UI/UX, design aesthetics, performance, accessibility, SEO, motion, form","directories":{},"_nodeVersion":"22.22.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"husky":"^9.1.0","markdownlint-cli2":"^0.14.0"},"_npmOperationalInternal":{"tmp":"tmp/skill-frontend-excellence_0.3.0_1780437492573_0.33440555324883614","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@ctxr/skill-frontend-excellence","version":"0.3.1","description":"Agent Skills playbook (Claude Code, Codex CLI): framework-agnostic guide for shipping ultra-fast, accessible, search-friendly, visually distinctive web interfaces. Lighthouse mastery, UI/UX, design aesthetics, performance, accessibility, SEO, motion, form","type":"module","license":"MIT","repository":{"type":"git","url":"git+https://github.com/ctxr-dev/skill-frontend-excellence.git"},"homepage":"https://github.com/ctxr-dev/skill-frontend-excellence#readme","bugs":{"url":"https://github.com/ctxr-dev/skill-frontend-excellence/issues"},"keywords":["agent-skills","agents-md","codex","claude-code","skill","frontend","lighthouse","accessibility","seo","ui-ux","design","performance","core-web-vitals","ai","agents","ctxr"],"ctxr":{"type":"skill","target":"folder"},"publishConfig":{"access":"public"},"engines":{"node":">=20"},"scripts":{"lint":"markdownlint-cli2 \"**/*.md\" \"#node_modules\"","lint:fix":"markdownlint-cli2 --fix \"**/*.md\" \"#node_modules\"","validate:no-dashes":"node scripts/check-no-dashes.mjs","validate:structure":"node scripts/validate-structure.mjs","validate:structure:fix":"node scripts/validate-structure.mjs --fix","validate":"npm run validate:no-dashes && npm run validate:structure && npm run lint","prepare":"husky","prepublishOnly":"npm run validate"},"devDependencies":{"husky":"^9.1.0","markdownlint-cli2":"^0.14.0"},"_id":"@ctxr/skill-frontend-excellence@0.3.1","gitHead":"cf856cee41652d2cd79021c15237ab81f67abb7e","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-lvp62Sh+JhYJJsCl/GWwBgVHNouUhCYrbYzKrKCLVbIKreIS5c6W9F3CGlEoI+/7MOY859ZU2mEfhoILvaaMHA==","shasum":"180369475020adeadfc51888455763007b4990b2","tarball":"https://registry.npmjs.org/@ctxr/skill-frontend-excellence/-/skill-frontend-excellence-0.3.1.tgz","fileCount":33,"unpackedSize":634417,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ctxr%2fskill-frontend-excellence@0.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCzWpH8Lfny9CB6vEITTnSc5MlCtLcVO1l2z6UFLLIZqAIhAL+phJPH/3EWBRTyiFM1oTM07A/N3yFIw+tH/GciwOjJ"}]},"_npmUser":{"name":"meshin","email":"dmitri.meshin@gmail.com"},"directories":{},"maintainers":[{"name":"meshin","email":"dmitri.meshin@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/skill-frontend-excellence_0.3.1_1781335729484_0.6940919827259389"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-10T21:03:59.378Z","modified":"2026-06-13T07:28:50.003Z","0.1.1":"2026-05-10T21:03:59.592Z","0.1.2":"2026-05-26T19:18:50.589Z","0.2.0":"2026-05-29T13:32:10.821Z","0.2.1":"2026-05-29T21:59:58.488Z","0.3.0":"2026-06-02T21:58:12.875Z","0.3.1":"2026-06-13T07:28:49.675Z"},"bugs":{"url":"https://github.com/ctxr-dev/skill-frontend-excellence/issues"},"license":"MIT","homepage":"https://github.com/ctxr-dev/skill-frontend-excellence#readme","keywords":["agent-skills","agents-md","codex","claude-code","skill","frontend","lighthouse","accessibility","seo","ui-ux","design","performance","core-web-vitals","ai","agents","ctxr"],"repository":{"type":"git","url":"git+https://github.com/ctxr-dev/skill-frontend-excellence.git"},"description":"Agent Skills playbook (Claude Code, Codex CLI): framework-agnostic guide for shipping ultra-fast, accessible, search-friendly, visually distinctive web interfaces. Lighthouse mastery, UI/UX, design aesthetics, performance, accessibility, SEO, motion, form","maintainers":[{"name":"meshin","email":"dmitri.meshin@gmail.com"}],"readme":"# Frontend Excellence Skill (Claude Code, Codex CLI)\n\n[![npm](https://img.shields.io/npm/v/@ctxr/skill-frontend-excellence)](https://www.npmjs.com/package/@ctxr/skill-frontend-excellence)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Claude%20Code%20%7C%20Codex%20CLI-blue)](https://agentskills.io)\n\n> Supports Claude Code and OpenAI Codex CLI via the open Agent Skills standard. Content-only Markdown: one entry point (`SKILL.md`) plus topical references under `references/`. No runtime, no scripts, no framework assumptions.\n\nA holistic, framework-agnostic playbook for shipping ultra-fast, accessible, search-friendly, visually distinctive web interfaces. Combines Lighthouse mastery, UI/UX patterns, design aesthetics, performance, accessibility, SEO, motion, forms, layout, data visualization, and a 19-phase multi-page audit workflow with widget standardization and geometry sweeps. Every rule is expressed as a principle plus a concrete check, never as a library API, so the guidance applies to vanilla HTML/CSS/JS, React, Vue, Svelte, Astro, Solid, Next.js, Nuxt, SvelteKit, Remix, Qwik, Lit, and Web Components alike.\n\nThe skill encodes a single, opinionated bar (see [North Star Targets](#north-star-targets)). Treat any failure as a blocking defect, not a polish task.\n\n## Quick Start\n\n```bash\n# Install into your project\nnpx @ctxr/kit@latest install @ctxr/skill-frontend-excellence\n```\n\nOpen the project in any Agent Skills-compatible harness. The skill auto-activates from its YAML frontmatter the moment a prompt touches how an interface looks, feels, moves, loads, ranks, or is interacted with. There is no slash command to invoke; the skill is content-only.\n\n## Prerequisites\n\n- An Agent Skills-compatible harness ([Claude Code](https://claude.ai/code) CLI/IDE, or OpenAI Codex CLI)\n- A project directory where you want the skill installed. Project-scope installs land at `.agents/skills/skill-frontend-excellence/`; user-scope installs (`--user`) land at `~/.agents/skills/skill-frontend-excellence/`. Discovery-mirror symlinks at `.claude/skills/` (and `~/.codex/skills/` at user scope) are created automatically so both harnesses find the skill without extra configuration.\n\n## Installation\n\n### Manual\n\n```bash\ngit clone https://github.com/ctxr-dev/skill-frontend-excellence.git /tmp/skill-frontend-excellence\nmkdir -p .agents/skills\ncp -r /tmp/skill-frontend-excellence .agents/skills/skill-frontend-excellence\n```\n\n### Git Submodule\n\n```bash\ngit submodule add https://github.com/ctxr-dev/skill-frontend-excellence.git \\\n    .agents/skills/skill-frontend-excellence\n```\n\nPins the skill at a specific commit; update explicitly via `git submodule update --remote`.\n\n## Usage\n\nAgent Skills-compatible harnesses (Claude Code, Codex CLI) surface this skill automatically based on the YAML frontmatter at the top of `SKILL.md`. The `description` field tells the host when to load it: any prompt that touches how an interface looks, feels, moves, loads, ranks, or is interacted with will trigger activation.\n\nWhen the skill is active, the host reads `SKILL.md` first (the entry point with the North Star Targets, priority stack, workflow, the Multi-Page Polish Loop, and the routing tables), then loads only the topical reference under `references/` that matches the current work. There is nothing to invoke manually; install the skill and proceed with the task.\n\nFor the canonical entry point, read [`SKILL.md`](SKILL.md).\n\n## What's Inside\n\n- [`SKILL.md`](SKILL.md): the entry point. North Star Targets, priority stack, conflict tie-breakers, the render-strategy decision, the routing tables (by task, by symptom, and the full Reference Index), the Multi-Page Polish Loop, and the self-improvement checklist.\n- `references/`: topical deep dives (Lighthouse, performance, accessibility, SEO, design, responsive, motion, forms, data-viz, components, security, testing, observability, auth, i18n, PWA, embed, print and email, and more), each carrying YAML frontmatter so a host loads only what the current task needs.\n- Index surfaces: [`references/quick-reference.md`](references/quick-reference.md) (the highest-leverage rules in one scan) and [`references/anti-patterns.md`](references/anti-patterns.md) (one row per anti-pattern with its standard fix).\n\nThe canonical, always-current list of every reference file and when to load it is the **Reference Index inside [`SKILL.md`](SKILL.md)**. This README intentionally does not duplicate it, to avoid drift.\n\n## North Star Targets\n\nEvery interface should meet these bars before being considered \"done\". Treat any failure as a blocking defect, not a polish task.\n\n| Category | Mobile target | Desktop target | Source |\n|----------|--------------|----------------|--------|\n| Lighthouse Performance | >= 95 | >= 99 | Lighthouse |\n| Lighthouse Accessibility | 100 | 100 | Lighthouse + axe |\n| Lighthouse Best Practices | 100 | 100 | Lighthouse |\n| Lighthouse SEO | 100 | 100 | Lighthouse |\n| Largest Contentful Paint (LCP) | < 2.5s | < 2.0s | Core Web Vitals |\n| Interaction to Next Paint (INP) | < 200ms | < 200ms | Core Web Vitals |\n| Cumulative Layout Shift (CLS) | < 0.1 | < 0.05 | Core Web Vitals |\n| Time to First Byte (TTFB) | < 800ms | < 600ms | Core Web Vitals |\n| First Contentful Paint (FCP) | < 1.8s | < 1.0s | Lighthouse |\n| Total Blocking Time (TBT) | < 200ms | < 100ms | Lighthouse |\n| Initial JS payload (gzipped) | < 90 KB | < 130 KB | Budget |\n| Initial CSS payload (gzipped) | < 25 KB | < 35 KB | Budget |\n| Web font payload (per screen) | <= 2 families, <= 4 weights | same | Budget |\n\nThese are the universal bar. A given project may consciously relax a budget for a specific surface (e.g., a heavily interactive client-rendered tool that legitimately ships more JS), but the relaxation should be a recorded, justified exception, not a default.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for local setup, editing conventions, and the strict style rules (framework-agnostic phrasing, generic placeholders, no em or en dashes).\n\n## Releasing\n\nReleases are PR-gated. Version bumps land on `main` through a review gate like any other change; only the tag push and npm publish are automated.\n\n1. **Actions, Release, Run workflow.** Branch selector: `main` (the workflow refuses any other ref). Version bump: `patch`, `minor`, or `major`.\n2. The workflow bumps `package.json` on a fresh `release/v<version>` branch and opens a release PR.\n3. Review and merge the PR (the diff is just version fields).\n4. On merge, `tag-on-main.yml` detects the version change, creates the annotated `v<version>` tag, and pushes it.\n5. The tag push triggers `publish.yml`, which runs validation, verifies tag/version agreement, and publishes to npm via OIDC trusted publishing.\n\nSee [GitHub Releases](https://github.com/ctxr-dev/skill-frontend-excellence/releases) for the changelog, and [CHANGELOG.md](CHANGELOG.md) for the in-repo history.\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}