@flitzrrr/frontend-design-skills 1.0.0

package/.aider/conventions.md

@@ -0,0 +1,47 @@
+# Frontend Design Skills — Aider Conventions
+
+This repository contains 21 opinionated web design skills from 12 curated sources.
+Each skill is a self-contained folder under `skills-src/` containing a `SKILL.md` file.
+
+## How to Use
+
+When a task involves web design, read the corresponding `SKILL.md`:
+
+```
+skills-src/<skill-name>/SKILL.md
+```
+
+## Skill Categories
+
+### Core Design
+- `skills-src/ui-design/SKILL.md` — Layout, grids, visual hierarchy, components
+- `skills-src/ux-design/SKILL.md` — User research, IA, interaction patterns
+
+### Typography, Color & Accessibility
+- `skills-src/web-typography/SKILL.md` — Font selection, pairing, fluid typography
+- `skills-src/color-theory/SKILL.md` — Color schemes, contrast, dark mode
+- `skills-src/accessibility/SKILL.md` — WCAG, BFSG, semantic HTML, ARIA
+
+### Implementation
+- `skills-src/usability/SKILL.md` — Heuristic evaluation, forms, conversion
+- `skills-src/responsive-design/SKILL.md` — Mobile-first, breakpoints, fluid grids
+- `skills-src/navigation-design/SKILL.md` — Menu patterns, breadcrumbs, IA
+- `skills-src/images-media/SKILL.md` — Image optimization, SVG, lazy loading
+- `skills-src/branding-identity/SKILL.md` — Brand strategy, corporate design
+
+### Strategy & Process
+- `skills-src/customer-journey/SKILL.md` — Personas, touchpoints, onboarding
+- `skills-src/design-process/SKILL.md` — Briefing, wireframing, prototyping
+- `skills-src/ai-design-workflow/SKILL.md` — AI/KI integration in design
+- `skills-src/landing-pages/SKILL.md` — Conversion structure, CTAs
+- `skills-src/website-audit/SKILL.md` — Site analysis, relaunch planning
+
+### Trends & Modern Patterns
+- `skills-src/design-trends/SKILL.md` — Award-winning patterns, motion, trends
+- `skills-src/ui-patterns/SKILL.md` — Hero, cards, navigation, pricing
+- `skills-src/visual-direction/SKILL.md` — Color/typography/layout trends
+- `skills-src/component-patterns/SKILL.md` — Compound components, tokens, theming
+- `skills-src/agent-ui-design/SKILL.md` — Chat interfaces, streaming UI, agent UX
+
+### Design Review
+- `skills-src/webdesign-review/SKILL.md` — Comprehensive review (orchestrates all 20 domain skills)

package/.cursorrules

@@ -0,0 +1,38 @@
+# Frontend Design Skills — Cursor Rules
+# This file makes skills discoverable in Cursor IDE.
+# For detailed skill usage, see individual SKILL.md files.
+
+## Available Skills (21 total from 12 sources)
+
+### Core Design
+- Use `skills-src/ui-design/SKILL.md` for layout, grids, visual hierarchy, components, whitespace
+- Use `skills-src/ux-design/SKILL.md` for user research, information architecture, interaction patterns
+
+### Typography, Color & Accessibility
+- Use `skills-src/web-typography/SKILL.md` for font selection, pairing, fluid typography, scales
+- Use `skills-src/color-theory/SKILL.md` for color schemes, 60-30-10, contrast, dark mode
+- Use `skills-src/accessibility/SKILL.md` for WCAG, BFSG, semantic HTML, ARIA, keyboard nav
+
+### Implementation
+- Use `skills-src/usability/SKILL.md` for heuristic evaluation, form design, conversion
+- Use `skills-src/responsive-design/SKILL.md` for mobile-first, breakpoints, fluid grids
+- Use `skills-src/navigation-design/SKILL.md` for menu patterns, breadcrumbs, IA
+- Use `skills-src/images-media/SKILL.md` for image optimization, WebP/AVIF, SVG, lazy loading
+- Use `skills-src/branding-identity/SKILL.md` for brand strategy, corporate design, tone of voice
+
+### Strategy & Process
+- Use `skills-src/customer-journey/SKILL.md` for personas, touchpoints, onboarding
+- Use `skills-src/design-process/SKILL.md` for briefing, wireframing, prototyping, handoff
+- Use `skills-src/ai-design-workflow/SKILL.md` for AI/KI integration in design workflow
+- Use `skills-src/landing-pages/SKILL.md` for conversion structure, CTAs, A/B testing
+- Use `skills-src/website-audit/SKILL.md` for site analysis, relaunch planning, SEO migration
+
+### Trends & Modern Patterns
+- Use `skills-src/design-trends/SKILL.md` for current award-winning patterns, motion, trends
+- Use `skills-src/ui-patterns/SKILL.md` for hero, cards, navigation, pricing, testimonials
+- Use `skills-src/visual-direction/SKILL.md` for color/typography/layout trend intelligence
+- Use `skills-src/component-patterns/SKILL.md` for compound components, design tokens, theming
+- Use `skills-src/agent-ui-design/SKILL.md` for chat interfaces, streaming UI, agent UX
+
+### Design Review
+- Use `skills-src/webdesign-review/SKILL.md` for comprehensive design review (orchestrates all skills)

package/.github/copilot-instructions.md

@@ -0,0 +1,47 @@
+# Frontend Design Skills — VS Code / GitHub Copilot
+
+This repository contains 21 opinionated web design skills from 12 sources.
+Each skill is a self-contained folder under `skills-src/` with a `SKILL.md` file.
+
+## How to Use Skills
+
+When a task involves web design, read the corresponding `SKILL.md`:
+
+```
+skills-src/<skill-name>/SKILL.md
+```
+
+## Key Skill Categories
+
+### Core Design
+- `skills-src/ui-design/` — Layout, grids, visual hierarchy, components
+- `skills-src/ux-design/` — User research, IA, interaction patterns
+
+### Typography, Color & Accessibility
+- `skills-src/web-typography/` — Font selection, pairing, fluid typography
+- `skills-src/color-theory/` — Color schemes, contrast, dark mode
+- `skills-src/accessibility/` — WCAG, BFSG, semantic HTML, ARIA
+
+### Implementation
+- `skills-src/usability/` — Heuristic evaluation, forms, conversion
+- `skills-src/responsive-design/` — Mobile-first, breakpoints, fluid grids
+- `skills-src/navigation-design/` — Menu patterns, breadcrumbs, IA
+- `skills-src/images-media/` — Image optimization, SVG, lazy loading
+- `skills-src/branding-identity/` — Brand strategy, corporate design
+
+### Strategy & Process
+- `skills-src/customer-journey/` — Personas, touchpoints, onboarding
+- `skills-src/design-process/` — Briefing, wireframing, prototyping
+- `skills-src/ai-design-workflow/` — AI/KI integration in design
+- `skills-src/landing-pages/` — Conversion structure, CTAs
+- `skills-src/website-audit/` — Site analysis, relaunch planning
+
+### Trends & Modern Patterns
+- `skills-src/design-trends/` — Award-winning patterns, motion, trends
+- `skills-src/ui-patterns/` — Hero, cards, navigation, pricing
+- `skills-src/visual-direction/` — Color/typography/layout trends
+- `skills-src/component-patterns/` — Compound components, tokens, theming
+- `skills-src/agent-ui-design/` — Chat interfaces, streaming UI, agent UX
+
+### Design Review
+- `skills-src/webdesign-review/` — Comprehensive review (orchestrates all 20 domain skills)

package/.lovable

@@ -0,0 +1,31 @@
+# Frontend Design Skills — Lovable Project Instructions
+# This file makes skills available in Lovable AI.
+
+This repository contains 21 opinionated web design skills from 12 curated sources,
+covering UI/UX, typography, color, accessibility, branding, and modern design trends.
+
+## How to Use
+
+Each skill is a self-contained folder under `skills-src/` containing a `SKILL.md` file
+with detailed instructions and a `references/` directory. When a task matches a skill's
+domain, read and follow the corresponding `SKILL.md`.
+
+## Key Skills for Lovable Projects
+
+### Web Development
+- `skills-src/ui-design/SKILL.md` — Layout, Raster, visuelle Hierarchie, Komponenten
+- `skills-src/ux-design/SKILL.md` — Nutzerforschung, Informationsarchitektur
+- `skills-src/responsive-design/SKILL.md` — Mobile-First, Breakpoints, Fluid Grids
+- `skills-src/component-patterns/SKILL.md` — Compound Components, Design Tokens, Theming
+- `skills-src/agent-ui-design/SKILL.md` — Chat-Interfaces, Streaming UI, Agent UX
+
+### Visual Design
+- `skills-src/web-typography/SKILL.md` — Schriftwahl, Paarung, Fluid Typography
+- `skills-src/color-theory/SKILL.md` — Farbschemata, 60-30-10, Dark Mode
+- `skills-src/visual-direction/SKILL.md` — Farbpaletten-Archetypen, Trends
+
+### Quality & Conversion
+- `skills-src/accessibility/SKILL.md` — WCAG, BFSG, semantisches HTML, ARIA
+- `skills-src/usability/SKILL.md` — Nielsen-Heuristiken, Formulardesign, Conversion
+- `skills-src/landing-pages/SKILL.md` — Conversion-Struktur, CTA, A/B-Testing
+- `skills-src/webdesign-review/SKILL.md` — Comprehensive design review (all 20 domains)

package/.windsurfrules

@@ -0,0 +1,38 @@
+# Frontend Design Skills — Windsurf Rules
+# This file makes skills discoverable in Windsurf.
+# For detailed skill usage, see individual SKILL.md files.
+
+## Available Skills (21 total from 12 sources)
+
+### Core Design
+- Use `skills-src/ui-design/SKILL.md` for layout, grids, visual hierarchy, components, whitespace
+- Use `skills-src/ux-design/SKILL.md` for user research, information architecture, interaction patterns
+
+### Typography, Color & Accessibility
+- Use `skills-src/web-typography/SKILL.md` for font selection, pairing, fluid typography, scales
+- Use `skills-src/color-theory/SKILL.md` for color schemes, 60-30-10, contrast, dark mode
+- Use `skills-src/accessibility/SKILL.md` for WCAG, BFSG, semantic HTML, ARIA, keyboard nav
+
+### Implementation
+- Use `skills-src/usability/SKILL.md` for heuristic evaluation, form design, conversion
+- Use `skills-src/responsive-design/SKILL.md` for mobile-first, breakpoints, fluid grids
+- Use `skills-src/navigation-design/SKILL.md` for menu patterns, breadcrumbs, IA
+- Use `skills-src/images-media/SKILL.md` for image optimization, WebP/AVIF, SVG, lazy loading
+- Use `skills-src/branding-identity/SKILL.md` for brand strategy, corporate design, tone of voice
+
+### Strategy & Process
+- Use `skills-src/customer-journey/SKILL.md` for personas, touchpoints, onboarding
+- Use `skills-src/design-process/SKILL.md` for briefing, wireframing, prototyping, handoff
+- Use `skills-src/ai-design-workflow/SKILL.md` for AI/KI integration in design workflow
+- Use `skills-src/landing-pages/SKILL.md` for conversion structure, CTAs, A/B testing
+- Use `skills-src/website-audit/SKILL.md` for site analysis, relaunch planning, SEO migration
+
+### Trends & Modern Patterns
+- Use `skills-src/design-trends/SKILL.md` for current award-winning patterns, motion, trends
+- Use `skills-src/ui-patterns/SKILL.md` for hero, cards, navigation, pricing, testimonials
+- Use `skills-src/visual-direction/SKILL.md` for color/typography/layout trend intelligence
+- Use `skills-src/component-patterns/SKILL.md` for compound components, design tokens, theming
+- Use `skills-src/agent-ui-design/SKILL.md` for chat interfaces, streaming UI, agent UX
+
+### Design Review
+- Use `skills-src/webdesign-review/SKILL.md` for comprehensive design review (orchestrates all skills)

package/AGENTS.md

@@ -0,0 +1,18 @@
+# Frontend Design Skills
+
+This repository contains 21 opinionated web design skills from 12 sources.
+Skills are located in the `skills-src/` directory — each contains a `SKILL.md` with instructions.
+
+## Available Skill Categories
+
+- **Meta**: `webdesign-review` — comprehensive design review orchestrating all domains
+- **Core Design**: `ui-design`, `ux-design` — layout, grids, hierarchy, IA, interaction
+- **Detail**: `web-typography`, `color-theory`, `accessibility` — fonts, color, WCAG/BFSG
+- **Implementation**: `usability`, `responsive-design`, `navigation-design`, `images-media`, `branding-identity`
+- **Strategy**: `customer-journey`, `design-process`, `ai-design-workflow`, `landing-pages`, `website-audit`
+- **Trends & Patterns**: `design-trends`, `ui-patterns`, `visual-direction`, `component-patterns`, `agent-ui-design`
+
+## Usage
+
+To use a skill, read the `SKILL.md` file in the corresponding `skills-src/<name>/` directory.
+For a comprehensive design review, start with `webdesign-review` which orchestrates all domain skills.

package/CLAUDE.md

@@ -0,0 +1,18 @@
+# Frontend Design Skills
+
+This repository contains 21 opinionated web design skills from 12 sources.
+Skills are located in the `skills-src/` directory — each contains a `SKILL.md` with instructions.
+
+## Available Skill Categories
+
+- **Meta**: `webdesign-review` — comprehensive design review orchestrating all domains
+- **Core Design**: `ui-design`, `ux-design` — layout, grids, hierarchy, IA, interaction
+- **Detail**: `web-typography`, `color-theory`, `accessibility` — fonts, color, WCAG/BFSG
+- **Implementation**: `usability`, `responsive-design`, `navigation-design`, `images-media`, `branding-identity`
+- **Strategy**: `customer-journey`, `design-process`, `ai-design-workflow`, `landing-pages`, `website-audit`
+- **Trends & Patterns**: `design-trends`, `ui-patterns`, `visual-direction`, `component-patterns`, `agent-ui-design`
+
+## Usage
+
+To use a skill, read the `SKILL.md` file in the corresponding `skills-src/<name>/` directory.
+For a comprehensive design review, start with `webdesign-review` which orchestrates all domain skills.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 flitzrrr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,265 @@
+# Frontend Design Skills
+
+[![npm version](https://img.shields.io/npm/v/@flitzrrr/frontend-design-skills?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@flitzrrr/frontend-design-skills)
+[![Skills](https://img.shields.io/badge/skills-21-blue?style=flat-square)](skills-src/)
+[![Domains](https://img.shields.io/badge/domains-19-green?style=flat-square)](spec/domains/)
+[![Platforms](https://img.shields.io/badge/platforms-9-orange?style=flat-square)](bin/cli.js)
+[![Sources](https://img.shields.io/badge/sources-12-purple?style=flat-square)](scripts/config.yaml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
+
+**21 opinionated web design skills** distilled from **12 curated sources** (809 pages, 8.1 MB). One build, every major AI coding tool.
+
+---
+
+## Quick Start
+
+```bash
+npx @flitzrrr/frontend-design-skills install
+```
+
+Detects installed platforms and provisions skills for each. Target a single platform with:
+
+```bash
+npx @flitzrrr/frontend-design-skills install <platform>
+```
+
+Where `<platform>` is one of: `claude-code`, `cursor`, `windsurf`, `lovable`, `codex`, `copilot`, `antigravity`, `opencode`, `aider`.
+
+<details>
+<summary>Manual setup (git clone)</summary>
+
+```bash
+git clone git@github.com:flitzrrr/frontend-design-skills.git
+cd frontend-design-skills
+
+# Symlink into target platform(s):
+ln -sf $(pwd)/skills-src/* ~/.copilot/skills/          # VS Code / GitHub Copilot
+ln -sf $(pwd)/skills-src/* ~/.codex/skills/             # Codex
+ln -sf $(pwd)/skills-src/* ~/.gemini/antigravity/skills/ # Antigravity
+ln -sf $(pwd)/skills-src/* ~/.config/opencode/skills/   # OpenCode
+```
+
+</details>
+
+<details>
+<summary>All CLI commands</summary>
+
+| Command | Description |
+| --- | --- |
+| `npx @flitzrrr/frontend-design-skills install` | Install for all detected platforms |
+| `npx @flitzrrr/frontend-design-skills install <platform>` | Install for a single platform |
+| `npx @flitzrrr/frontend-design-skills update` | Pull latest skills |
+| `npx @flitzrrr/frontend-design-skills list` | List all available skills |
+
+</details>
+
+---
+
+## Platform Support
+
+| Platform | Discovery Mechanism | Install Method |
+| --- | --- | --- |
+| Claude Code | `CLAUDE.md` (project-level) | `npx @flitzrrr/frontend-design-skills install claude-code` |
+| Cursor | `.cursorrules` (project-level) | `npx @flitzrrr/frontend-design-skills install cursor` |
+| Windsurf | `.windsurfrules` (project-level) | `npx @flitzrrr/frontend-design-skills install windsurf` |
+| Lovable | `.lovable` (project-level) | `npx @flitzrrr/frontend-design-skills install lovable` |
+| VS Code (GitHub Copilot) | `.github/copilot-instructions.md` + `~/.copilot/skills/` | `npx @flitzrrr/frontend-design-skills install copilot` |
+| Codex | `AGENTS.md` + `~/.codex/skills/` | `npx @flitzrrr/frontend-design-skills install codex` |
+| Antigravity (Gemini) | `~/.gemini/antigravity/skills/` | `npx @flitzrrr/frontend-design-skills install antigravity` |
+| OpenCode | `~/.config/opencode/skills/` | `npx @flitzrrr/frontend-design-skills install opencode` |
+| Aider | `.aider/conventions.md` | `npx @flitzrrr/frontend-design-skills install aider` |
+| Any agent | Read `skills-src/<name>/SKILL.md` directly | Manual |
+
+---
+
+## Skill Categories
+
+| Category | Skills | Focus |
+| --- | --- | --- |
+| Meta | `webdesign-review` | Orchestrates all 20 domain skills for comprehensive design reviews |
+| Core Design | `ui-design`, `ux-design` | Layout, grids, visual hierarchy, IA, interaction patterns |
+| Detail | `web-typography`, `color-theory`, `accessibility` | Font pairing, 60-30-10 rule, WCAG, BFSG compliance |
+| Implementation | `responsive-design`, `navigation-design`, `usability`, `images-media`, `branding-identity` | Mobile-first, menu patterns, forms, SVG, brand strategy |
+| Strategy | `customer-journey`, `design-process`, `ai-design-workflow`, `landing-pages`, `website-audit` | Personas, briefing, KI-workflow, conversion, relaunch |
+| Trends & Patterns | `design-trends`, `ui-patterns`, `visual-direction`, `component-patterns`, `agent-ui-design` | Award-winning patterns, Mobbin, Dribbble/Behance, 21st.dev |
+
+All skills are written in **German** (matching source material). Frontmatter names and descriptions are in English (per [Agent Skills spec](https://agentskills.io)).
+
+---
+
+## Sources
+
+| Tier | Source | Pages | Focus |
+| --- | --- | ---: | --- |
+| 1 (deep) | [webdesign-journal.de](https://www.webdesign-journal.de/) | 30 | UI/UX, typography, color, accessibility, branding, KI |
+| 1 (deep) | [21st.dev](https://21st.dev/) | 39 | Component patterns, Agents SDK, chat UI |
+| 2 (awards) | [Awwwards](https://www.awwwards.com/) | ~200 | Award-winning sites + their content |
+| 2 (awards) | [CSS Design Awards](https://www.cssdesignawards.com/) | 80 | Website of the Day winners |
+| 2 (awards) | [CSS Winner](https://www.csswinner.com/) | 60 | Award winners |
+| 3 (galleries) | [Godly](https://godly.website/) | 80 | Curated design gallery |
+| 3 (galleries) | [SiteInspire](https://www.siteinspire.com/) | 80 | Design inspiration |
+| 3 (galleries) | [Lapa.ninja](https://www.lapa.ninja/) | 80 | Landing page gallery |
+| 3 (galleries) | [Land-book](https://land-book.com/) | 30 | Design gallery |
+| 4 (community) | [Dribbble](https://dribbble.com/) | 25 | Trending shots |
+| 4 (community) | [Behance](https://www.behance.net/) | 20 | Trending projects |
+| 4 (community) | [Mobbin](https://mobbin.com/) | 6 | Real app UI patterns (public) |
+
+**809 pages** across 12 sources, synthesized into a **19-domain Enterprise Design Specification** (3,289 lines).
+
+---
+
+## Architecture
+
+```mermaid
+graph TD
+    subgraph Sources["12 Web Design Sources"]
+        T1["Tier 1: webdesign-journal.de + 21st.dev"]
+        T2["Tier 2: Awwwards + CSSDA + CSS Winner"]
+        T3["Tier 3: Godly + SiteInspire + Lapa.ninja + Land-book"]
+        T4["Tier 4: Dribbble + Behance + Mobbin"]
+    end
+
+    subgraph Scraping["Scraping & Diffing"]
+        S[scrape.py]
+        D[diff-content.py]
+        M[manifest.json]
+    end
+
+    subgraph Spec["Enterprise Design Specification"]
+        CM[content-map.json]
+        DS[19 Domain Files]
+    end
+
+    subgraph Skills["Canonical Skills"]
+        SK[21 SKILL.md + references/]
+    end
+
+    subgraph Build["Build Pipeline"]
+        B[build-skills.py]
+    end
+
+    subgraph Output["Tool-Specific Outputs"]
+        CC[Claude Code]
+        CU[Cursor]
+        WS[Windsurf]
+        GE[Gemini]
+        CO[Codex]
+        AI[Aider]
+    end
+
+    Sources --> S
+    S --> M
+    M --> D
+    D --> CM
+    CM --> DS
+    DS -->|"AI Synthesis"| SK
+    SK --> B
+    B --> CC
+    B --> CU
+    B --> WS
+    B --> GE
+    B --> CO
+    B --> AI
+```
+
+### Evolution Pipeline
+
+```mermaid
+sequenceDiagram
+    participant Cron as Weekly Cron
+    participant Scraper as scrape.py
+    participant Differ as diff-content.py
+    participant Map as content-map.json
+    participant Spec as spec/domains/*.md
+    participant Builder as build-skills.py
+    participant Output as output/
+
+    Cron->>Scraper: Trigger (Sundays 3am)
+
+    rect rgb(240, 245, 250)
+    Note over Scraper,Differ: Scrape & Diff Phase
+    Scraper->>Scraper: Crawl 12 sources (tiered)
+    Scraper->>Differ: Updated manifest.json
+    Differ->>Differ: Compare hashes, classify changes
+    Differ-->>Map: Change report (new/updated/removed)
+    end
+
+    rect rgb(250, 245, 240)
+    Note over Map,Spec: Domain Mapping Phase
+    Map->>Spec: Identify affected domains
+    Note right of Spec: AI synthesis required<br/>for spec updates
+    end
+
+    rect rgb(240, 250, 240)
+    Note over Builder,Output: Build Phase
+    Builder->>Output: Rebuild all 6 tool outputs
+    Note right of Output: claude-code, cursor,<br/>windsurf, gemini,<br/>codex, aider
+    end
+```
+
+---
+
+## Directory Structure
+
+```
+frontend-design-skills/
+  skills-src/               21 canonical skills (Agent Skills spec)
+    _template/              Skill authoring template
+    webdesign-review/       Meta-skill (orchestrates all domains)
+    ui-design/              ...through to...
+    agent-ui-design/        ...all 21 skill directories
+  spec/                     Enterprise Design Specification
+    design-spec.md          Master index (19 domains)
+    domains/                Per-domain spec files (01-19)
+    content-map.json        URL-to-domain mapping
+  tools/                    Cross-tool adapter system
+    adapters/               6 Python adapters + common.py
+    FORMAT-SPECS.md         Output format reference
+  scripts/                  Build and automation
+    build-skills.py         Canonical -> tool-specific outputs
+    validate-skills.py      Agent Skills spec validation
+    scrape.py               Tiered source scraper
+    diff-content.py         Content change detection
+    evolve.py               Evolution pipeline orchestrator
+    config.yaml             Source configuration (12 sources, 4 tiers)
+  data/                     Persistent scraping data
+    manifest.json           URL/hash/date index
+    changelog.md            Evolution log
+    scraped/                Raw markdown (gitignored)
+    versions/               Manifest snapshots for rollback
+  bin/                      CLI (npx)
+  output/                   Generated tool outputs (gitignored)
+  docs/                     Project documentation
+```
+
+### Skill Format
+
+Each skill follows the [Agent Skills](https://agentskills.io) specification:
+
+```
+skills-src/<name>/
+  SKILL.md          < 500 lines, YAML frontmatter (name, description)
+  references/       Detailed patterns, code examples, checklists
+```
+
+The build pipeline transforms this canonical format into tool-specific outputs via 6 adapters (Claude Code copies directly; Cursor generates `.mdc`; Windsurf/Gemini/Codex/Aider concatenate into single files with inlined references).
+
+### Naming Convention
+
+Skills are named by domain: `ui-design`, `web-typography`, `accessibility`. The meta-skill `webdesign-review` orchestrates all 20 domain skills for comprehensive design reviews.
+
+---
+
+## Validation
+
+```bash
+python3 scripts/validate-skills.py
+```
+
+Validates all 21 skills against the Agent Skills spec: frontmatter fields (`name`, `description`), naming conventions (lowercase-hyphen, max 64 chars), line limits (< 500), and directory-name consistency.
+
+---
+
+## License
+
+MIT -- applies to all code, skills, and documentation in this repository.