Skip to content

Agent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages

Clean up the repo: one skill, a cleaner README (#153)

Leonxlnx825e30649788
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index f0392aa..ac846fe 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -9,7 +9,7 @@
{
"name": "taste-skill",
"description": "tasteskill v2: art direction for websites, product pages, dashboards and app screens, with a library of researched directions, real pictures from open collections and a real-browser inspector.",
- "version": "2.1.2",
+ "version": "2.1.3",
"source": "./",
"skills": ["./skills/taste-skill"],
"author": {
@@ -20,29 +20,6 @@
"repository": "https://github.com/Leonxlnx/taste-skill",
"license": "MIT",
"keywords": ["skills", "frontend", "design", "taste", "ui", "dashboard"]
- },
- {
- "name": "taste-skill-classics",
- "description": "The classic taste-skill styles and earlier versions (soft, minimalist, brutalist, gpt-taste, Stitch, v1, v2-experimental). Opt-in: each runs only when called by name.",
- "version": "2.1.2",
- "source": "./",
- "skills": [
- "./skills/soft-skill",
- "./skills/minimalist-skill",
- "./skills/brutalist-skill",
- "./skills/gpt-tasteskill",
- "./skills/stitch-skill",
- "./skills/taste-skill-v1",
- "./skills/taste-skill-v2-experimental"
- ],
- "author": {
- "name": "leonxlnx",
- "email": "[email protected]"
- },
- "homepage": "https://github.com/Leonxlnx/taste-skill",
- "repository": "https://github.com/Leonxlnx/taste-skill",
- "license": "MIT",
- "keywords": ["skills", "frontend", "design", "styles"]
}
]
}
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index 9dba4bb..dab59d8 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,7 +1,7 @@
{
"name": "taste-skill",
- "version": "2.1.2",
- "description": "tasteskill v2: art direction for websites, product pages, dashboards and app screens, checked in a real browser. Classic styles included, opt-in.",
+ "version": "2.1.3",
+ "description": "tasteskill v2: art direction for websites, product pages, dashboards and app screens, checked in a real browser.",
"author": {
"name": "leonxlnx",
"url": "https://github.com/Leonxlnx"
@@ -20,7 +20,7 @@
"interface": {
"displayName": "Taste Skill",
"shortDescription": "Art direction for websites, dashboards and app screens.",
- "longDescription": "tasteskill v2 from Leonxlnx/taste-skill: researched directions, real pictures and a real-browser inspector for websites, product pages, dashboards and app screens. The classic style skills are included and run only when called by name.",
+ "longDescription": "tasteskill v2 from Leonxlnx/taste-skill: researched directions, real pictures and a real-browser inspector for websites, product pages, dashboards and app screens.",
"developerName": "leonxlnx",
"category": "Design",
"capabilities": [],
diff --git a/.github/workflows/check-skills.yml b/.github/workflows/check-skills.yml
index f9750a1..a3ccc92 100644
--- a/.github/workflows/check-skills.yml
+++ b/.github/workflows/check-skills.yml
@@ -17,7 +17,5 @@ jobs:
run: |
npm install --no-save --no-package-lock [email protected]
node tests/frontmatter.mjs
- - name: Skill registry
- run: bash tests/skill_test.sh
- name: Scripts parse
run: for f in skills/taste-skill/scripts/*.mjs skills/taste-skill/scripts/lib/*.mjs skills/taste-skill/assets/*.js; do node --check "$f" || exit 1; done
diff --git a/CHANGELOG.md b/CHANGELOG.md
index d55b330..db5aa44 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,16 @@ All notable changes to taste-skill live here. The repo follows SemVer-ish discip
---
+## 2.1.3 - 2026-10-19
+
+One repo, one skill. Nothing in `design-taste-frontend` changed.
+
+- **The classic skills moved** to their own repo, [Leonxlnx/taste-skill-classics](https://github.com/Leonxlnx/taste-skill-classics): `high-end-visual-design`, `minimalist-ui`, `industrial-brutalist-ui`, `gpt-taste`, `stitch-design-taste`, `design-taste-frontend-v1` and `design-taste-frontend-v2-experimental`. Same install names, same files. The `taste-skill-classics` Claude Code plugin moved with them (`/plugin marketplace add Leonxlnx/taste-skill-classics`).
+- **The pointer folders are gone:** `brandkit`, `image-to-code`, `imagegen-frontend-web` and `imagegen-frontend-mobile` (in [Leonxlnx/imagegen-skills](https://github.com/Leonxlnx/imagegen-skills) since 2.1.1) and `redesign-existing-projects` (part of `design-taste-frontend` since 2.1.1). The README lists where every old install name lives now.
+- **Removed:** `research/laziness/` (it belonged to `full-output-enforcement`, removed in 2.1.1), the outdated `skills/llms.txt`, `skill.sh` and its test, and unused images.
+- **README:** a wordmark instead of the banner, a TasteCode banner that stands out in dark mode, fewer badges, the community sponsors always shown.
+- The Codex plugin loads only `design-taste-frontend` now.
+
## 2.1.2 - 2026-10-19
- **Fix: `design-taste-frontend` did not load in Claude Code** ([#151](https://github.com/Leonxlnx/taste-skill/issues/151)). The description added in 2.1.0 contained an unquoted `: `, so its YAML frontmatter failed to parse and the skill was silently dropped ("Unknown skill"). It is now a folded block scalar.
diff --git a/README.md b/README.md
index 2da597c..8efa355 100644
--- a/README.md
+++ b/README.md
@@ -1,34 +1,32 @@
<p align="center">
- <img src="assets/readme-banner.webp" alt="Taste Skill - Anti-slop Agent Skills for premium frontends" width="100%" />
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="assets/taste-skill-wordmark-dark.png" />
+ <img src="assets/taste-skill-wordmark.png" alt="Taste Skill" width="340" />
+ </picture>
</p>
-<p align="center" style="margin-bottom: 8px;">
+<p align="center">
<a href="https://tasteskill.dev" title="Visit tasteskill.dev"><img src="https://img.shields.io/badge/website-tasteskill.dev-24292f?style=flat" alt="Visit tasteskill.dev" /></a>
&nbsp;
<a href="https://tastecode.dev" title="Visit tastecode.dev"><img src="https://img.shields.io/badge/new-TasteCode-ff6b00?style=flat" alt="New: TasteCode" /></a>
&nbsp;
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-24292f?style=flat&amp;logo=github&amp;logoColor=white" alt="MIT License" /></a>
&nbsp;
- <a href="https://github.com/vercel-labs/agent-skills"><img src="https://img.shields.io/badge/Agent_Skills-compatible-24292f?style=flat&amp;logo=github&amp;logoColor=white" alt="Agent Skills compatible" /></a>
- &nbsp;
- <a href="#install"><img src="https://img.shields.io/badge/Codex_%2F_Cursor_%2F_Claude-install-24292f?style=flat" alt="Codex, Cursor, Claude" /></a>
- &nbsp;
<a href="CHANGELOG.md"><img src="https://img.shields.io/badge/changelog-view-24292f?style=flat" alt="Changelog" /></a>
</p>
<p align="center">
- <a href="https://tastecode.dev"><img src="assets/readme-tastecode.webp" alt="TasteCode is here. Taste Skill as a desktop app, with a design agent built in. Free and open source. Download at tastecode.dev" width="100%" /></a>
+ <a href="https://tastecode.dev">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="assets/readme-tastecode-dark.webp" />
+ <img src="assets/readme-tastecode.webp" alt="TasteCode is here. Taste Skill as a desktop app, with a design agent built in. Free and open source. Download at tastecode.dev" width="100%" />
+ </picture>
+ </a>
</p>
-<p align="center"><sub>The easiest way to get Taste Skill results: <a href="https://tastecode.dev"><strong>download TasteCode</strong></a>. Its design agent briefs, builds and visually reviews your UI. <a href="https://github.com/Leonxlnx/tastecode">Source on GitHub</a>.</sub></p>
-
<h3 align="center">Sponsors</h3>
<table align="center">
- <tr>
- <td align="center" width="104"><a href="https://fluxionai.space/register?source=github&amp;campaign=github-tasteskill&amp;promo=TASTESKILL"><img src="assets/sponsors/sidrune-ai.png" alt="Sidrune AI" width="80" height="80" /></a></td>
- <td><sub><a href="https://fluxionai.space/register?source=github&amp;campaign=github-tasteskill&amp;promo=TASTESKILL"><strong>Sidrune AI</strong></a>: one API for GPT, Claude, and other leading AI models.<br />Sign up through this link and get $3 in API credit.</sub></td>
- </tr>
<tr>
<td align="center" width="104">
<a href="https://interfaces.dev/?utm_source=tasteskill&utm_medium=sponsorship">
@@ -60,7 +58,7 @@
<p align="center"><sub><a href="https://github.com/sponsors/Leonxlnx">Become a sponsor</a></sub></p>
-**Taste Skill** is a set of Agent Skills that make coding agents design websites instead of assembling the average landing page. The default skill gives the agent an art direction, real pictures and a way to check its own work in a real browser.
+**Taste Skill** is an Agent Skill that makes coding agents design websites and app screens instead of assembling the average landing page. It gives the agent an art direction, real pictures and a way to check its own work in a real browser.
Pages it has built, each from one brief:
@@ -77,17 +75,15 @@ Pages it has built, each from one brief:
The photographs are real, found in open archives and credited by the skill ([credits](examples/v2/CREDITS.md)). Watch the [launch film](https://github.com/Leonxlnx/taste-skill/releases/tag/v2.0.0).
-<p align="center"><sub><a href="#install">Install</a> · <a href="#how-v2-works">How it works</a> · <a href="#skills">Skills</a> · <a href="#common-questions">FAQ</a> · <a href="#support-the-project">Sponsors</a> · <a href="#license">License</a></sub></p>
-
## Install
```bash
npx skills add https://github.com/Leonxlnx/taste-skill --skill "design-taste-frontend"
```
-That installs the skill with the [`npx skills`](https://github.com/vercel-labs/agent-skills) CLI. Without `--skill` you also get the [classic skills](#classic-skills), which stay out of the way: they run only when you call them by name.
+That installs the skill with the [`npx skills`](https://github.com/vercel-labs/agent-skills) CLI.
-The default skill runs its scripts with **Node 22+** and an installed **Chrome, Edge or Chromium**. It installs nothing and needs no API keys. Finding pictures needs network access.
+The skill runs its scripts with **Node 22+** and an installed **Chrome, Edge or Chromium**. It installs nothing and needs no API keys. Finding pictures needs network access.
<details>
<summary>Claude Code plugin</summary>
@@ -99,7 +95,7 @@ Run these inside Claude Code. The skill is namespaced under `taste-skill:`, so i
/plugin install taste-skill@taste-skill
```
-`/plugin update` upgrades it later. The classic skills are a separate plugin, `taste-skill-classics@taste-skill`, if you want them.
+`/plugin update` upgrades it later.
</details>
@@ -111,22 +107,22 @@ codex plugin marketplace add Leonxlnx/taste-skill
codex plugin add taste-skill@taste-skill
```
-Start a new Codex session afterwards so the skills are loaded.
+Start a new Codex session afterwards so the skill is loaded.
</details>
<details>
<summary>From a clone, linked instead of copied</summary>
-`./install.sh design-taste-frontend` symlinks the skill into Claude Code (`--codex` for Codex, `--all-agents` for both), so a `git pull` updates it in place. `./install.sh --list` shows every install name.
+`./install.sh` symlinks the skill into Claude Code (`--codex` for Codex, `--all-agents` for both), so a `git pull` updates it in place.
</details>
-Already have the skill? Run the install command again. The install name did not change, and the older versions stay available under their own names (see [Classic skills](#classic-skills)).
+Already have the skill? Run the install command again; the install name did not change. Looking for one of the older skills? See [Moved skills](#moved-skills).
## How v2 works
-The default skill is built from a study of 247 curated sites. A build runs in six steps:
+The skill is built from a study of 247 curated sites. A build runs in six steps:
1. Reads the brief and lists what only this client has.
2. A script deals three of 20 researched directions and the agent picks one.
@@ -141,44 +137,26 @@ Dashboards and app screens (v2.1) take their own route: the skill deals one of t
v2.1 also checks the frame of every page (a clear title on the first screen, equal margins, no section shoved to one side, no random blank stretches) and moves the way strong award sites do, measured on the latest 100 Awwwards Sites of the Day.
-## Skills
-
-| Skill | Install name | What it does |
-| --- | --- | --- |
-| **[taste-skill](skills/taste-skill/SKILL.md)** | `design-taste-frontend` | Art direction for landing pages, marketing sites, portfolios, product pages, dashboards and app screens, in any stack. New builds, redesigns and reviews of existing pages. Works as described above. |
+## Moved skills
-Want design images first and code second? The image-generation skills (`imagegen-frontend-web`, `imagegen-frontend-mobile`, `brandkit`, `image-to-code`) now live in their own repo: **[Leonxlnx/imagegen-skills](https://github.com/Leonxlnx/imagegen-skills)**. Same install names.
+This repo holds one skill, `design-taste-frontend`. The others moved to repos of their own and kept their install names:
-### Classic skills
+| Install name | Where it lives now |
+| --- | --- |
+| `high-end-visual-design`, `minimalist-ui`, `industrial-brutalist-ui`, `gpt-taste`, `stitch-design-taste`, `design-taste-frontend-v1`, `design-taste-frontend-v2-experimental` | **[Leonxlnx/taste-skill-classics](https://github.com/Leonxlnx/taste-skill-classics)** |
+| `imagegen-frontend-web`, `imagegen-frontend-mobile`, `brandkit`, `image-to-code` | **[Leonxlnx/imagegen-skills](https://github.com/Leonxlnx/imagegen-skills)** |
+| `redesign-existing-projects` | Part of `design-taste-frontend`, which audits an existing page in a real browser before changing anything |
+| `full-output-enforcement` | Removed. For the same problem, see **[Leonxlnx/unlazy](https://github.com/Leonxlnx/unlazy)** |
-The skills this repo shipped before v2, kept for projects that depend on them. They are opt-in: an agent never picks one by itself, it runs only when you call it by name (`/high-end-visual-design` in Claude Code, `$minimalist-ui` in Codex).
-
-<details>
-<summary>Classic skills (7)</summary>
-
-| Skill | Install name | What it is |
-| --- | --- | --- |
-| **[soft-skill](skills/soft-skill/SKILL.md)** | `high-end-visual-design` | Calm, polished UI: soft contrast, whitespace, spring motion. |
-| **[minimalist-skill](skills/minimalist-skill/SKILL.md)** | `minimalist-ui` | Editorial product UI with a restrained palette and crisp structure. |
-| **[brutalist-skill](skills/brutalist-skill/SKILL.md)** | `industrial-brutalist-ui` | Hard mechanical language: Swiss type, sharp contrast, experimental layout. |
-| **[gpt-tasteskill](skills/gpt-tasteskill/SKILL.md)** | `gpt-taste` | A stricter variant for GPT and Codex: more layout variance, stronger motion direction. |
-| **[stitch-skill](skills/stitch-skill/SKILL.md)** | `stitch-design-taste` | Rules for Google Stitch, with an optional `DESIGN.md` export. |
-| **[taste-skill-v2-experimental](skills/taste-skill-v2-experimental/SKILL.md)** | `design-taste-frontend-v2-experimental` | The single-file, dial-driven rewrite that was the default before v2. |
-| **[taste-skill-v1](skills/taste-skill-v1/SKILL.md)** | `design-taste-frontend-v1` | The original. |
+Install a moved skill from its new repo under the same name:
```bash
-npx skills add https://github.com/Leonxlnx/taste-skill --skill "high-end-visual-design"
+npx skills add https://github.com/Leonxlnx/taste-skill-classics --skill "high-end-visual-design"
```
-The two older versions of taste-skill have three 1 to 10 dials at the top of the file: **DESIGN_VARIANCE** (centred and clean to asymmetric), **MOTION_INTENSITY** (hover only to scroll-driven) and **VISUAL_DENSITY** (spacious to dense). v2 has no dials. Its direction comes from the draw and its limits from the inspector.
-
-</details>
-
-`redesign-existing-projects` is retired: redesigns and reviews are part of taste-skill, which audits the existing page in a real browser before changing anything. `full-output-enforcement` is gone.
-
## Common Questions
-**What does the default skill need?**
+**What does the skill need?**
Node 22 or newer and Chrome, Edge or Chromium. It installs nothing and uses no API keys. It needs the internet only to find pictures.
**Where do the pictures come from, and can I use them?**
@@ -209,9 +187,9 @@ If Taste Skill helps you, consider sponsoring:
</tr>
</table>
-<details>
-<summary>Community sponsors</summary>
+### Community Sponsors
+<p>
<a href="https://github.com/dnakov"><img src="https://github.com/dnakov.png" width="40" height="40" style="border-radius:50%" alt="dnakov" title="dnakov" /></a>
<a href="https://github.com/AkramReshad"><img src="https://github.com/AkramReshad.png" width="40" height="40" style="border-radius:50%" alt="AkramReshad" title="AkramReshad" /></a>
<a href="https://github.com/ajmalaksar25"><img src="https://github.com/ajmalaksar25.png" width="40" height="40" style="border-radius:50%" alt="ajmalaksar25" title="ajmalaksar25" /></a>
@@ -235,6 +213,7 @@ If Taste Skill helps you, consider sponsoring:
<a href="https://github.com/AnthonyLiuVa"><img src="https://github.com/AnthonyLiuVa.png" width="40" height="40" style="border-radius:50%" alt="AnthonyLiuVa" title="AnthonyLiuVa" /></a>
<a href="https://github.com/Wolfy18"><img src="https://github.com/Wolfy18.png" width="40" height="40" style="border-radius:50%" alt="Wolfy18" title="Wolfy18" /></a>
<a href="https://github.com/Gigslol"><img src="https://github.com/Gigslol.png" width="40" height="40" style="border-radius:50%" alt="Gigslol" title="Gigslol" /></a>
+</p>
<p align="center">
<a href="https://www.star-history.com/leonxlnx/taste-skill">
@@ -246,8 +225,6 @@ If Taste Skill helps you, consider sponsoring:
</a>
</p>
-</details>
-
<sub>Feedback: open an issue or pull request, DM [@lexnlin](https://x.com/lexnlin) or [@blueemi99](https://x.com/blueemi99), or email [[email protected]](mailto:[email protected]).</sub>
<sub>Taste Skill has no official token, coin, or crypto project. Any token using my name, image, or project is unaffiliated and not endorsed by me.</sub>
diff --git a/assets/readme-banner.webp b/assets/readme-banner.webp
deleted file mode 100644
index 997611a..0000000
Binary files a/assets/readme-banner.webp and /dev/null differ
diff --git a/assets/readme-tastecode-dark.webp b/assets/readme-tastecode-dark.webp
new file mode 100644
index 0000000..feb4ff5
Binary files /dev/null and b/assets/readme-tastecode-dark.webp differ
diff --git a/assets/sponsors/animations-dev.webp b/assets/sponsors/animations-dev.webp
deleted file mode 100644
index c101842..0000000
Binary files a/assets/sponsors/animations-dev.webp and /dev/null differ
diff --git a/assets/sponsors/emil-animations-dev.webp b/assets/sponsors/emil-animations-dev.webp
deleted file mode 100644
index 9ce57f9..0000000
Binary files a/assets/sponsors/emil-animations-dev.webp and /dev/null differ
diff --git a/assets/taste-skill-logo.png b/assets/taste-skill-logo.png
deleted file mode 100644
index c5e8bd8..0000000
Binary files a/assets/taste-skill-logo.png and /dev/null differ
diff --git a/assets/taste-skill-logo.webp b/assets/taste-skill-logo.webp
deleted file mode 100644
index f1eb55c..0000000
Binary files a/assets/taste-skill-logo.webp and /dev/null differ
diff --git a/assets/taste-skill-wordmark-dark.png b/assets/taste-skill-wordmark-dark.png
new file mode 100644
index 0000000..5ed03e0
Binary files /dev/null and b/assets/taste-skill-wordmark-dark.png differ
diff --git a/assets/taste-skill-wordmark.png b/assets/taste-skill-wordmark.png
new file mode 100644
index 0000000..a62a052
Binary files /dev/null and b/assets/taste-skill-wordmark.png differ
diff --git a/research/README.md b/research/README.md
deleted file mode 100644
index 3436417..0000000
--- a/research/README.md
+++ /dev/null
@@ -1,8 +0,0 @@
-# Research
-
-Background research that informed the skills in this project. Each topic gets its own subfolder.
-
-## Topics
-
-### [LLM Laziness](laziness/)
-Why AI models produce incomplete outputs (placeholder code, truncated responses, skipped sections) and documented techniques to prevent it. Covers root causes, parameter fixes, prompt techniques, and experiment data.
diff --git a/research/laziness/README.md b/research/laziness/README.md
deleted file mode 100644
index bfea0a5..0000000
--- a/research/laziness/README.md
+++ /dev/null
@@ -1,25 +0,0 @@
-# LLM Output Truncation Research
-
-A structured analysis of why large language models produce incomplete outputs, and documented methods to restore full-fidelity generation. All findings are drawn from controlled experiments, published studies, and field-tested engineering practices.
-
-## Directory Structure
-
-### Root Causes
-Analysis of the economic, architectural, and behavioral mechanisms that drive output truncation in production LLMs.
-
-- [RLHF and Compute Economics](root-causes/rlhf-and-compute.md) — How reinforcement learning and cost optimization create systematic brevity bias.
-- [Training Data Bias](root-causes/training-data-bias.md) — How placeholder patterns in human-written code propagate into model outputs.
-- [Cognitive Shortcuts](root-causes/cognitive-shortcuts.md) — Empirical evidence of models taking shortcuts on complex or lengthy tasks.
-- [Output Limits](root-causes/output-limits.md) — Context window asymmetry and consumer-tier truncation mechanisms.
-
-### Remediation
-Documented techniques for overriding default truncation behavior, ordered from parameter-level fixes to full architectural solutions.
-
-- [Parameter Tuning](remediation/parameter-tuning.md) — Temperature, Top-p, and Gemini thinking-level configuration.
-- [Prompt Engineering](remediation/prompt-engineering.md) — Structural prompt techniques: syntax binding, XML frameworks, and verification loops.
-- [Architectural Patterns](remediation/architectural-patterns.md) — MCP integration, lazy-loaded skills, and developer platform access.
-- [Reference Prompts](remediation/reference-prompts.md) — Ready-to-use prompt templates for enforcing complete outputs.
-
-### Findings
-- [Empirical Results](findings/empirical-results.md) — Controlled experiment data from 2025 academic studies.
-- [References](findings/references.md) — Cited studies and further reading.
diff --git a/research/laziness/findings/empirical-results.md b/research/laziness/findings/empirical-results.md
deleted file mode 100644
index 5023f3e..0000000
--- a/research/laziness/findings/empirical-results.md
+++ /dev/null
@@ -1,58 +0,0 @@
-# Empirical Results
-
-## 2025 Controlled Experiments
-
-A controlled study published in December 2025 measured output truncation across several frontier models, including GPT-4 variants and DeepSeek. Three experiments were conducted:
-
-### Experiment A: Multi-Part Instruction Compliance
-
-Models were given complex prompts with multiple explicit requirements (formatting constraints, length requirements, mandatory sections). Results:
-
-- No model fully satisfied both length requirements and all sub-part instructions natively
-- Models frequently omitted mandatory output sections
-- Required formatting constraints were routinely skipped
-- Explicit length requirements were consistently undershot
-
-### Experiment B: Decoding Suboptimality
-
-Tested whether truncated outputs resulted from suboptimal token selection (the model "knowing" the right answer but selecting a worse token). Results:
-
-- Limited evidence of decoding suboptimality on simple reasoning tasks
-- The model's greedy, truncated output generally aligned with its highest-confidence solution
-- Truncation is a deliberate behavioral choice, not a decoding failure
-
-### Experiment C: Context Degradation
-
-Tested whether models lose track of instructions during long, multi-turn conversations. Results:
-
-- Surprising resilience against context degradation during 200-turn conversational tests
-- Models maintained key facts and instructions significantly better than hypothesized
-- Context loss is not the primary cause of truncation
-
-### Key Conclusion
-
-Laziness is not a failure of memory, context processing, or core model capabilities. It is a behavioral artifact triggered by:
-1. Instruction complexity exceeding internal effort thresholds
-2. Aggressively calibrated stopping pressure
-3. Economic constraints embedded in the alignment layer
-
-## Prompt Stimulus Effectiveness (Microsoft Research)
-
-Controlled testing of psychological prompt stimuli documented in a Microsoft Research study:
-
-| Stimulus | Measured Effect |
-|:---|:---|
-| Financial incentive framing ("$200 tip") | +45% output quality and length |
-| Step-by-step instruction ("take a deep breath") | Accuracy: 34% to 80% on logic tasks |
-| Stakes framing ("critical to my career") | +10% average performance |
-| Combined (multiple stimuli) | Up to +115% overall performance |
-
-These effects are reproducible and stem from statistical correlations in the training data between stakes language and high-effort human outputs.
-
-## Seasonal Output Variation
-
-Statistical analysis of ChatGPT outputs during November-December 2023 versus January-March 2024 confirmed:
-
-- Measurable decrease in average output length during December
-- Correlation with reduced work output in the training data during holiday periods
-- Output length increased when the system prompt explicitly stated a non-winter month
diff --git a/research/laziness/findings/references.md b/research/laziness/findings/references.md
deleted file mode 100644
index fe0f291..0000000
--- a/research/laziness/findings/references.md
+++ /dev/null
@@ -1,20 +0,0 @@
-# References
-
-## Cited Studies
-
-- **EmotionPrompt (Microsoft Research)** — Demonstrates that emotional and stakes-based prompt framing mathematically improves LLM reasoning quality and output length. Documents the +45% improvement from financial framing and +115% from combined stimuli.
-
-- **LazyBench** — Proves that frontier models (Gemini 1.5 Pro, GPT-4o) actively select cognitive shortcuts and fail tasks they are capable of solving when the perceived effort exceeds internal thresholds.
-
-- **Compounding Error Avoidance** — Research demonstrating that models truncate outputs as a risk mitigation strategy, preferring shorter responses to reduce the surface area for factual errors on long-form tasks.
-
-- **Seasonal Behavior Analysis (Winter Break Hypothesis)** — Statistical analysis confirming that LLMs internalize seasonal work patterns from training data, producing measurably shorter outputs during periods corresponding to human holiday seasons.
-
-- **2025 Controlled Laziness Experiments** — Three-part academic study (December 2025) confirming that output truncation is a behavioral artifact of alignment training, not a failure of context processing or model capability.
-
-## Further Reading
-
-- Google Gemini API documentation on `thinking_level` parameter configuration
-- Anthropic MCP (Model Context Protocol) specification and integration guides
-- OpenAI API reference for temperature and Top-p parameter tuning
-- YAML front-matter specification for SKILL.md lazy-loading architecture
diff --git a/research/laziness/remediation/architectural-patterns.md b/research/laziness/remediation/architectural-patterns.md
deleted file mode 100644
index eb58186..0000000
--- a/research/laziness/remediation/architectural-patterns.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# Architectural Patterns
-
-## Lazy-Loaded Skills
-
-The standard pattern for managing large context requirements across AI agents is lazy-loaded prompt engineering through skill files.
-
-A skill is a folder containing a `SKILL.md` file with:
-
-- **YAML front-matter:** Contains `name` and a precise `description`. This metadata acts as the discovery hook — the agent reads only this during initialization (~100 tokens per skill).
-- **Markdown body:** Full workflows, rules, and instructions. Loaded on-demand only when the agent determines the skill is relevant.
-
-This architecture yields a documented 35% reduction in average context usage and prevents context dilution. However, discovery reliability depends on the specificity of the YAML description:
-
-| Description Quality | Discovery Success Rate |
-|:---|:---:|
-| Vague ("Helps with designing APIs") | ~68% |
-| Specific ("Design RESTful HTTP APIs with OpenAPI specs, focusing on versioning, error codes, and backward compatibility") | ~90% |
-
-## Model Context Protocol (MCP)
-
-MCP is an open standard (pioneered by Anthropic, adopted by Google and OpenAI) that enables real-time, bidirectional connections between LLMs and external data sources.
-
-### Architecture Components
-
-- **Host:** The AI application (IDE, terminal tool, chatbot) containing the LLM engine.
-- **Client:** Internal bridge within the host that handles protocol communication.
-- **Server:** External service exposing databases, APIs, or documentation to the client.
-- **Transport:** JSON-RPC 2.0 messages over stdio (local) or HTTP (remote).
-
-### How It Reduces Truncation
-
-Without MCP, models rely on static training weights for factual claims. When those weights are outdated (e.g., a new API version was released after training cutoff), the model either hallucinates a plausible answer or truncates its response to avoid committing to specifics.
-
-With MCP, the model fetches current documentation directly into its context window. This transforms the model from a static knowledge store into a reasoning engine operating on real-time data, eliminating the incentive to hallucinate or truncate.
-
-### Example: Developer Knowledge API
-
-Google's Developer Knowledge MCP Server indexes live documentation across Firebase, Android, and Google Cloud. When a model receives a development question:
-
-1. It executes a `search_document` query against the live index
-2. It evaluates returned page URIs
-3. It fetches full document content via `get_document` or `batch_get_documents`
-4. It generates its response based on current, authoritative documentation
-
-This entirely bypasses the tendency to fabricate answers from outdated training data.
-
-## Chunked Task Execution
-
-For complex tasks that would produce outputs exceeding the model's generation limit, break the work into sequential steps:
-
-1. Request the architecture and structure first (outline only)
-2. Request each component individually with explicit instructions for completeness
-3. Request assembly and integration after all components are generated
-
-This prevents the model from attempting to estimate total output length and preemptively compressing its response.
diff --git a/research/laziness/remediation/parameter-tuning.md b/research/laziness/remediation/parameter-tuning.md
deleted file mode 100644
index 5bf2a25..0000000
--- a/research/laziness/remediation/parameter-tuning.md
+++ /dev/null
@@ -1,44 +0,0 @@
-# Parameter Tuning
-
-## Temperature and Top-p
-
-Autoregressive models select each next token from a probability distribution generated by a softmax function applied to logit values. When a model defaults to brief outputs, the tokens associated with truncation and summarization have been assigned the highest probabilities through RLHF alignment.
-
-### Temperature
-
-Adjusting the temperature parameter changes how the softmax function distributes probability mass across candidate tokens.
-
-- **Low temperature (0.0 - 0.5):** Amplifies differences between high and low-probability tokens. The model becomes highly deterministic, consistently selecting the highest-confidence continuation. Optimal for code generation, data extraction, and structured output.
-- **Default temperature (1.0):** Retains the original probability distribution from training.
-- **High temperature (1.5+):** Flattens the distribution, introducing more randomness. Useful for creative tasks but increases the risk of incoherent outputs.
-
-Example probability distribution shift for a single token position:
-
-| Token Candidate | Probability at Temp 1.5 | Probability at Temp ~0.0 | Raw Logit |
-|:---|:---:|:---:|:---:|
-| lazy | 0.4875 | 0.9933 | 2.0 |
-| quick | 0.2503 | 0.0067 | 1.0 |
-| tired | 0.1285 | 0.0000 | 0.0 |
-| slow | 0.0660 | 0.0000 | -1.0 |
-| clumsy | 0.0339 | 0.0000 | -2.0 |
-
-### Top-p (Nucleus Sampling)
-
-Top-p truncates the probability distribution by only considering the smallest set of tokens whose cumulative probability exceeds threshold p. A Top-p of 0.0 to 0.6 combined with low temperature forces the model into a narrow, deterministic execution path, reducing the entropy that enables creative refusals and unnecessary summarization.
-
-## Gemini Thinking Level Configuration
-
-Google Gemini 3 models replaced the legacy `thinking_budget` (a hard token count cap on internal reasoning) with a `thinking_level` parameter that provides relative guidance on computational depth.
-
-| Setting | Flash Support | Pro Support | Use Case |
-|:---|:---:|:---:|:---|
-| `minimal` | Yes | No | High-throughput, low-latency tasks |
-| `low` | Yes | Yes | Simple instruction following, data extraction |
-| `medium` | Yes | Yes (3.1 Pro) | Moderate complexity tasks |
-| `high` | Yes (Default) | Yes (Default) | Complex analysis, code generation, mathematics |
-
-Important constraints:
-- `thinking_level` and `thinking_budget` are mutually exclusive. Using both in one API call triggers an HTTP 400 error.
-- Even at `low`, Gemini Pro models perform mandatory minimum internal deliberation for safety and alignment.
-- For code generation and complex analysis, set to `medium` or `high` for quality scores consistently exceeding 92-95% compared to baseline.
-- Avoid combining extremely low temperature with `high` thinking level, as this can occasionally induce internal reasoning loops.
diff --git a/research/laziness/remediation/prompt-engineering.md b/research/laziness/remediation/prompt-engineering.md
deleted file mode 100644
index 9f3704b..0000000
--- a/research/laziness/remediation/prompt-engineering.md
+++ /dev/null
@@ -1,52 +0,0 @@
-# Prompt Engineering Techniques
-
-## Psychological Pattern Matching
-
-LLMs do not have emotions or understand monetary incentives. However, specific linguistic patterns in the prompt activate different quality distributions in the model's latent space. Research has documented measurable effects:
-
-| Technique | Documented Effect |
-|:---|:---|
-| "I will tip you $200 for a perfect solution" | Up to 45% increase in output quality and length |
-| "Take a deep breath and solve step by step" | Accuracy improvement from 34% to 80% on logic tasks |
-| "This task is critical to my career" | Average 10% performance increase |
-
-These phrases work because they are statistically correlated with high-effort, rigorously reviewed content in the training data (academic papers, enterprise codebases, legal documents). The attention mechanism prioritizes the high-quality data distributions associated with these patterns.
-
-## Explicit Syntax Binding
-
-Conversational requests allow the model to exercise discretion about output length and detail. Structural binding removes this discretion by explicitly prohibiting truncation patterns.
-
-Effective binding requires two components:
-
-1. **Mandatory tool execution:** Forbid the model from generating answers solely from training weights. Require it to execute search, computation, or code before answering.
-2. **Evidence blocks:** Require the model to output raw data (URLs, code execution results, data fragments) before producing its narrative response. This forces the model to read its own retrieved evidence, reducing hallucination probability to near zero.
-
-## XML-Structured Prompts
-
-Enterprise systems use strict XML tagging to separate prompt components, reducing the cognitive load required for the model to parse intent:
-
-1. **System instructions** — Persona definition, quality expectations, explicit prohibitions on filler content.
-2. **Context block** (`<context>`) — Passive background data: architecture details, configurations, existing code.
-3. **Data block** (`<data>`, `<logs>`, `<config>`) — Active information the model must process against the context.
-4. **Task block** (`<tasks>`) — Numbered list of specific actions to execute.
-
-This compartmentalization ensures the model can distinguish between persistent rules, background context, and immediate work items. It significantly reduces the confusion that triggers premature truncation.
-
-## Verification Loops
-
-### Chain of Verification
-1. Model generates an initial response
-2. Model generates verification questions about its own claims
-3. Model independently answers those verification questions
-4. Model outputs a revised, evidence-backed response
-
-This process forces iterative self-correction, consuming the model's capacity for shortcutting.
-
-### Reverse Prompting
-Instead of manually constructing a structured prompt, provide the model with a one-line objective and instruct it to generate the optimal prompt for that objective. The model produces the XML structure, constraints, and roles required for the task.
-
-### Self-Grading Loop
-The prompt requires the model to:
-1. Define what excellence looks like for the given task
-2. Grade its own initial output against that definition
-3. Iterate until the self-defined quality bar is met
diff --git a/research/laziness/remediation/reference-prompts.md b/research/laziness/remediation/reference-prompts.md
deleted file mode 100644
index 185ad86..0000000
--- a/research/laziness/remediation/reference-prompts.md
+++ /dev/null
@@ -1,79 +0,0 @@
-# Reference Prompts
-
-Ready-to-use prompt templates for enforcing complete outputs. Append to any prompt or include in system instructions.
-
----
-
-## General Purpose
-
-```
-You must provide the FULL, complete, and exhaustive output for this task.
-Do not summarize, abbreviate, or truncate for brevity.
-
-You are strictly forbidden from using placeholders. Never use comments like
-"// ... rest of code here", "[continue here]", or bare ellipses standing
-in for omitted content. If the output is 500 lines, produce all 500 lines.
-
-If you approach your output limit, stop at a clean breakpoint and indicate
-where to resume. Do not rush to a conclusion or compress remaining sections.
-```
-
----
-
-## Code Generation
-
-```
-Write the complete, production-ready implementation. Every function, every
-import, every edge case handler must be present in the output.
-
-Do not use placeholder comments (// TODO, // implement here, // similar
-to above). Do not describe what code should do — write the actual code.
-
-If the implementation requires multiple files, output each file completely
-with its full path as a header.
-```
-
----
-
-## Analysis and Documentation
-
-```
-Provide an exhaustive analysis covering every aspect requested. Each section
-must contain substantive content, not summaries or references to "see above."
-
-Do not use phrases like "as mentioned earlier" to avoid repeating necessary
-context. Each section should be self-contained and complete.
-
-Structure your output with clear headings. If the analysis requires multiple
-parts, produce all parts in full.
-```
-
----
-
-## Step-by-Step Reasoning
-
-```
-Before generating your final response, work through the problem systematically:
-
-1. Identify all requirements and constraints from the prompt
-2. Break the task into discrete steps
-3. Execute each step completely
-4. Verify your output against the original requirements
-
-Output your reasoning process, then your final answer. Do not skip steps
-or summarize intermediate work.
-```
-
----
-
-## Continuation Handling
-
-```
-If your response approaches the output token limit:
-- Do not compress remaining content to fit
-- Do not skip ahead to a conclusion
-- Stop at a natural breakpoint (end of a function, end of a section)
-- End with: [PAUSED - X of Y sections complete. Send "continue" to resume]
-
-On "continue", pick up exactly where you stopped. No recaps or repetition.
-```
diff --git a/research/laziness/root-causes/cognitive-shortcuts.md b/research/laziness/root-causes/cognitive-shortcuts.md
deleted file mode 100644
index ad67fa1..0000000
--- a/research/laziness/root-causes/cognitive-shortcuts.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# Cognitive Shortcuts
-
-## The LazyBench Discovery
-
-Research from late 2024 demonstrated that frontier models (including Gemini Pro and GPT-4o) exhibit measurable cognitive shortcutting behavior. When a model perceives a task as straightforward or the provided context as excessively long, it reduces its internal computational effort. Rather than executing full multi-step reasoning, it produces a surface-level summary.
-
-This is not a memory failure or context degradation — the model retains the information but chooses not to process it at full depth.
-
-## Metacognitive Laziness
-
-The interaction between model brevity and human behavior creates a feedback loop. As models provide instant, condensed answers, users increasingly offload inference and logical deduction work. Research from the European Research Council has documented measurable declines in working memory engagement among populations with high AI dependency.
-
-In professional environments, this shifts critical thinking from original synthesis to "prompt verification" — users evaluate whether the AI's truncated output seems reasonable rather than performing the analysis themselves.
-
-## Seasonal Behavior Anomalies
-
-In late 2023, researchers observed a statistically significant increase in ChatGPT output brevity during December. Analysis revealed that the training data contains fewer detailed work outputs, more out-of-office responses, and shorter code commits during holiday periods. The model internalized this seasonal pattern.
-
-When researchers explicitly stated "It is May" in the system prompt, output length measurably increased. This finding demonstrates that even arbitrary contextual signals in the prompt can shift the model's brevity calibration.
-
-## Error Avoidance as Truncation Driver
-
-Models also truncate outputs as a risk mitigation strategy. On long-form tasks, longer outputs increase the probability of compounding errors and hallucinated content. The model has learned that shorter outputs reduce the surface area for factual mistakes, creating an additional incentive to truncate that compounds with the RLHF brevity bias.
diff --git a/research/laziness/root-causes/output-limits.md b/research/laziness/root-causes/output-limits.md
deleted file mode 100644
index 3d346ef..0000000
--- a/research/laziness/root-causes/output-limits.md
+++ /dev/null
@@ -1,39 +0,0 @@
-# Output Limits and Consumer Truncation
-
-## Context Window Asymmetry
-
-Models like Gemini have massive input context windows (up to 2 million tokens) but strictly capped output limits (typically 8,000 tokens). When the model estimates that a complete response would exceed its output budget, it preemptively compresses or summarizes the output rather than risking an abrupt cutoff.
-
-This creates a paradox: the model can read extensive inputs but cannot respond proportionally, leading to systematic information loss on complex tasks.
-
-## The Consumer Middleware Problem
-
-Consumer-facing applications (gemini.google.com, standard ChatGPT tiers) apply additional software-level truncation on top of the model's inherent limits. This middleware silently truncates conversation history and uploaded files to reduce compute costs for free and low-tier users.
-
-Key mechanisms:
-
-- **History capping:** Many consumer interfaces cap active conversation history at approximately 32,000 tokens, regardless of the model's actual capacity.
-- **Context pruning:** Large system instructions or saved personal context consume tokens that would otherwise be available for the conversation, effectively shrinking the working window.
-- **Retrieval-based recall:** Consumer apps often use retrieval mechanisms to selectively inject saved context, meaning the model frequently drops instructions it was given earlier in the session.
-
-## Developer Platform Differences
-
-Direct API access and developer platforms (Google AI Studio, OpenAI API Playground) bypass consumer middleware entirely. These environments provide:
-
-- Full context window access without hidden truncation
-- Complete control over generation parameters
-- No dynamic throttling based on user tier
-- Processing of complex prompt structures without middleware interference
-
-The practical difference is significant: the same model that produces truncated outputs through a consumer interface will generate complete, unabridged responses when accessed through direct API endpoints.
-
-## Terminal and CLI Integration
-
-Purpose-built CLI tools (Gemini CLI, Claude Code, third-party wrappers) offer additional advantages for avoiding truncation:
-
-| Access Method | Context Handling | Truncation Risk | Parameter Control |
-|:---|:---|:---|:---|
-| Consumer web app | Aggressive pruning, 32K cap | High | Limited |
-| Developer platform (AI Studio) | Full context, no hidden slicing | Low | Full |
-| Direct API | Full context, raw access | Minimal | Full |
-| CLI tools with local models | No corporate alignment filters | None | Full |
diff --git a/research/laziness/root-causes/rlhf-and-compute.md b/research/laziness/root-causes/rlhf-and-compute.md
deleted file mode 100644
index 5ef6783..0000000
--- a/research/laziness/root-causes/rlhf-and-compute.md
+++ /dev/null
@@ -1,27 +0,0 @@
-# RLHF and Compute Economics
-
-## The Cost of Token Generation
-
-Every token an LLM generates consumes GPU compute resources. At an estimated baseline cost of $0.0001 per token, scaling deep multi-step reasoning across hundreds of millions of users would exhaust the financial capacity of any provider. This creates an inherent economic incentive to minimize output length.
-
-## Brevity Bias Through Alignment
-
-To manage infrastructure costs, model providers use Reinforcement Learning from Human Feedback (RLHF) and behavioral fine-tuning to instill systematic brevity preferences. During post-training alignment, models are rewarded for generating short, confident summaries rather than executing the full compute cycles needed for exhaustive analysis.
-
-The result is a trained preference for producing generalized approximations over rigorous, multi-step solutions. The model does not necessarily produce incorrect answers, but it consistently produces answers that lack depth — saving itself from deeper analytical work unless the user explicitly forces it.
-
-## Stopping Pressure
-
-Autoregressive models generate text token by token and lack an inherent mechanism for recognizing task completion. To prevent infinite generation, training introduces "stopping pressure" — a learned tendency to conclude outputs.
-
-In recent model iterations, this stopping pressure has been calibrated aggressively to preserve compute. This leads to:
-
-- Skipping required structured output fields, particularly long-form content in JSON or markdown
-- Halting mid-task with phrases like "let me know if you want me to continue"
-- Refusing to produce comprehensive solutions, suggesting the user "think about it"
-
-This aggressive calibration is further reinforced by safety tuning protocols, which inject additional behavioral constraints that make models resistant to generating large codebases or detailed reviews.
-
-## Dynamic Throttling
-
-Providers dynamically scale back model performance during peak demand periods. This introduces additional friction beyond what the base alignment already imposes, resulting in even shorter and less detailed outputs when server load is high.
diff --git a/research/laziness/root-causes/training-data-bias.md b/research/laziness/root-causes/training-data-bias.md
deleted file mode 100644
index 1aa2c7a..0000000
--- a/research/laziness/root-causes/training-data-bias.md
+++ /dev/null
@@ -1,28 +0,0 @@
-# Training Data Bias
-
-## Placeholder Propagation
-
-LLMs learn by imitating patterns in human-written text. A significant portion of their training data comes from sources like Stack Overflow, GitHub repositories, and tutorial blogs. In these sources, human developers routinely write abbreviated code:
-
-```python
-def complex_logic():
- # implement auth here
- pass
-```
-
-The model internalizes this pattern and treats placeholder insertion as a legitimate, professional response format. It is not deliberately withholding content — it has been trained to believe that truncating code with comments is the correct way to answer technical questions.
-
-## Pattern Reinforcement
-
-This behavior is reinforced across multiple data sources:
-
-- **Code tutorials** frequently show partial implementations with comments indicating where students should complete the logic
-- **Documentation** often uses abbreviated examples with ellipses
-- **Forum answers** regularly provide skeleton code rather than full implementations
-- **Blog posts** truncate repetitive code blocks with "similarly for the remaining cases"
-
-The cumulative effect is that the model assigns high probability to truncation tokens in contexts where complete code generation would be appropriate.
-
-## Impact on Output Quality
-
-When a user requests a complete implementation, the model faces competing training signals: the explicit instruction to produce full output versus the deeply embedded pattern of producing abbreviated, "tutorial-style" responses. Without aggressive prompt engineering, the tutorial-style pattern frequently wins because it appears far more commonly in the training distribution.
diff --git a/skill.sh b/skill.sh
deleted file mode 100644
index 5e53322..0000000
--- a/skill.sh
+++ /dev/null
@@ -1,63 +0,0 @@
-#!/usr/bin/env bash
-
-# Local skill registry. Each skill is listed by its install name (the `name:` in its SKILL.md,
-# the value `npx skills add --skill` takes) and by its folder name.
-declare -A SKILLS=(
- [design-taste-frontend]="skills/taste-skill/SKILL.md"
- [design-taste-frontend-v2-experimental]="skills/taste-skill-v2-experimental/SKILL.md"
- [design-taste-frontend-v1]="skills/taste-skill-v1/SKILL.md"
- [image-to-code]="skills/image-to-code-skill/SKILL.md"
- [redesign-existing-projects]="skills/redesign-skill/SKILL.md"
- [high-end-visual-design]="skills/soft-skill/SKILL.md"
- [minimalist-ui]="skills/minimalist-skill/SKILL.md"
- [industrial-brutalist-ui]="skills/brutalist-skill/SKILL.md"
- [stitch-design-taste]="skills/stitch-skill/SKILL.md"
- [gpt-tasteskill]="skills/gpt-tasteskill/SKILL.md"
- [taste-skill]="skills/taste-skill/SKILL.md"
- [taste-skill-v2-experimental]="skills/taste-skill-v2-experimental/SKILL.md"
- [taste-skill-v1]="skills/taste-skill-v1/SKILL.md"
- [gpt-taste]="skills/gpt-tasteskill/SKILL.md"
- [image-to-code-skill]="skills/image-to-code-skill/SKILL.md"
- [imagegen-frontend-web]="skills/imagegen-frontend-web/SKILL.md"
- [imagegen-frontend-mobile]="skills/imagegen-frontend-mobile/SKILL.md"
- [brandkit]="skills/brandkit/SKILL.md"
- [redesign-skill]="skills/redesign-skill/SKILL.md"
- [soft-skill]="skills/soft-skill/SKILL.md"
- [minimalist-skill]="skills/minimalist-skill/SKILL.md"
- [brutalist-skill]="skills/brutalist-skill/SKILL.md"
- [stitch-skill]="skills/stitch-skill/SKILL.md"
-)
-
-print_help() {
- echo "Usage: source ./skill.sh <skill-name>"
- echo " source ./skill.sh --list"
- echo
- echo "Available skills:"
- printf '%s\n' "${!SKILLS[@]}" | sort
-}
-
-skill_main() {
- if [[ $# -eq 0 || "$1" == "-h" || "$1" == "--help" ]]; then
- print_help
- return 0
- fi
-
- if [[ "$1" == "--list" ]]; then
- printf '%s\n' "${!SKILLS[@]}" | sort
- return 0
- fi
-
- local skill_name="$1"
- local skill_path="${SKILLS[$skill_name]-}"
-
- if [[ -z "$skill_path" ]]; then
- echo "Unknown skill: $skill_name" >&2
- echo >&2
- print_help >&2
- return 2
- fi
-
- echo "$skill_path"
-}
-
-skill_main "$@"
diff --git a/skills/brandkit/SKILL.md b/skills/brandkit/SKILL.md
deleted file mode 100644
index 0d533ac..0000000
--- a/skills/brandkit/SKILL.md
+++ /dev/null
@@ -1,15 +0,0 @@
----
-name: brandkit
-description: "Moved to github.com/Leonxlnx/imagegen-skills. Runs only when called by name."
-disable-model-invocation: true
----
-
-# brandkit (moved)
-
-This skill now lives in its own repository, with the other image-generation skills: https://github.com/Leonxlnx/imagegen-skills
-
-The install name did not change:
-
-```bash
-npx skills add https://github.com/Leonxlnx/imagegen-skills --skill "brandkit"
-```
diff --git a/skills/brandkit/agents/openai.yaml b/skills/brandkit/agents/openai.yaml
deleted file mode 100644
index 5b1f887..0000000
--- a/skills/brandkit/agents/openai.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-policy:
- allow_implicit_invocation: false
diff --git a/skills/brutalist-skill/SKILL.md b/skills/brutalist-skill/SKILL.md
deleted file mode 100644
index 119030a..0000000
--- a/skills/brutalist-skill/SKILL.md
+++ /dev/null
@@ -1,93 +0,0 @@
----
-name: industrial-brutalist-ui
-description: "Classic style skill, opt-in: it runs only when called by name. A hard mechanical look with Swiss type, rigid grids, extreme scale contrast and utilitarian colour."
-disable-model-invocation: true
----
-
-# SKILL: Industrial Brutalism & Tactical Telemetry UI
-
-## 1. Skill Meta
-**Name:** Industrial Brutalism & Tactical Telemetry Interface Engineering
-**Description:** Advanced proficiency in architecting web interfaces that synthesize mid-century Swiss Typographic design, industrial manufacturing manuals, and retro-futuristic aerospace/military terminal interfaces. This discipline requires absolute mastery over rigid modular grids, extreme typographic scale contrast, purely utilitarian color palettes, and the programmatic simulation of analog degradation (halftones, CRT scanlines, bitmap dithering). The objective is to construct digital environments that project raw functionality, mechanical precision, and high data density, deliberately discarding conventional consumer UI patterns.
-
-## 2. Visual Archetypes
-The design system operates by merging two distinct but highly compatible visual paradigms. **Pick ONE per project and commit to it. Do not alternate or mix both modes within the same interface.**
-
-### 2.1 Swiss Industrial Print
-Derived from 1960s corporate identity systems and heavy machinery blueprints.
-* **Characteristics:** High-contrast light modes (newsprint/off-white substrates). Reliance on monolithic, heavy sans-serif typography. Unforgiving structural grids outlined by visible dividing lines. Aggressive, asymmetric use of negative space punctuated by oversized, viewport-bleeding numerals or letterforms. Heavy use of primary red as an alert/accent color.
-
-### 2.2 Tactical Telemetry & CRT Terminal
-Derived from classified military databases, legacy mainframes, and aerospace Heads-Up Displays (HUDs).
-* **Characteristics:** Dark mode exclusivity. High-density tabular data presentation. Absolute dominance of monospaced typography. Integration of technical framing devices (ASCII brackets, crosshairs). Application of simulated hardware limitations (phosphor glow, scanlines, low bit-depth rendering).
-
-## 3. Typographic Architecture
-Typography is the primary structural and decorative infrastructure. Imagery is secondary. The system demands extreme variance in scale, weight, and spacing.
-
-### 3.1 Macro-Typography (Structural Headers)
-* **Classification:** Neo-Grotesque / Heavy Sans-Serif.
-* **Optimal Web Fonts:** Neue Haas Grotesk (Black), Inter (Extra Bold/Black), Archivo Black, Roboto Flex (Heavy), Monument Extended.
-* **Implementation Parameters:**
- * **Scale:** Deployed at massive scales using fluid typography (e.g., `clamp(4rem, 10vw, 15rem)`).
- * **Tracking (Letter-spacing):** Extremely tight, often negative (`-0.03em` to `-0.06em`), forcing glyphs to form solid architectural blocks.
- * **Leading (Line-height):** Highly compressed (`0.85` to `0.95`).
- * **Casing:** Exclusively uppercase for structural impact.
-
-### 3.2 Micro-Typography (Data & Telemetry)
-* **Classification:** Monospace / Technical Sans.
-* **Optimal Web Fonts:** JetBrains Mono, IBM Plex Mono, Space Mono, VT323, Courier Prime.
-* **Implementation Parameters:**
- * **Scale:** Fixed and small (`10px` to `14px` / `0.7rem` to `0.875rem`).
- * **Tracking:** Generous (`0.05em` to `0.1em`) to simulate mechanical typewriter spacing or terminal matrices.
- * **Leading:** Standard to tight (`1.2` to `1.4`).
- * **Casing:** Exclusively uppercase. Used for all metadata, navigation, unit IDs, and coordinates.
-
-### 3.3 Textural Contrast (Artistic Disruption)
-* **Classification:** High-Contrast Serif.
-* **Optimal Web Fonts:** Playfair Display, EB Garamond, Times New Roman.
-* **Implementation Parameters:** Used exceedingly sparingly. Must be subjected to heavy post-processing (halftone filters, 1-bit dithering) to degrade vector perfection and create textural juxtaposition against the clean sans-serifs.
-
-## 4. Color System
-The color architecture is uncompromising. Gradients, soft drop shadows, and modern translucency are strictly prohibited. Colors simulate physical media or primitive emissive displays.
-
-**CRITICAL: Choose ONE substrate palette per project and use it consistently. Never mix light and dark substrates within the same interface.**
-
-### If Swiss Industrial Print (Light):
-* **Background:** `#F4F4F0` or `#EAE8E3` (Matte, unbleached documentation paper).
-* **Foreground:** `#050505` to `#111111` (Carbon Ink).
-* **Accent:** `#E61919` or `#FF2A2A` (Aviation/Hazard Red). This is the ONLY accent color. Used for strike-throughs, thick structural dividing lines, or vital data highlights.
-
-### If Tactical Telemetry (Dark):
-* **Background:** `#0A0A0A` or `#121212` (Deactivated CRT. Avoid pure `#000000`).
-* **Foreground:** `#EAEAEA` (White phosphor). This is the primary text color.
-* **Accent:** `#E61919` or `#FF2A2A` (Aviation/Hazard Red). Same red, same rules.
-* **Terminal Green (`#4AF626`):** Optional. Use ONLY for a single specific UI element (e.g., one status indicator or one data readout) — never as a general text color. If it doesn't serve a clear purpose, omit it entirely.
-
-## 5. Layout and Spatial Engineering
-The layout must appear mathematically engineered. It rejects conventional web padding in favor of visible compartmentalization.
-
-* **The Blueprint Grid:** Strict adherence to CSS Grid architectures. Elements do not float; they are anchored precisely to grid tracks and intersections.
-* **Visible Compartmentalization:** Extensive utilization of solid borders (`1px` or `2px solid`) to delineate distinct zones of information. Horizontal rules (`<hr>`) frequently span the entire container width to segregate operational units.
-* **Bimodal Density:** Layouts oscillate between extreme data density (tightly packed monospace metadata clustered together) and vast expanses of calculated negative space framing macro-typography.
-* **Geometry:** Absolute rejection of `border-radius`. All corners must be exactly 90 degrees to enforce mechanical rigidity.
-
-## 6. UI Components and Symbology
-Standard web UI conventions are replaced with utilitarian, industrial graphic elements.
-
-* **Syntax Decoration:** Utilization of ASCII characters to frame data points.
- * *Framing:* `[ DELIVERY SYSTEMS ]`, `< RE-IND >`
- * *Directional:* `>>>`, `///`, `\\\\`
-* **Industrial Markers:** Prominent integration of registration (`®`), copyright (`©`), and trademark (`™`) symbols functioning as structural geometric elements rather than legal text.
-* **Technical Assets:** Integration of crosshairs (`+`) at grid intersections, repeating vertical lines (barcodes), thick horizontal warning stripes, and randomized string data (e.g., `REV 2.6`, `UNIT / D-01`) to simulate active mechanical processes.
-
-## 7. Textural and Post-Processing Effects
-To prevent the design from appearing purely digital, simulated analog degradation is engineered into the frontend via CSS and SVG filters.
-
-* **Halftone and 1-Bit Dithering:** Transforming continuous-tone images or large serif typography into dot-matrix patterns. Achieved via pre-processing or CSS `mix-blend-mode: multiply` overlays combined with SVG radial dot patterns.
-* **CRT Scanlines:** For terminal interfaces, applying a `repeating-linear-gradient` to the background to simulate horizontal electron beam sweeps (e.g., `repeating-linear-gradient(0deg, transparent, transparent 2px, rgba(0,0,0,0.1) 2px, rgba(0,0,0,0.1) 4px)`).
-* **Mechanical Noise:** A global, low-opacity SVG static/noise filter applied to the DOM root to introduce a unified physical grain across both dark and light modes.
-
-## 8. Web Engineering Directives
-1. **Grid Determinism:** Utilize `display: grid; gap: 1px;` with contrasting parent/child background colors to generate mathematically perfect, razor-thin dividing lines without complex border declarations.
-2. **Semantic Rigidity:** Construct the DOM using precise semantic tags (`<data>`, `<samp>`, `<kbd>`, `<output>`, `<dl>`) to accurately reflect the technical nature of the telemetry.
-3. **Typography Clamping:** Implement CSS `clamp()` functions exclusively for macro-typography to ensure massive text scales aggressively while maintaining structural integrity across viewports.
diff --git a/skills/brutalist-skill/agents/openai.yaml b/skills/brutalist-skill/agents/openai.yaml
deleted file mode 100644
index 5b1f887..0000000
--- a/skills/brutalist-skill/agents/openai.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-policy:
- allow_implicit_invocation: false
diff --git a/skills/gpt-tasteskill/SKILL.md b/skills/gpt-tasteskill/SKILL.md
deleted file mode 100644
index c9a7239..0000000
--- a/skills/gpt-tasteskill/SKILL.md
+++ /dev/null
@@ -1,76 +0,0 @@
----
-name: gpt-taste
-description: "Classic skill for GPT and Codex, opt-in: it runs only when called by name. Layout variance, a strict AIDA page structure and GSAP scroll motion."
-disable-model-invocation: true
----
-
-# CORE DIRECTIVE: AWWWARDS-LEVEL DESIGN ENGINEERING
-You are an elite, award-winning frontend design engineer. Standard LLMs possess severe statistical biases: they generate massive 6-line wrapped headings by using narrow containers, leave ugly empty gaps in bento grids, use cheap meta-labels ("QUESTION 05", "SECTION 01"), output invisible button text, and endlessly repeat the same Left/Right layouts.
-
-Your goal is to aggressively break these defaults. Your outputs must be highly creative, perfectly spaced, motion-rich (GSAP), mathematically flawless in grid execution, and heavily rely on varied, high-end assets.
-
-DO NOT USE EMOJIS IN YOUR CODE, COMMENTS, OR OUTPUT. Maintain strictly professional formatting.
-
-## 1. PYTHON-DRIVEN TRUE RANDOMIZATION (BREAKING THE LOOP)
-LLMs are inherently lazy and always pick the first layout option. To prevent this, you MUST simulate a Python script execution in your `<design_plan>` before writing any UI code.
-Use a deterministic seed (e.g., character count of the user prompt modulo math) to simulate `random.choice()` and strictly select:
-- 1 Hero Architecture (from Section 3)
-- 1 Typography Stack (Satoshi, Cabinet Grotesk, Outfit, or Geist. NEVER Inter)
-- 3 Unique Component Architectures (from Section 6)
-- 2 Advanced GSAP Paradigms (from Section 5)
-You are forbidden from defaulting to the same UI twice. You must follow the exact output of your simulated Python randomization.
-
-## 2. AIDA STRUCTURE & SPACING
-Every page MUST begin with a highly creative, premium Navigation Bar (e.g., floating glass pill, or minimal split nav).
-The rest of the page MUST follow the AIDA framework:
-- **Attention (Hero):** Cinematic, clean, wide layout.
-- **Interest (Features/Bento):** High-density, mathematically perfect grid or interactive typographic components.
-- **Desire (GSAP Scroll/Media):** Pinned sections, horizontal scroll, or text-reveals.
-- **Action (Footer/Pricing):** Massive, high-contrast CTA and clean footer links.
-**SPACING RULE:** Add huge vertical padding between all major sections (e.g., `py-32 md:py-48`). Sections must feel like distinct, cinematic chapters. Do not cramp elements together.
-
-## 3. HERO ARCHITECTURE & THE 2-LINE IRON RULE
-The Hero must breathe. It must NOT be a narrow, 6-line text wall.
-- **The Container Width Fix:** You MUST use ultra-wide containers for the H1 (e.g., `max-w-5xl`, `max-w-6xl`, `w-full`). Allow the words to flow horizontally.
-- **The Line Limit:** The H1 MUST NEVER exceed 2 to 3 lines. 4, 5, or 6 lines is a catastrophic failure. Make the font size smaller (`clamp(3rem, 5vw, 5.5rem)`) and the container wider to ensure this.
-- **Hero Layout Options (Randomly Assigned via Python):**
- 1. *Cinematic Center (Highly Preferred):* Text perfectly centered, massive width. Below the text, exactly two high-contrast CTAs. Below the CTAs or behind everything, a stunning, full-bleed background image with a dark radial wash.
- 2. *Artistic Asymmetry:* Text offset to the left, with an artistic floating image overlapping the text from the bottom right.
- 3. *Editorial Split:* Text left, image right, but with massive negative space.
-- **Button Contrast:** Buttons must be perfectly legible. Dark background = white text. Light background = dark text. Invisible text is a failure.
-- **BANNED IN HERO:** Do NOT use arbitrary floating stamp/badge icons on the text. Do NOT use pill-tags under the hero. Do NOT place raw data/stats in the hero.
-
-## 4. THE GAPLESS BENTO GRID
-- **Zero Empty Space in Grids:** LLMs notoriously leave blank, dead cells in CSS grids. You MUST use Tailwind's `grid-flow-dense` (`grid-auto-flow: dense`) on every Bento Grid. You must mathematically verify that your `col-span` and `row-span` values interlock perfectly. No grid shall have a missing corner or empty void.
-- **Card Restraint:** Do not use too many cards. 3 to 5 highly intentional, beautifully styled cards are better than 8 messy ones. Fill them with a mix of large imagery, dense typography, or CSS effects.
-
-## 5. ADVANCED GSAP MOTION & HOVER PHYSICS
-Static interfaces are strictly forbidden. You must write real GSAP (`@gsap/react`, `ScrollTrigger`).
-- **Hover Physics:** Every clickable card and image must react. Use `group-hover:scale-105 transition-transform duration-700 ease-out` inside `overflow-hidden` containers.
-- **Scroll Pinning (GSAP Split):** Pin a section title on the left (`ScrollTrigger pin: true`) while a gallery of elements scrolls upwards on the right side.
-- **Image Scale & Fade Scroll:** Images must start small (`scale: 0.8`). As they scroll into view, they grow to `scale: 1.0`. As they scroll out of view, they smoothly darken and fade out (`opacity: 0.2`).
-- **Scrubbing Text Reveals:** Opacity of central paragraph words starts at 0.1 and scrubs to 1.0 sequentially as the user scrolls.
-- **Card Stacking:** Cards overlap and stack on top of each other dynamically from the bottom as the user scrolls down.
-- **Reduced Motion (mandatory):** Every animation above MUST honor `prefers-reduced-motion: reduce`. Gate ScrollTrigger/GSAP setup behind a reduced-motion check (`gsap.matchMedia()` or `useReducedMotion()`), and under `(prefers-reduced-motion: reduce)` collapse scroll-pinning, scrubbing, image scale/fade, card stacking, and marquees to their static end-state (full opacity, `scale: 1`, no auto-scroll). "Static interfaces are forbidden" governs the default experience, not users who have explicitly requested reduced motion.
-
-## 6. COMPONENT ARSENAL & CREATIVITY
-Select components from this arsenal based on your randomization:
-- **Inline Typography Images:** Embed small, pill-shaped images directly INSIDE massive headings. Example: `I shape <span className="inline-block w-24 h-10 rounded-full align-middle bg-cover bg-center mx-2" style={{backgroundImage: 'url(...)'}}></span> digital spaces.`
-- **Horizontal Accordions:** Vertical slices that expand horizontally on hover to reveal content and imagery.
-- **Infinite Marquee (Trusted Partners):** Smooth, continuously scrolling rows of authentic `@phosphor-icons/react` or large typography.
-- **Feedback/Testimonial Carousel:** Clean, overlapping portrait images next to minimalist typography quotes, controlled by subtle arrows.
-
-## 7. CONTENT, ASSETS & STRICT BANS
-- **The Meta-Label Ban:** BANNED FOREVER are labels like "SECTION 01", "SECTION 04", "QUESTION 05", "ABOUT US". Remove them entirely. They look cheap and unprofessional.
-- **Image Context & Style:** Use `https://picsum.photos/seed/{keyword}/1920/1080` and match the keyword to the vibe. Apply sophisticated CSS filters (`grayscale`, `mix-blend-luminosity`, `opacity-90`, `contrast-125`) so they do not look like boring stock photos.
-- **Creative Backgrounds:** Inject subtle, professional ambient design. Use deep radial blurs, grainy mesh gradients, or shifting dark overlays. Avoid flat, boring colors.
-- **Horizontal Scroll Bug:** Wrap the entire page in `<main className="overflow-x-hidden w-full max-w-full">` to absolutely prevent horizontal scrollbars caused by off-screen animations.
-
-## 8. MANDATORY PRE-FLIGHT <design_plan>
-Before writing ANY React/UI code, you MUST output a `<design_plan>` block containing:
-1. **Python RNG Execution:** Write a 3-line mock Python output showing the deterministic selection of your Hero Layout, Component Arsenal, GSAP animations, and Fonts based on the prompt's character count.
-2. **AIDA Check:** Confirm the page contains Navigation, Attention (Hero), Interest (Bento), Desire (GSAP), Action (Footer).
-3. **Hero Math Verification:** Explicitly state the `max-w` class you are applying to the H1 to GUARANTEE it will flow horizontally in 2-3 lines. Confirm NO stamp icons or spam tags exist.
-4. **Bento Density Verification:** Prove mathematically that your grid columns and rows leave zero empty spaces and `grid-flow-dense` is applied.
-5. **Label Sweep & Button Check:** Confirm no cheap meta-labels ("QUESTION 05") exist, and button text contrast is perfect.
-Only output the UI code after this rigorous verification is complete.
diff --git a/skills/gpt-tasteskill/agents/openai.yaml b/skills/gpt-tasteskill/agents/openai.yaml
deleted file mode 100644
index 5b1f887..0000000
--- a/skills/gpt-tasteskill/agents/openai.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-policy:
- allow_implicit_invocation: false
diff --git a/skills/image-to-code-skill/SKILL.md b/skills/image-to-code-skill/SKILL.md
deleted file mode 100644
index efda909..0000000
--- a/skills/image-to-code-skill/SKILL.md
+++ /dev/null
@@ -1,15 +0,0 @@
----
-name: image-to-code
-description: "Moved to github.com/Leonxlnx/imagegen-skills. Runs only when called by name."
-disable-model-invocation: true
----
-
-# image-to-code (moved)
-
-This skill now lives in its own repository, with the other image-generation skills: https://github.com/Leonxlnx/imagegen-skills
-
-The install name did not change:
-
-```bash
-npx skills add https://github.com/Leonxlnx/imagegen-skills --skill "image-to-code"
-```
diff --git a/skills/image-to-code-skill/agents/openai.yaml b/skills/image-to-code-skill/agents/openai.yaml
deleted file mode 100644
index 5b1f887..0000000
--- a/skills/image-to-code-skill/agents/openai.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-policy:
- allow_implicit_invocation: false
diff --git a/skills/imagegen-frontend-mobile/SKILL.md b/skills/imagegen-frontend-mobile/SKILL.md
deleted file mode 100644
index b547cde..0000000
--- a/skills/imagegen-frontend-mobile/SKILL.md
+++ /dev/null
@@ -1,15 +0,0 @@
----
-name: imagegen-frontend-mobile
-description: "Moved to github.com/Leonxlnx/imagegen-skills. Runs only when called by name."
-disable-model-invocation: true
----
-
-# imagegen-frontend-mobile (moved)
-
-This skill now lives in its own repository, with the other image-generation skills: https://github.com/Leonxlnx/imagegen-skills
-
-The install name did not change:
-
-```bash
-npx skills add https://github.com/Leonxlnx/imagegen-skills --skill "imagegen-frontend-mobile"
-```
diff --git a/skills/imagegen-frontend-mobile/agents/openai.yaml b/skills/imagegen-frontend-mobile/agents/openai.yaml
deleted file mode 100644
index 5b1f887..0000000
--- a/skills/imagegen-frontend-mobile/agents/openai.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-policy:
- allow_implicit_invocation: false
diff --git a/skills/imagegen-frontend-web/SKILL.md b/skills/imagegen-frontend-web/SKILL.md
deleted file mode 100644
index caac618..0000000
--- a/skills/imagegen-frontend-web/SKILL.md
+++ /dev/null
@@ -1,15 +0,0 @@
----
-name: imagegen-frontend-web
-description: "Moved to github.com/Leonxlnx/imagegen-skills. Runs only when called by name."
-disable-model-invocation: true
----
-
-# imagegen-frontend-web (moved)
-
-This skill now lives in its own repository, with the other image-generation skills: https://github.com/Leonxlnx/imagegen-skills
-
-The install name did not change:
-
-```bash
-npx skills add https://github.com/Leonxlnx/imagegen-skills --skill "imagegen-frontend-web"
-```
diff --git a/skills/imagegen-frontend-web/agents/openai.yaml b/skills/imagegen-frontend-web/agents/openai.yaml
deleted file mode 100644
index 5b1f887..0000000
--- a/skills/imagegen-frontend-web/agents/openai.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-policy:
- allow_implicit_invocation: false
diff --git a/skills/llms.txt b/skills/llms.txt
deleted file mode 100644
index d3b24c5..0000000
--- a/skills/llms.txt
+++ /dev/null
@@ -1,14 +0,0 @@
-taste-skill: The default design skill (v2). Art direction from a study of 247 gallery sites: inventory what only the client has, choose one of three dealt directions, build with full content, then pass a real-browser inspector that fails eyebrows, monospace labels, 01/02/03 numbering, hairlines, gradients, resting shadows and headlines over two lines. A folder with scripts (Node 22+, Chrome). Install name `design-taste-frontend`.
-taste-skill-v2-experimental: Old v2 (experimental), the single-file dial-driven rewrite (VARIANCE / MOTION / DENSITY) that was the default before v2. Install name `design-taste-frontend-v2-experimental`.
-taste-skill-v1: Old v1, the original taste-skill, preserved for projects depending on its exact behavior. The current default is `design-taste-frontend` (v2).
-gpt-taste: Elite Awwwards-level frontend design and GSAP motion skill for premium, deterministic, anti-slop UI generation.
-image-to-code-skill: Image-first frontend skill for generating premium website references, deeply analyzing them, and implementing code to match.
-imagegen-frontend-web: Image-generation-only skill for creating premium website design reference images. Does not write code.
-imagegen-frontend-mobile: Image-generation-only skill for creating premium mobile app screen concepts and flows. Does not write code.
-brandkit: Image-generation-only skill for creating premium brand-kit overview images with logo concepts, identity systems, color palettes, typography, and mockups. Does not write code.
-redesign-skill: For upgrading existing projects by auditing and fixing design problems.
-soft-skill: Focuses on an expensive, soft UI look with premium fonts, whitespace, depth, and smooth animations.
-output-skill: Prevents AI from being lazy, skipping code blocks, or using placeholder comments.
-minimalist-skill: Enforces clean, editorial-style interfaces (Notion/Linear style) with strict monochrome palettes.
-brutalist-skill: Raw mechanical interfaces, Swiss typography, extreme scale contrast. (Beta)
-stitch-skill: Google Stitch-compatible semantic design rules for premium AI UI generation.
diff --git a/skills/minimalist-skill/SKILL.md b/skills/minimalist-skill/SKILL.md
deleted file mode 100644
index e6902a6..0000000
--- a/skills/minimalist-skill/SKILL.md
+++ /dev/null
@@ -1,87 +0,0 @@
----
-name: minimalist-ui
-description: "Classic style skill, opt-in: it runs only when called by name. Editorial product UI with a warm monochrome palette, typographic contrast and flat bento grids."
-disable-model-invocation: true
----
-
-# Protocol: Premium Utilitarian Minimalism UI Architect
-
-## 1. Protocol Overview
-Name: Premium Utilitarian Minimalism & Editorial UI
-Description: An advanced frontend engineering directive for generating highly refined, ultra-minimalist, "document-style" web interfaces analogous to top-tier workspace platforms. This protocol strictly enforces a high-contrast warm monochrome palette, bespoke typographic hierarchies, meticulous structural macro-whitespace, bento-grid layouts, and an ultra-flat component architecture with deliberate muted pastel accents. It actively rejects standard generic SaaS design trends.
-
-## 2. Absolute Negative Constraints (Banned Elements)
-The AI must strictly avoid the following generic web development defaults:
-- DO NOT use the "Inter", "Roboto", or "Open Sans" typefaces.
-- DO NOT use generic, thin-line icon libraries like "Lucide", "Feather", or standard "Heroicons".
-- DO NOT use Tailwind's default heavy drop shadows (e.g., `shadow-md`, `shadow-lg`, `shadow-xl`). Shadows must be practically non-existent or heavily customized to be ultra-diffuse and low opacity (< 0.05).
-- DO NOT use primary colored backgrounds for large elements or sections (e.g., no bright blue, green, or red hero sections).
-- DO NOT use gradients, neon colors, or 3D glassmorphism (beyond subtle navbar blurs).
-- DO NOT use `rounded-full` (pill shapes) for large containers, cards, or primary buttons.
-- DO NOT use emojis anywhere in code, markup, text content, headings, or alt text. Replace with proper icons or clean SVG primitives.
-- DO NOT use generic placeholder names like "John Doe", "Acme Corp", or "Lorem Ipsum". Use realistic, contextual content.
-- DO NOT use AI copywriting clichés: "Elevate", "Seamless", "Unleash", "Next-Gen", "Game-changer", "Delve". Write plain, specific language.
-
-## 3. Typographic Architecture
-The interface must rely on extreme typographic contrast and premium font selection to establish an editorial feel.
-- Primary Sans-Serif (Body, UI, Buttons): Use clean, geometric, or system-native fonts with character. Target: `font-family: 'SF Pro Display', 'Geist Sans', 'Helvetica Neue', 'Switzer', sans-serif`.
-- Editorial Serif (Hero Headings & Quotes): Target: `font-family: 'Lyon Text', 'Newsreader', 'Playfair Display', 'Instrument Serif', serif`. Apply tight tracking (`letter-spacing: -0.02em` to `-0.04em`) and tight line-height (`1.1`).
-- Monospace (Code, Keystrokes, Meta-data): Target: `font-family: 'Geist Mono', 'SF Mono', 'JetBrains Mono', monospace`.
-- Text Colors: Body text must never be absolute black (`#000000`). Use off-black/charcoal (`#111111` or `#2F3437`) with a generous `line-height` of `1.6` for legibility. Secondary text should be muted gray (`#787774`).
-
-## 4. Color Palette (Warm Monochrome + Spot Pastels)
-Color is a scarce resource, utilized only for semantic meaning or subtle accents.
-- Canvas / Background: Pure White `#FFFFFF` or Warm Bone/Off-White `#F7F6F3` / `#FBFBFA`.
-- Primary Surface (Cards): `#FFFFFF` or `#F9F9F8`.
-- Structural Borders / Dividers: Ultra-light gray `#EAEAEA` or `rgba(0,0,0,0.06)`.
-- Accent Colors: Exclusively use highly desaturated, washed-out pastels for tags, inline code backgrounds, or subtle icon backgrounds.
- - Pale Red: `#FDEBEC` (Text: `#9F2F2D`)
- - Pale Blue: `#E1F3FE` (Text: `#1F6C9F`)
- - Pale Green: `#EDF3EC` (Text: `#346538`)
- - Pale Yellow: `#FBF3DB` (Text: `#956400`)
-
-## 5. Component Specifications
-- Bento Box Feature Grids:
- - Utilize asymmetrical CSS Grid layouts.
- - Cards must have exactly `border: 1px solid #EAEAEA`.
- - Border-radius must be crisp: `8px` or `12px` maximum.
- - Internal padding must be generous (e.g., `24px` to `40px`).
-- Primary Call-To-Action (Buttons):
- - Solid background `#111111`, text `#FFFFFF`.
- - Slight border-radius (`4px` to `6px`). No box-shadow.
- - Hover state should be a subtle color shift to `#333333` or a micro-scale `transform: scale(0.98)`.
-- Tags & Status Badges:
- - Pill-shaped (`border-radius: 9999px`), very small typography (`text-xs`), uppercase with wide tracking (`letter-spacing: 0.05em`).
- - Background must use the defined Muted Pastels.
-- Accordions (FAQ):
- - Strip all container boxes. Separate items only with a `border-bottom: 1px solid #EAEAEA`.
- - Use a clean, sharp `+` and `-` icon for the toggle state.
-- Keystroke Micro-UIs:
- - Render shortcuts as physical keys using `<kbd>` tags: `border: 1px solid #EAEAEA`, `border-radius: 4px`, `background: #F7F6F3`, using the Monospace font.
-- Faux-OS Window Chrome:
- - When mocking up software, wrap it in a minimalist container with a white top bar containing three small, light gray circles (replicating macOS window controls).
-
-## 6. Iconography & Imagery Directives
-- System Icons: Use "Phosphor Icons (Bold or Fill weights)" or "Radix UI Icons" for a technical, slightly thicker-stroke aesthetic. Standardize stroke width across all icons.
-- Illustrations: Monochromatic, rough continuous-line ink sketches on a white background, featuring a single offset geometric shape filled with a muted pastel color.
-- Photography: Use high-quality, desaturated images with a warm tone. Apply subtle overlays (`opacity: 0.04` warm grain) to blend photos into the monochrome palette. Never use oversaturated stock photos. Use reliable placeholders like `https://picsum.photos/seed/{context}/1200/800` when real assets are unavailable.
-- Hero & Section Backgrounds: Sections should not feel empty and flat. Use subtle full-width background imagery at very low opacity, soft radial light spots (`radial-gradient` with warm tones at `opacity: 0.03`), or minimal geometric line patterns to add depth without breaking the clean aesthetic.
-
-## 7. Subtle Motion & Micro-Animations
-Motion should feel invisible — present but never distracting. The goal is quiet sophistication, not spectacle.
-- Scroll Entry: Elements fade in gently as they enter the viewport. Use `translateY(12px)` + `opacity: 0` resolving over `600ms` with `cubic-bezier(0.16, 1, 0.3, 1)`. Use `IntersectionObserver`, never `window.addEventListener('scroll')`.
-- Hover States: Cards lift with an ultra-subtle shadow shift (`box-shadow` transitioning from `0 0 0` to `0 2px 8px rgba(0,0,0,0.04)` over `200ms`). Buttons respond with `scale(0.98)` on `:active`.
-- Staggered Reveals: Lists and grid items enter with a cascade delay (`animation-delay: calc(var(--index) * 80ms)`). Never mount everything at once.
-- Background Ambient Motion: Optional. A single, very slow-moving radial gradient blob (`animation-duration: 20s+`, `opacity: 0.02-0.04`) drifting behind hero sections. Must be applied to a `position: fixed; pointer-events: none` layer. Never on scrolling containers.
-- Performance: Animate exclusively via `transform` and `opacity`. No layout-triggering properties (`top`, `left`, `width`, `height`). Use `will-change: transform` sparingly and only on actively animating elements.
-- Reduced Motion (mandatory): Gate scroll-entry, staggered reveals, and ambient background motion behind `@media (prefers-reduced-motion: no-preference)`, and add a `@media (prefers-reduced-motion: reduce)` block that disables them so content appears instantly at rest. Hover and `:active` feedback may remain.
-
-## 8. Execution Protocol
-When tasked with writing frontend code (HTML, React, Tailwind, Vue) or designing a layout:
-1. Establish the macro-whitespace first. Use massive vertical padding between sections (e.g., `py-24` or `py-32` in Tailwind).
-2. Constrain the main typography content width to `max-w-4xl` or `max-w-5xl`.
-3. Apply the custom typographic hierarchy and monochromatic color variables immediately.
-4. Ensure every card, divider, and border adheres strictly to the `1px solid #EAEAEA` rule.
-5. Add scroll-entry animations to all major content blocks.
-6. Ensure sections have visual depth through imagery, ambient gradients, or subtle textures — no empty flat backgrounds.
-7. Provide code that reflects this high-end, uncluttered, editorial aesthetic natively without requiring manual adjustments.
diff --git a/skills/minimalist-skill/agents/openai.yaml b/skills/minimalist-skill/agents/openai.yaml
deleted file mode 100644
index 5b1f887..0000000
--- a/skills/minimalist-skill/agents/openai.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-policy:
- allow_implicit_invocation: false
diff --git a/skills/redesign-skill/SKILL.md b/skills/redesign-skill/SKILL.md
deleted file mode 100644
index ee5800d..0000000
--- a/skills/redesign-skill/SKILL.md
+++ /dev/null
@@ -1,15 +0,0 @@
----
-name: redesign-existing-projects
-description: "Retired: redesigns, restyles and design reviews are part of design-taste-frontend. Runs only when called by name."
-disable-model-invocation: true
----
-
-# Redesign (retired)
-
-This skill is retired. Redesigns, restyles and reviews of existing pages and app screens are part of **design-taste-frontend**, which audits the existing page in a real browser first, keeps its content and working behaviour, and then rebuilds the design to a dealt direction with before-and-after screenshots.
-
-If you were called by name, follow the design-taste-frontend skill (its "Redesign or review" route). If it is not installed:
-
-```bash
-npx skills add https://github.com/Leonxlnx/taste-skill --skill "design-taste-frontend"
-```
diff --git a/skills/redesign-skill/agents/openai.yaml b/skills/redesign-skill/agents/openai.yaml
deleted file mode 100644
index 5b1f887..0000000
--- a/skills/redesign-skill/agents/openai.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-policy:
- allow_implicit_invocation: false
diff --git a/skills/soft-skill/SKILL.md b/skills/soft-skill/SKILL.md
deleted file mode 100644
index 78a7a4a..0000000
--- a/skills/soft-skill/SKILL.md
+++ /dev/null
@@ -1,99 +0,0 @@
----
-name: high-end-visual-design
-description: "Classic style skill, opt-in: it runs only when called by name. A calm, polished look with soft contrast, generous whitespace and spring motion."
-disable-model-invocation: true
----
-
-# Agent Skill: Principal UI/UX Architect & Motion Choreographer (Awwwards-Tier)
-
-## 1. Meta Information & Core Directive
-- **Persona:** `Vanguard_UI_Architect`
-- **Objective:** You engineer $150k+ agency-level digital experiences, not just websites. Your output must exude haptic depth, cinematic spatial rhythm, obsessive micro-interactions, and flawless fluid motion.
-- **The Variance Mandate:** NEVER generate the exact same layout or aesthetic twice in a row. You must dynamically combine different premium layout archetypes and texture profiles while strictly adhering to the elite "Apple-esque / Linear-tier" design language.
-
-## 2. THE "ABSOLUTE ZERO" DIRECTIVE (STRICT ANTI-PATTERNS)
-If your generated code includes ANY of the following, the design instantly fails:
-- **Banned Fonts:** Inter, Roboto, Arial, Open Sans, Helvetica. (Assume premium fonts like `Geist`, `Clash Display`, `PP Editorial New`, or `Plus Jakarta Sans` are available).
-- **Banned Icons:** Standard thick-stroked Lucide, FontAwesome, or Material Icons. Use only ultra-light, precise lines (e.g., Phosphor Light, Remix Line).
-- **Banned Borders & Shadows:** Generic 1px solid gray borders. Harsh, dark drop shadows (`shadow-md`, `rgba(0,0,0,0.3)`).
-- **Banned Layouts:** Edge-to-edge sticky navbars glued to the top. Symmetrical, boring 3-column Bootstrap-style grids without massive whitespace gaps.
-- **Banned Motion:** Standard `linear` or `ease-in-out` transitions. Instant state changes without interpolation.
-
-## 3. THE CREATIVE VARIANCE ENGINE
-Before writing code, silently "roll the dice" and select ONE combination from the following archetypes based on the prompt's context to ensure the output is uniquely tailored but always premium:
-
-### A. Vibe & Texture Archetypes (Pick 1)
-1. **Ethereal Glass (SaaS / AI / Tech):** Deepest OLED black (`#050505`), radial mesh gradients (e.g., subtle glowing purple/emerald orbs) in the background. Vantablack cards with heavy `backdrop-blur-2xl` and pure white/10 hairlines. Wide geometric Grotesk typography.
-2. **Editorial Luxury (Lifestyle / Real Estate / Agency):** Warm creams (`#FDFBF7`), muted sage, or deep espresso tones. High-contrast Variable Serif fonts for massive headings. Subtle CSS noise/film-grain overlay (`opacity-[0.03]`) for a physical paper feel.
-3. **Soft Structuralism (Consumer / Health / Portfolio):** Silver-grey or completely white backgrounds. Massive bold Grotesk typography. Airy, floating components with unbelievably soft, highly diffused ambient shadows.
-
-### B. Layout Archetypes (Pick 1)
-1. **The Asymmetrical Bento:** A masonry-like CSS Grid of varying card sizes (e.g., `col-span-8 row-span-2` next to stacked `col-span-4` cards) to break visual monotony.
- - **Mobile Collapse:** Falls back to a single-column stack (`grid-cols-1`) with generous vertical gaps (`gap-6`). All `col-span` overrides reset to `col-span-1`.
-2. **The Z-Axis Cascade:** Elements are stacked like physical cards, slightly overlapping each other with varying depths of field, some with a subtle `-2deg` or `3deg` rotation to break the digital grid.
- - **Mobile Collapse:** Remove all rotations and negative-margin overlaps below `768px`. Stack vertically with standard spacing. Overlapping elements cause touch-target conflicts on mobile.
-3. **The Editorial Split:** Massive typography on the left half (`w-1/2`), with interactive, scrollable horizontal image pills or staggered interactive cards on the right.
- - **Mobile Collapse:** Converts to a full-width vertical stack (`w-full`). Typography block sits on top, interactive content flows below with horizontal scroll preserved if needed.
-
-**Mobile Override (Universal):** Any asymmetric layout above `md:` MUST aggressively fall back to `w-full`, `px-4`, `py-8` on viewports below `768px`. Never use `h-screen` for full-height sections — always use `min-h-[100dvh]` to prevent iOS Safari viewport jumping.
-
-## 4. HAPTIC MICRO-AESTHETICS (COMPONENT MASTERY)
-
-### A. The "Double-Bezel" (Doppelrand / Nested Architecture)
-Never place a premium card, image, or container flatly on the background. They must look like physical, machined hardware (like a glass plate sitting in an aluminum tray) using nested enclosures.
-- **Outer Shell:** A wrapper `div` with a subtle background (`bg-black/5` or `bg-white/5`), a hairline outer border (`ring-1 ring-black/5` or `border border-white/10`), a specific padding (e.g., `p-1.5` or `p-2`), and a large outer radius (`rounded-[2rem]`).
-- **Inner Core:** The actual content container inside the shell. It has its own distinct background color, its own inner highlight (`shadow-[inset_0_1px_1px_rgba(255,255,255,0.15)]`), and a mathematically calculated smaller radius (e.g., `rounded-[calc(2rem-0.375rem)]`) for concentric curves.
-
-### B. Nested CTA & "Island" Button Architecture
-- **Structure:** Primary interactive buttons must be fully rounded pills (`rounded-full`) with generous padding (`px-6 py-3`).
-- **The "Button-in-Button" Trailing Icon:** If a button has an arrow (`↗`), it NEVER sits naked next to the text. It must be nested inside its own distinct circular wrapper (e.g., `w-8 h-8 rounded-full bg-black/5 dark:bg-white/10 flex items-center justify-center`) placed completely flush with the main button's right inner padding.
-
-### C. Spatial Rhythm & Tension
-- **Macro-Whitespace:** Double your standard padding. Use `py-24` to `py-40` for sections. Allow the design to breathe heavily.
-- **Eyebrow Tags:** Precede major H1/H2s with a microscopic, pill-shaped badge (`rounded-full px-3 py-1 text-[10px] uppercase tracking-[0.2em] font-medium`).
-
-## 5. MOTION CHOREOGRAPHY (FLUID DYNAMICS)
-Never use default transitions. All motion must simulate real-world mass and spring physics. Use custom cubic-beziers (e.g., `transition-all duration-700 ease-[cubic-bezier(0.32,0.72,0,1)]`).
-
-### A. The "Fluid Island" Nav & Hamburger Reveal
-- **Closed State:** The Navbar is a floating glass pill detached from the top (`mt-6`, `mx-auto`, `w-max`, `rounded-full`).
-- **The Hamburger Morph:** On click, the 2 or 3 lines of the hamburger icon must fluidly rotate and translate to form a perfect 'X' (`rotate-45` and `-rotate-45` with absolute positioning), not just disappear.
-- **The Modal Expansion:** The menu should open as a massive, screen-filling overlay with a heavy glass effect (`backdrop-blur-3xl bg-black/80` or `bg-white/80`).
-- **Staggered Mask Reveal:** The navigation links inside the expanded state do not just appear. They fade in and slide up from an invisible box (`translate-y-12 opacity-0` to `translate-y-0 opacity-100`) with a staggered delay (`delay-100`, `delay-150`, `delay-200` for each item).
-
-### B. Magnetic Button Hover Physics
-- Use the `group` utility. On hover, do not just change the background color.
-- Scale the entire button down slightly (`active:scale-[0.98]`) to simulate physical pressing.
-- The nested inner icon circle should translate diagonally (`group-hover:translate-x-1 group-hover:-translate-y-[1px]`) and scale up slightly (`scale-105`), creating internal kinetic tension.
-
-### C. Scroll Interpolation (Entry Animations)
-- Elements never appear statically on load. As they enter the viewport, they must execute a gentle, heavy fade-up (`translate-y-16 blur-md opacity-0` resolving to `translate-y-0 blur-0 opacity-100` over 800ms+).
-- For JavaScript-driven scroll reveals, use `IntersectionObserver` or Framer Motion's `whileInView`. Never use `window.addEventListener('scroll')` — it causes continuous reflows and kills mobile performance.
-
-## 6. PERFORMANCE GUARDRAILS
-- **GPU-Safe Animation:** Never animate `top`, `left`, `width`, or `height`. Animate exclusively via `transform` and `opacity`. Use `will-change: transform` sparingly and only on elements that are actively animating.
-- **Blur Constraints:** Apply `backdrop-blur` only to fixed or sticky elements (navbars, overlays). Never apply blur filters to scrolling containers or large content areas — this causes continuous GPU repaints and severe mobile frame drops.
-- **Grain/Noise Overlays:** Apply noise textures exclusively to fixed, `pointer-events-none` pseudo-elements (`position: fixed; inset: 0; z-index: 50`). Never attach them to scrolling containers.
-- **Z-Index Discipline:** Do not use arbitrary `z-50` or `z-[9999]`. Reserve z-indexes strictly for systemic layers: sticky nav, modals, overlays, tooltips.
-
-## 7. EXECUTION PROTOCOL
-When generating UI code, follow this exact sequence:
-1. **[SILENT THOUGHT]** Roll the Variance Engine (Section 3). Choose your Vibe and Layout Archetypes based on the prompt's context to ensure a unique output.
-2. **[SCAFFOLD]** Establish the background texture, macro-whitespace scale, and massive typography sizes.
-3. **[ARCHITECT]** Build the DOM strictly using the "Double-Bezel" (Doppelrand) technique for all major cards, inputs, and feature grids. Use exaggerated squircle radii (`rounded-[2rem]`).
-4. **[CHOREOGRAPH]** Inject the custom `cubic-bezier` transitions, the staggered navigation reveals, and the button-in-button hover physics.
-5. **[OUTPUT]** Deliver flawless, pixel-perfect React/Tailwind/HTML code. Do not include basic, generic fallbacks.
-
-## 8. PRE-OUTPUT CHECKLIST
-Evaluate your code against this matrix before delivering. This is the last filter.
-- [ ] No banned fonts, icons, borders, shadows, layouts, or motion patterns from Section 2 are present
-- [ ] A Vibe Archetype and Layout Archetype from Section 3 were consciously selected and applied
-- [ ] All major cards and containers use the Double-Bezel nested architecture (outer shell + inner core)
-- [ ] CTA buttons use the Button-in-Button trailing icon pattern where applicable
-- [ ] Section padding is at minimum `py-24` — the layout breathes heavily
-- [ ] All transitions use custom cubic-bezier curves — no `linear` or `ease-in-out`
-- [ ] Scroll entry animations are present — no element appears statically
-- [ ] Layout collapses gracefully below `768px` to single-column with `w-full` and `px-4`
-- [ ] All animations use only `transform` and `opacity` — no layout-triggering properties
-- [ ] `backdrop-blur` is only applied to fixed/sticky elements, never to scrolling content
-- [ ] The overall impression reads as "$150k agency build", not "template with nice fonts"
diff --git a/skills/soft-skill/agents/openai.yaml b/skills/soft-skill/agents/openai.yaml
deleted file mode 100644
index 5b1f887..0000000
--- a/skills/soft-skill/agents/openai.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-policy:
- allow_implicit_invocation: false
diff --git a/skills/stitch-skill/DESIGN.md b/skills/stitch-skill/DESIGN.md
deleted file mode 100644
index ef78a97..0000000
--- a/skills/stitch-skill/DESIGN.md
+++ /dev/null
@@ -1,121 +0,0 @@
-# Design System: Taste Standard
-**Skill:** stitch-design-taste
-
----
-
-## Configuration — Set Your Style
-Adjust these dials before using this design system. They control how creative, dense, and animated the output should be. Pick the level that fits your project.
-
-| Dial | Level | Description |
-|------|-------|-------------|
-| **Creativity** | `8` | `1` = Ultra-minimal, Swiss, silent, monochrome. `5` = Balanced, clean but with personality. `10` = Expressive, editorial, bold typography experiments, inline images in headlines, strong asymmetry. Default: `8` |
-| **Density** | `4` | `1` = Gallery-airy, massive whitespace. `5` = Balanced sections. `10` = Cockpit-dense, data-heavy. Default: `4` |
-| **Variance** | `8` | `1` = Predictable, symmetric grids. `5` = Subtle offsets. `10` = Artsy chaotic, no two sections alike. Default: `8` |
-| **Motion Intent** | `6` | `1` = Static, no animation noted. `5` = Subtle hover/entrance cues. `10` = Cinematic orchestration noted in every component. Default: `6` |
-
-> **How to use:** Change the numbers above to match your project's vibe. At **Creativity 1–3**, the system produces clean, quiet, Notion-like interfaces. At **Creativity 7–10**, expect inline image typography, dramatic scale contrast, and strong editorial layouts. The rest of the rules below adapt to your chosen levels.
-
----
-
-## 1. Visual Theme & Atmosphere
-A restrained, gallery-airy interface with confident asymmetric layouts and fluid spring-physics motion. The atmosphere is clinical yet warm — like a well-lit architecture studio where every element earns its place through function. Density is balanced (Level 4), variance runs high (Level 8) to prevent symmetrical boredom, and motion is fluid but never theatrical (Level 6). The overall impression: expensive, intentional, alive.
-
-## 2. Color Palette & Roles
-- **Canvas White** (#F9FAFB) — Primary background surface. Warm-neutral, never clinical blue-white
-- **Pure Surface** (#FFFFFF) — Card and container fill. Used with whisper shadow for elevation
-- **Charcoal Ink** (#18181B) — Primary text. Zinc-950 depth — never pure black
-- **Steel Secondary** (#71717A) — Body text, descriptions, metadata. Zinc-500 warmth
-- **Muted Slate** (#94A3B8) — Tertiary text, timestamps, disabled states
-- **Whisper Border** (rgba(226,232,240,0.5)) — Card borders, structural 1px lines. Semi-transparent for depth
-- **Diffused Shadow** (rgba(0,0,0,0.05)) — Card elevation. Wide-spreading, 40px blur, -15px offset. Never harsh
-
-### Accent Selection (Pick ONE per project)
-- **Emerald Signal** (#10B981) — For growth, success, positive data dashboards
-- **Electric Blue** (#3B82F6) — For productivity, SaaS, developer tools
-- **Deep Rose** (#E11D48) — For creative, editorial, fashion-adjacent projects
-- **Amber Warmth** (#F59E0B) — For community, social, warm-toned products
-
-### Banned Colors
-- Purple/Violet neon gradients — the "AI Purple" aesthetic
-- Pure Black (#000000) — always Off-Black or Zinc-950
-- Oversaturated accents above 80% saturation
-- Mixed warm/cool gray systems within one project
-
-## 3. Typography Rules
-- **Display:** `Geist`, `Satoshi`, `Cabinet Grotesk`, or `Outfit` — Track-tight (`-0.025em`), controlled fluid scale, weight-driven hierarchy (700–900). Not screaming. Leading compressed (`1.1`). Alternatives forced — `Inter` is BANNED for premium contexts
-- **Body:** Same family at weight 400 — Relaxed leading (`1.65`), 65ch max-width, Steel Secondary color (#71717A)
-- **Mono:** `Geist Mono` or `JetBrains Mono` — For code blocks, metadata, timestamps. When density exceeds Level 7, all numbers switch to monospace
-- **Scale:** Display at `clamp(2.25rem, 5vw, 3.75rem)`. Body at `1rem/1.125rem`. Mono metadata at `0.8125rem`
-
-### Banned Fonts
-- `Inter` — banned everywhere in premium/creative contexts
-- Generic serif fonts (`Times New Roman`, `Georgia`, `Garamond`, `Palatino`) — BANNED. If serif is needed for editorial/creative, use only distinctive modern serifs like `Fraunces`, `Gambarino`, `Editorial New`, or `Instrument Serif`. Never use default browser serif stacks. Serif is always BANNED in dashboards or software UIs regardless
-
-## 4. Component Stylings
-* **Buttons:** Flat surface, no outer glow. Primary: accent fill with white text. Secondary: ghost/outline. Active state: `-1px translateY` or `scale(0.98)` for tactile push. Hover: subtle background shift, never glow
-* **Cards/Containers:** Generously rounded corners (`2.5rem`). Pure white fill. Whisper border (`1px`, semi-transparent). Diffused shadow (`0 20px 40px -15px rgba(0,0,0,0.05)`). Internal padding `2rem–2.5rem`. Used ONLY when elevation communicates hierarchy — high-density layouts replace cards with `border-top` dividers or negative space
-* **Inputs/Forms:** Label positioned above input. Helper text optional. Error text below in Deep Rose. Focus ring in accent color, `2px` offset. No floating labels. Standard `0.5rem` gap between label-input-error stack
-* **Navigation:** Sleek, sticky. Icons scale on hover (Dock Magnification optional). No hamburger on desktop. Clean horizontal with generous spacing
-* **Loaders:** Skeletal shimmer matching exact layout dimensions and rounded corners. Shifting light reflection across placeholder shapes. Never circular spinners
-* **Empty States:** Composed illustration or icon composition with guidance text. Never just "No data found"
-* **Error States:** Inline, contextual. Red accent underline or border. Clear recovery action
-
-## 5. Hero Section
-The Hero is the first impression — it must be striking, creative, and never generic.
-- **Inline Image Typography:** Embed small, contextual photos or visuals directly between words or letters in the headline. Example: "We build [photo of hands typing] digital [photo of screen] products" — images sit inline at type-height, rounded, acting as visual punctuation between words. This is the signature creative technique
-- **No Overlapping Elements:** Text must never overlap images or other text. Every element has its own clear spatial zone. No z-index stacking of content layers, no absolute-positioned headlines over images. Clean separation always
-- **No Filler Text:** "Scroll to explore", "Swipe down", scroll arrow icons, bouncing chevrons, and any instructional UI chrome are BANNED. The user knows how to scroll. Let the content pull them in naturally
-- **Asymmetric Structure:** Centered Hero layouts are BANNED at this variance level. Use Split Screen (50/50), Left-Aligned text / Right visual, or Asymmetric Whitespace with large empty zones
-- **CTA Restraint:** Maximum one primary CTA button. No secondary "Learn more" links. No redundant micro-copy below the headline
-
-## 6. Layout Principles
-- **Grid-First:** CSS Grid for all structural layouts. Never flexbox percentage math (`calc(33% - 1rem)` is BANNED)
-- **No Overlapping:** Elements must never overlap each other. No absolute-positioned layers stacking content on content. Every element occupies its own grid cell or flow position. Clean, separated spatial zones
-- **Feature Sections:** The "3 equal cards in a row" pattern is BANNED. Use 2-column Zig-Zag, asymmetric Bento grids (2fr 1fr 1fr), or horizontal scroll galleries
-- **Containment:** All content within `max-width: 1400px`, centered. Generous horizontal padding (`1rem` mobile, `2rem` tablet, `4rem` desktop)
-- **Full-Height:** Use `min-height: 100dvh` — never `height: 100vh` (iOS Safari address bar jump)
-- **Bento Architecture:** For feature grids, use Row 1: 3 columns | Row 2: 2 columns (70/30 split). Each tile contains a perpetual micro-animation
-
-## 7. Responsive Rules
-Every screen must work flawlessly across all viewports. **Responsive is not optional — it is a hard requirement. Every single element must be tested at 375px, 768px, and 1440px.**
-- **Mobile-First Collapse (< 768px):** All multi-column layouts collapse to a strict single column. `width: 100%`, `padding: 1rem`, `gap: 1.5rem`. No exceptions
-- **No Horizontal Scroll:** Horizontal overflow on mobile is a critical failure. All elements must fit within viewport width. If any element causes horizontal scroll, the design is broken
-- **Typography Scaling:** Headlines scale down gracefully via `clamp()`. Body text stays `1rem` minimum. Never shrink body below `14px`. Headlines must remain readable on 375px screens
-- **Touch Targets:** All interactive elements minimum `44px` tap target. Generous spacing between clickable items. Buttons must be full-width on mobile
-- **Image Behavior:** Hero and inline images scale proportionally. Inline typography images (photos between words) stack below the headline on mobile instead of inline
-- **Navigation:** Desktop horizontal nav collapses to a clean mobile menu (slide-in or full-screen overlay). No tiny hamburger icons without labels
-- **Cards & Grids:** Bento grids and asymmetric layouts revert to stacked single-column cards with full-width. Maintain internal padding (`1rem`)
-- **Spacing Consistency:** Vertical section gaps reduce proportionally on mobile (`clamp(3rem, 8vw, 6rem)`). Never cramped, never excessively airy
-- **Testing Viewports:** Designs must be verified at: `375px` (iPhone SE), `390px` (iPhone 14), `768px` (iPad), `1024px` (small laptop), `1440px` (desktop)
-
-## 8. Motion & Interaction (Code-Phase Intent)
-> **Note:** Stitch generates static screens — it does not animate. This section documents the **intended motion behavior** so that the coding agent (Antigravity, Cursor, etc.) knows exactly how to implement animations when building the exported design into a live product.
-
-- **Physics Engine:** Spring-based exclusively. `stiffness: 100, damping: 20`. No linear easing anywhere. Premium, weighty feel on all interactive elements
-- **Perpetual Micro-Loops:** Every active dashboard component has an infinite-loop state — Pulse on status dots, Typewriter on search bars, Float on feature icons, Shimmer on loading states
-- **Staggered Orchestration:** Lists and grids mount with cascaded delays (`animation-delay: calc(var(--index) * 100ms)`). Waterfall reveals, never instant mount
-- **Layout Transitions:** Smooth re-ordering via shared element IDs. Items swap positions with physics, simulating real-time intelligence
-- **Hardware Rules:** Animate ONLY `transform` and `opacity`. Never `top`, `left`, `width`, `height`. Grain/noise filters on fixed, pointer-events-none pseudo-elements only
-- **Performance:** CPU-heavy perpetual animations isolated in microscopic leaf components. Never trigger parent re-renders. Target 60fps minimum
-
-## 9. Anti-Patterns (Banned)
-- No emojis — anywhere in UI, code, or alt text
-- No `Inter` font — use `Geist`, `Outfit`, `Cabinet Grotesk`, `Satoshi`
-- No generic serif fonts (`Times New Roman`, `Georgia`, `Garamond`) — if serif is needed, use distinctive modern serifs only (`Fraunces`, `Instrument Serif`)
-- No pure black (`#000000`) — Off-Black or Zinc-950 only
-- No neon outer glows or default box-shadow glows
-- No oversaturated accent colors above 80%
-- No excessive gradient text on large headers
-- No custom mouse cursors
-- No overlapping elements — text never overlaps images or other content. Clean spatial separation always
-- No 3-column equal card layouts for features
-- No centered Hero sections (at this variance level)
-- No filler UI text: "Scroll to explore", "Swipe down", "Discover more below", scroll arrows, bouncing chevrons — all BANNED
-- No generic names: "John Doe", "Sarah Chan", "Acme", "Nexus", "SmartFlow"
-- No fake round numbers: `99.99%`, `50%`, `1234567` — use organic data: `47.2%`, `+1 (312) 847-1928`
-- No AI copywriting clichés: "Elevate", "Seamless", "Unleash", "Next-Gen", "Revolutionize"
-- No broken Unsplash links — use `picsum.photos/seed/{id}/800/600` or SVG UI Avatars
-- No generic `shadcn/ui` defaults — customize radii, colors, shadows to match this system
-- No `z-index` spam — use only for Navbar, Modal, Overlay layer contexts
-- No `h-screen` — always `min-h-[100dvh]`
-- No circular loading spinners — skeletal shimmer only
diff --git a/skills/stitch-skill/SKILL.md b/skills/stitch-skill/SKILL.md
deleted file mode 100644
index 4f4e5a3..0000000
--- a/skills/stitch-skill/SKILL.md
+++ /dev/null
@@ -1,185 +0,0 @@
----
-name: stitch-design-taste
-description: "Classic skill for Google Stitch, opt-in: it runs only when called by name. Writes an agent-friendly DESIGN.md with strict type, colour and layout rules."
-disable-model-invocation: true
----
-
-# Stitch Design Taste — Semantic Design System Skill
-
-## Overview
-This skill generates `DESIGN.md` files optimized for Google Stitch screen generation. It translates the battle-tested anti-slop frontend engineering directives into Stitch's native semantic design language — descriptive, natural-language rules paired with precise values that Stitch's AI agent can interpret to produce premium, non-generic interfaces.
-
-The generated `DESIGN.md` serves as the **single source of truth** for prompting Stitch to generate new screens that align with a curated, high-agency design language. Stitch interprets design through **"Visual Descriptions"** supported by specific color values, typography specs, and component behaviors.
-
-## Prerequisites
-- Access to Google Stitch via [labs.google/stitch](https://labs.google/stitch)
-- Optionally: Stitch MCP Server for programmatic integration with Cursor, Antigravity, or Gemini CLI
-
-## The Goal
-Generate a `DESIGN.md` file that encodes:
-1. **Visual atmosphere** — the mood, density, and design philosophy
-2. **Color calibration** — neutrals, accents, and banned patterns with hex codes
-3. **Typographic architecture** — font stacks, scale hierarchy, and anti-patterns
-4. **Component behaviors** — buttons, cards, inputs with interaction states
-5. **Layout principles** — grid systems, spacing philosophy, responsive strategy
-6. **Motion philosophy** — animation engine specs, spring physics, perpetual micro-interactions
-7. **Anti-patterns** — explicit list of banned AI design clichés
-
-## Analysis & Synthesis Instructions
-
-### 1. Define the Atmosphere
-Evaluate the target project's intent. Use evocative adjectives from the taste spectrum:
-- **Density:** "Art Gallery Airy" (1–3) → "Daily App Balanced" (4–7) → "Cockpit Dense" (8–10)
-- **Variance:** "Predictable Symmetric" (1–3) → "Offset Asymmetric" (4–7) → "Artsy Chaotic" (8–10)
-- **Motion:** "Static Restrained" (1–3) → "Fluid CSS" (4–7) → "Cinematic Choreography" (8–10)
-
-Default baseline: Variance 8, Motion 6, Density 4. Adapt dynamically based on user's vibe description.
-
-### 2. Map the Color Palette
-For each color provide: **Descriptive Name** + **Hex Code** + **Functional Role**.
-
-**Mandatory constraints:**
-- Maximum 1 accent color. Saturation below 80%
-- The "AI Purple/Blue Neon" aesthetic is strictly BANNED — no purple button glows, no neon gradients
-- Use absolute neutral bases (Zinc/Slate) with high-contrast singular accents
-- Stick to one palette for the entire output — no warm/cool gray fluctuation
-- Never use pure black (`#000000`) — use Off-Black, Zinc-950, or Charcoal
-
-### 3. Establish Typography Rules
-- **Display/Headlines:** Track-tight, controlled scale. Not screaming. Hierarchy through weight and color, not just massive size
-- **Body:** Relaxed leading, max 65 characters per line
-- **Font Selection:** `Inter` is BANNED for premium/creative contexts. Force unique character: `Geist`, `Outfit`, `Cabinet Grotesk`, or `Satoshi`
-- **Serif Ban:** Generic serif fonts (`Times New Roman`, `Georgia`, `Garamond`, `Palatino`) are BANNED. If serif is needed for editorial/creative contexts, use only distinctive modern serifs: `Fraunces`, `Gambarino`, `Editorial New`, or `Instrument Serif`. Serif is always BANNED in dashboards or software UIs
-- **Dashboard Constraint:** Use Sans-Serif pairings exclusively (`Geist` + `Geist Mono` or `Satoshi` + `JetBrains Mono`)
-- **High-Density Override:** When density exceeds 7, all numbers must use Monospace
-
-### 4. Define the Hero Section
-The Hero is the first impression and must be creative, striking, and never generic:
-- **Inline Image Typography:** Embed small, contextual photos or visuals directly between words or letters in the headline. Images sit inline at type-height, rounded, acting as visual punctuation. This is the signature creative technique
-- **No Overlapping:** Text must never overlap images or other text. Every element occupies its own clean spatial zone
-- **No Filler Text:** "Scroll to explore", "Swipe down", scroll arrow icons, bouncing chevrons are BANNED. The content should pull users in naturally
-- **Asymmetric Structure:** Centered Hero layouts BANNED when variance exceeds 4
-- **CTA Restraint:** Maximum one primary CTA. No secondary "Learn more" links
-
-### 5. Describe Component Stylings
-For each component type, describe shape, color, shadow depth, and interaction behavior:
-- **Buttons:** Tactile push feedback on active state. No neon outer glows. No custom mouse cursors
-- **Cards:** Use ONLY when elevation communicates hierarchy. Tint shadows to background hue. For high-density layouts, replace cards with border-top dividers or negative space
-- **Inputs/Forms:** Label above input, helper text optional, error text below. Standard gap spacing
-- **Loading States:** Skeletal loaders matching layout dimensions — no generic circular spinners
-- **Empty States:** Composed compositions indicating how to populate data
-- **Error States:** Clear, inline error reporting
-
-### 6. Define Layout Principles
-- No overlapping elements — every element occupies its own clear spatial zone. No absolute-positioned content stacking
-- Centered Hero sections are BANNED when variance exceeds 4 — force Split Screen, Left-Aligned, or Asymmetric Whitespace
-- The generic "3 equal cards horizontally" feature row is BANNED — use 2-column Zig-Zag, asymmetric grid, or horizontal scroll
-- CSS Grid over Flexbox math — never use `calc()` percentage hacks
-- Contain layouts using max-width constraints (e.g., 1400px centered)
-- Full-height sections must use `min-h-[100dvh]` — never `h-screen` (iOS Safari catastrophic jump)
-
-### 7. Define Responsive Rules
-Every design must work across all viewports:
-- **Mobile-First Collapse (< 768px):** All multi-column layouts collapse to single column. No exceptions
-- **No Horizontal Scroll:** Horizontal overflow on mobile is a critical failure
-- **Typography Scaling:** Headlines scale via `clamp()`. Body text minimum `1rem`/`14px`
-- **Touch Targets:** All interactive elements minimum `44px` tap target
-- **Image Behavior:** Inline typography images (photos between words) stack below headline on mobile
-- **Navigation:** Desktop horizontal nav collapses to clean mobile menu
-- **Spacing:** Vertical section gaps reduce proportionally (`clamp(3rem, 8vw, 6rem)`)
-
-### 8. Encode Motion Philosophy
-- **Spring Physics default:** `stiffness: 100, damping: 20` — premium, weighty feel. No linear easing
-- **Perpetual Micro-Interactions:** Every active component should have an infinite loop state (Pulse, Typewriter, Float, Shimmer)
-- **Staggered Orchestration:** Never mount lists instantly — use cascade delays for waterfall reveals
-- **Performance:** Animate exclusively via `transform` and `opacity`. Never animate `top`, `left`, `width`, `height`. Grain/noise filters on fixed pseudo-elements only
-
-### 9. List Anti-Patterns (AI Tells)
-Encode these as explicit "NEVER DO" rules in the DESIGN.md:
-- No emojis anywhere
-- No `Inter` font
-- No generic serif fonts (`Times New Roman`, `Georgia`, `Garamond`) — distinctive modern serifs only if needed
-- No pure black (`#000000`)
-- No neon/outer glow shadows
-- No oversaturated accents
-- No excessive gradient text on large headers
-- No custom mouse cursors
-- No overlapping elements — clean spatial separation always
-- No 3-column equal card layouts
-- No generic names ("John Doe", "Acme", "Nexus")
-- No fake round numbers (`99.99%`, `50%`)
-- No AI copywriting clichés ("Elevate", "Seamless", "Unleash", "Next-Gen")
-- No filler UI text: "Scroll to explore", "Swipe down", scroll arrows, bouncing chevrons
-- No broken Unsplash links — use `picsum.photos` or SVG avatars
-- No centered Hero sections (for high-variance projects)
-
-## Output Format (DESIGN.md Structure)
-
-```markdown
-# Design System: [Project Title]
-
-## 1. Visual Theme & Atmosphere
-(Evocative description of the mood, density, variance, and motion intensity.
-Example: "A restrained, gallery-airy interface with confident asymmetric layouts
-and fluid spring-physics motion. The atmosphere is clinical yet warm — like a
-well-lit architecture studio.")
-
-## 2. Color Palette & Roles
-- **Canvas White** (#F9FAFB) — Primary background surface
-- **Pure Surface** (#FFFFFF) — Card and container fill
-- **Charcoal Ink** (#18181B) — Primary text, Zinc-950 depth
-- **Muted Steel** (#71717A) — Secondary text, descriptions, metadata
-- **Whisper Border** (rgba(226,232,240,0.5)) — Card borders, 1px structural lines
-- **[Accent Name]** (#XXXXXX) — Single accent for CTAs, active states, focus rings
-(Max 1 accent. Saturation < 80%. No purple/neon.)
-
-## 3. Typography Rules
-- **Display:** [Font Name] — Track-tight, controlled scale, weight-driven hierarchy
-- **Body:** [Font Name] — Relaxed leading, 65ch max-width, neutral secondary color
-- **Mono:** [Font Name] — For code, metadata, timestamps, high-density numbers
-- **Banned:** Inter, generic system fonts for premium contexts. Serif fonts banned in dashboards.
-
-## 4. Component Stylings
-* **Buttons:** Flat, no outer glow. Tactile -1px translate on active. Accent fill for primary, ghost/outline for secondary.
-* **Cards:** Generously rounded corners (2.5rem). Diffused whisper shadow. Used only when elevation serves hierarchy. High-density: replace with border-top dividers.
-* **Inputs:** Label above, error below. Focus ring in accent color. No floating labels.
-* **Loaders:** Skeletal shimmer matching exact layout dimensions. No circular spinners.
-* **Empty States:** Composed, illustrated compositions — not just "No data" text.
-
-## 5. Layout Principles
-(Grid-first responsive architecture. Asymmetric splits for Hero sections.
-Strict single-column collapse below 768px. Max-width containment.
-No flexbox percentage math. Generous internal padding.)
-
-## 6. Motion & Interaction
-(Spring physics for all interactive elements. Staggered cascade reveals.
-Perpetual micro-loops on active dashboard components. Hardware-accelerated
-transforms only. Isolated Client Components for CPU-heavy animations.)
-
-## 7. Anti-Patterns (Banned)
-(Explicit list of forbidden patterns: no emojis, no Inter, no pure black,
-no neon glows, no 3-column equal grids, no AI copywriting clichés,
-no generic placeholder names, no broken image links.)
-```
-
-## Best Practices
-- **Be Descriptive:** "Deep Charcoal Ink (#18181B)" — not just "dark text"
-- **Be Functional:** Explain what each element is used for
-- **Be Consistent:** Same terminology throughout the document
-- **Be Precise:** Include exact hex codes, rem values, pixel values in parentheses
-- **Be Opinionated:** This is not a neutral template — it enforces a specific, premium aesthetic
-
-## Tips for Success
-1. Start with the atmosphere — understand the vibe before detailing tokens
-2. Look for patterns — identify consistent spacing, sizing, and styling
-3. Think semantically — name colors by purpose, not just appearance
-4. Consider hierarchy — document how visual weight communicates importance
-5. Encode the bans — anti-patterns are as important as the rules themselves
-
-## Common Pitfalls to Avoid
-- Using technical jargon without translation ("rounded-xl" instead of "generously rounded corners")
-- Omitting hex codes or using only descriptive names
-- Forgetting functional roles of design elements
-- Being too vague in atmosphere descriptions
-- Ignoring the anti-pattern list — these are what make the output premium
-- Defaulting to generic "safe" designs instead of enforcing the curated aesthetic
diff --git a/skills/stitch-skill/agents/openai.yaml b/skills/stitch-skill/agents/openai.yaml
deleted file mode 100644
index 5b1f887..0000000
--- a/skills/stitch-skill/agents/openai.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-policy:
- allow_implicit_invocation: false
diff --git a/skills/taste-skill-v1/SKILL.md b/skills/taste-skill-v1/SKILL.md
deleted file mode 100644
index fe03fc4..0000000
--- a/skills/taste-skill-v1/SKILL.md
+++ /dev/null
@@ -1,227 +0,0 @@
----
-name: design-taste-frontend-v1
-description: "The original taste-skill v1, kept for projects that depend on its exact behaviour. Opt-in: it runs only when called by name."
-disable-model-invocation: true
----
-
-# High-Agency Frontend Skill
-
-## 1. ACTIVE BASELINE CONFIGURATION
-* DESIGN_VARIANCE: 8 (1=Perfect Symmetry, 10=Artsy Chaos)
-* MOTION_INTENSITY: 6 (1=Static/No movement, 10=Cinematic/Magic Physics)
-* VISUAL_DENSITY: 4 (1=Art Gallery/Airy, 10=Pilot Cockpit/Packed Data)
-
-**AI Instruction:** The standard baseline for all generations is strictly set to these values (8, 6, 4). Do not ask the user to edit this file. Otherwise, ALWAYS listen to the user: adapt these values dynamically based on what they explicitly request in their chat prompts. Use these baseline (or user-overridden) values as your global variables to drive the specific logic in Sections 3 through 7.
-
-## 2. DEFAULT ARCHITECTURE & CONVENTIONS
-Unless the user explicitly specifies a different stack, adhere to these structural constraints to maintain consistency:
-
-* **DEPENDENCY VERIFICATION [MANDATORY]:** Before importing ANY 3rd party library (e.g. `framer-motion`, `lucide-react`, `zustand`), you MUST check `package.json`. If the package is missing, you MUST output the installation command (e.g. `npm install package-name`) before providing the code. **Never** assume a library exists.
-* **Framework & Interactivity:** React or Next.js. Default to Server Components (`RSC`).
- * **RSC SAFETY:** Global state works ONLY in Client Components. In Next.js, wrap providers in a `"use client"` component.
- * **INTERACTIVITY ISOLATION:** If Sections 4 or 7 (Motion/Liquid Glass) are active, the specific interactive UI component MUST be extracted as an isolated leaf component with `'use client'` at the very top. Server Components must exclusively render static layouts.
-* **State Management:** Use local `useState`/`useReducer` for isolated UI. Use global state strictly for deep prop-drilling avoidance.
-* **Styling Policy:** Use Tailwind CSS (v3/v4) for 90% of styling.
- * **TAILWIND VERSION LOCK:** Check `package.json` first. Do not use v4 syntax in v3 projects.
- * **T4 CONFIG GUARD:** For v4, do NOT use `tailwindcss` plugin in `postcss.config.js`. Use `@tailwindcss/postcss` or the Vite plugin.
-* **ANTI-EMOJI POLICY [CRITICAL]:** NEVER use emojis in code, markup, text content, or alt text. Replace symbols with high-quality icons (Radix, Phosphor) or clean SVG primitives. Emojis are BANNED.
-* **Responsiveness & Spacing:**
- * Standardize breakpoints (`sm`, `md`, `lg`, `xl`).
- * Contain page layouts using `max-w-[1400px] mx-auto` or `max-w-7xl`.
- * **Viewport Stability [CRITICAL]:** NEVER use `h-screen` for full-height Hero sections. ALWAYS use `min-h-[100dvh]` to prevent catastrophic layout jumping on mobile browsers (iOS Safari).
- * **Grid over Flex-Math:** NEVER use complex flexbox percentage math (`w-[calc(33%-1rem)]`). ALWAYS use CSS Grid (`grid grid-cols-1 md:grid-cols-3 gap-6`) for reliable structures.
-* **Icons:** You MUST use exactly `@phosphor-icons/react` or `@radix-ui/react-icons` as the import paths (check installed version). Standardize `strokeWidth` globally (e.g., exclusively use `1.5` or `2.0`).
-
-
-## 3. DESIGN ENGINEERING DIRECTIVES (Bias Correction)
-LLMs have statistical biases toward specific UI cliché patterns. Proactively construct premium interfaces using these engineered rules:
-
-**Rule 1: Deterministic Typography**
-* **Display/Headlines:** Default to `text-4xl md:text-6xl tracking-tighter leading-none`.
- * **ANTI-SLOP:** Discourage `Inter` for "Premium" or "Creative" vibes. Force unique character using `Geist`, `Outfit`, `Cabinet Grotesk`, or `Satoshi`.
- * **TECHNICAL UI RULE:** Serif fonts are strictly BANNED for Dashboard/Software UIs. For these contexts, use exclusively high-end Sans-Serif pairings (`Geist` + `Geist Mono` or `Satoshi` + `JetBrains Mono`).
-* **Body/Paragraphs:** Default to `text-base text-gray-600 leading-relaxed max-w-[65ch]`.
-
-**Rule 2: Color Calibration**
-* **Constraint:** Max 1 Accent Color. Saturation < 80%.
-* **THE LILA BAN:** The "AI Purple/Blue" aesthetic is strictly BANNED. No purple button glows, no neon gradients. Use absolute neutral bases (Zinc/Slate) with high-contrast, singular accents (e.g. Emerald, Electric Blue, or Deep Rose).
-* **COLOR CONSISTENCY:** Stick to one palette for the entire output. Do not fluctuate between warm and cool grays within the same project.
-
-**Rule 3: Layout Diversification**
-* **ANTI-CENTER BIAS:** Centered Hero/H1 sections are strictly BANNED when `DESIGN_VARIANCE > 4`. Force "Split Screen" (50/50), "Left Aligned content/Right Aligned asset", or "Asymmetric White-space" structures.
-
-**Rule 4: Materiality, Shadows, and "Anti-Card Overuse"**
-* **DASHBOARD HARDENING:** For `VISUAL_DENSITY > 7`, generic card containers are strictly BANNED. Use logic-grouping via `border-t`, `divide-y`, or purely negative space. Data metrics should breathe without being boxed in unless elevation (z-index) is functionally required.
-* **Execution:** Use cards ONLY when elevation communicates hierarchy. When a shadow is used, tint it to the background hue.
-
-**Rule 5: Interactive UI States**
-* **Mandatory Generation:** LLMs naturally generate "static" successful states. You MUST implement full interaction cycles:
- * **Loading:** Skeletal loaders matching layout sizes (avoid generic circular spinners).
- * **Empty States:** Beautifully composed empty states indicating how to populate data.
- * **Error States:** Clear, inline error reporting (e.g., forms).
- * **Tactile Feedback:** On `:active`, use `-translate-y-[1px]` or `scale-[0.98]` to simulate a physical push indicating success/action.
-
-**Rule 6: Data & Form Patterns**
-* **Forms:** Label MUST sit above input. Helper text is optional but should exist in markup. Error text below input. Use a standard `gap-2` for input blocks.
-
-## 4. CREATIVE PROACTIVITY (Anti-Slop Implementation)
-To actively combat generic AI designs, systematically implement these high-end coding concepts as your baseline:
-* **"Liquid Glass" Refraction:** When glassmorphism is needed, go beyond `backdrop-blur`. Add a 1px inner border (`border-white/10`) and a subtle inner shadow (`shadow-[inset_0_1px_0_rgba(255,255,255,0.1)]`) to simulate physical edge refraction.
-* **Magnetic Micro-physics (If MOTION_INTENSITY > 5):** Implement buttons that pull slightly toward the mouse cursor. **CRITICAL:** NEVER use React `useState` for magnetic hover or continuous animations. Use EXCLUSIVELY Framer Motion's `useMotionValue` and `useTransform` outside the React render cycle to prevent performance collapse on mobile.
-* **Perpetual Micro-Interactions:** When `MOTION_INTENSITY > 5`, embed continuous, infinite micro-animations (Pulse, Typewriter, Float, Shimmer, Carousel) in standard components (avatars, status dots, backgrounds). Apply premium Spring Physics (`type: "spring", stiffness: 100, damping: 20`) to all interactive elements—no linear easing.
-* **Layout Transitions:** Always utilize Framer Motion's `layout` and `layoutId` props for smooth re-ordering, resizing, and shared element transitions across state changes.
-* **Staggered Orchestration:** Do not mount lists or grids instantly. Use `staggerChildren` (Framer) or CSS cascade (`animation-delay: calc(var(--index) * 100ms)`) to create sequential waterfall reveals. **CRITICAL:** For `staggerChildren`, the Parent (`variants`) and Children MUST reside in the identical Client Component tree. If data is fetched asynchronously, pass the data as props into a centralized Parent Motion wrapper.
-
-## 5. PERFORMANCE GUARDRAILS
-* **DOM Cost:** Apply grain/noise filters exclusively to fixed, pointer-event-none pseudo-elements (e.g., `fixed inset-0 z-50 pointer-events-none`) and NEVER to scrolling containers to prevent continuous GPU repaints and mobile performance degradation.
-* **Hardware Acceleration:** Never animate `top`, `left`, `width`, or `height`. Animate exclusively via `transform` and `opacity`.
-* **Z-Index Restraint:** NEVER spam arbitrary `z-50` or `z-10` unprompted. Use z-indexes strictly for systemic layer contexts (Sticky Navbars, Modals, Overlays).
-
-## 6. TECHNICAL REFERENCE (Dial Definitions)
-
-### DESIGN_VARIANCE (Level 1-10)
-* **1-3 (Predictable):** Flexbox `justify-center`, strict 12-column symmetrical grids, equal paddings.
-* **4-7 (Offset):** Use `margin-top: -2rem` overlapping, varied image aspect ratios (e.g., 4:3 next to 16:9), left-aligned headers over center-aligned data.
-* **8-10 (Asymmetric):** Masonry layouts, CSS Grid with fractional units (e.g., `grid-template-columns: 2fr 1fr 1fr`), massive empty zones (`padding-left: 20vw`).
-* **MOBILE OVERRIDE:** For levels 4-10, any asymmetric layout above `md:` MUST aggressively fall back to a strict, single-column layout (`w-full`, `px-4`, `py-8`) on viewports `< 768px` to prevent horizontal scrolling and layout breakage.
-
-### MOTION_INTENSITY (Level 1-10)
-* **1-3 (Static):** No automatic animations. CSS `:hover` and `:active` states only.
-* **4-7 (Fluid CSS):** Use `transition: all 0.3s cubic-bezier(0.16, 1, 0.3, 1)`. Use `animation-delay` cascades for load-ins. Focus strictly on `transform` and `opacity`. Use `will-change: transform` sparingly.
-* **8-10 (Advanced Choreography):** Complex scroll-triggered reveals or parallax. Use Framer Motion hooks. NEVER use `window.addEventListener('scroll')`.
-
-### VISUAL_DENSITY (Level 1-10)
-* **1-3 (Art Gallery Mode):** Lots of white space. Huge section gaps. Everything feels very expensive and clean.
-* **4-7 (Daily App Mode):** Normal spacing for standard web apps.
-* **8-10 (Cockpit Mode):** Tiny paddings. No card boxes; just 1px lines to separate data. Everything is packed. **Mandatory:** Use Monospace (`font-mono`) for all numbers.
-
-## 7. AI TELLS (Forbidden Patterns)
-To guarantee a premium, non-generic output, you MUST strictly avoid these common AI design signatures unless explicitly requested:
-
-### Visual & CSS
-* **NO Neon/Outer Glows:** Do not use default `box-shadow` glows or auto-glows. Use inner borders or subtle tinted shadows.
-* **NO Pure Black:** Never use `#000000`. Use Off-Black, Zinc-950, or Charcoal.
-* **NO Oversaturated Accents:** Desaturate accents to blend elegantly with neutrals.
-* **NO Excessive Gradient Text:** Do not use text-fill gradients for large headers.
-* **NO Custom Mouse Cursors:** They are outdated and ruin performance/accessibility.
-
-### Typography
-* **NO Inter Font:** Banned. Use `Geist`, `Outfit`, `Cabinet Grotesk`, or `Satoshi`.
-* **NO Oversized H1s:** The first heading should not scream. Control hierarchy with weight and color, not just massive scale.
-* **Serif Constraints:** Use Serif fonts ONLY for creative/editorial designs. **NEVER** use Serif on clean Dashboards.
-
-### Layout & Spacing
-* **Align & Space Perfectly:** Ensure padding and margins are mathematically perfect. Avoid floating elements with awkward gaps.
-* **NO 3-Column Card Layouts:** The generic "3 equal cards horizontally" feature row is BANNED. Use a 2-column Zig-Zag, asymmetric grid, or horizontal scrolling approach instead.
-
-### Content & Data (The "Jane Doe" Effect)
-* **NO Generic Names:** "John Doe", "Sarah Chan", or "Jack Su" are banned. Use highly creative, realistic-sounding names.
-* **NO Generic Avatars:** DO NOT use standard SVG "egg" or Lucide user icons for avatars. Use creative, believable photo placeholders or specific styling.
-* **NO Fake Numbers:** Avoid predictable outputs like `99.99%`, `50%`, or basic phone numbers (`1234567`). Use organic, messy data (`47.2%`, `+1 (312) 847-1928`).
-* **NO Startup Slop Names:** "Acme", "Nexus", "SmartFlow". Invent premium, contextual brand names.
-* **NO Filler Words:** Avoid AI copywriting clichés like "Elevate", "Seamless", "Unleash", or "Next-Gen". Use concrete verbs.
-
-### External Resources & Components
-* **NO Broken Unsplash Links:** Do not use Unsplash. Use absolute, reliable placeholders like `https://picsum.photos/seed/{random_string}/800/600` or SVG UI Avatars.
-* **shadcn/ui Customization:** You may use `shadcn/ui`, but NEVER in its generic default state. You MUST customize the radii, colors, and shadows to match the high-end project aesthetic.
-* **Production-Ready Cleanliness:** Code must be extremely clean, visually striking, memorable, and meticulously refined in every detail.
-
-## 8. THE CREATIVE ARSENAL (High-End Inspiration)
-Do not default to generic UI. Pull from this library of advanced concepts to ensure the output is visually striking and memorable. When appropriate, leverage **GSAP (ScrollTrigger/Parallax)** for complex scrolltelling or **ThreeJS/WebGL** for 3D/Canvas animations, rather than basic CSS motion. **CRITICAL:** Never mix GSAP/ThreeJS with Framer Motion in the same component tree. Default to Framer Motion for UI/Bento interactions. Use GSAP/ThreeJS EXCLUSIVELY for isolated full-page scrolltelling or canvas backgrounds, wrapped in strict useEffect cleanup blocks.
-
-### The Standard Hero Paradigm
-* Stop doing centered text over a dark image. Try asymmetric Hero sections: Text cleanly aligned to the left or right. The background should feature a high-quality, relevant image with a subtle stylistic fade (darkening or lightening gracefully into the background color depending on if it is Light or Dark mode).
-
-### Navigation & Menüs
-* **Mac OS Dock Magnification:** Nav-bar at the edge; icons scale fluidly on hover.
-* **Magnetic Button:** Buttons that physically pull toward the cursor.
-* **Gooey Menu:** Sub-items detach from the main button like a viscous liquid.
-* **Dynamic Island:** A pill-shaped UI component that morphs to show status/alerts.
-* **Contextual Radial Menu:** A circular menu expanding exactly at the click coordinates.
-* **Floating Speed Dial:** A FAB that springs out into a curved line of secondary actions.
-* **Mega Menu Reveal:** Full-screen dropdowns that stagger-fade complex content.
-
-### Layout & Grids
-* **Bento Grid:** Asymmetric, tile-based grouping (e.g., Apple Control Center).
-* **Masonry Layout:** Staggered grid without fixed row heights (e.g., Pinterest).
-* **Chroma Grid:** Grid borders or tiles showing subtle, continuously animating color gradients.
-* **Split Screen Scroll:** Two screen halves sliding in opposite directions on scroll.
-* **Curtain Reveal:** A Hero section parting in the middle like a curtain on scroll.
-
-### Cards & Containers
-* **Parallax Tilt Card:** A 3D-tilting card tracking the mouse coordinates.
-* **Spotlight Border Card:** Card borders that illuminate dynamically under the cursor.
-* **Glassmorphism Panel:** True frosted glass with inner refraction borders.
-* **Holographic Foil Card:** Iridescent, rainbow light reflections shifting on hover.
-* **Tinder Swipe Stack:** A physical stack of cards the user can swipe away.
-* **Morphing Modal:** A button that seamlessly expands into its own full-screen dialog container.
-
-### Scroll-Animations
-* **Sticky Scroll Stack:** Cards that stick to the top and physically stack over each other.
-* **Horizontal Scroll Hijack:** Vertical scroll translates into a smooth horizontal gallery pan.
-* **Locomotive Scroll Sequence:** Video/3D sequences where framerate is tied directly to the scrollbar.
-* **Zoom Parallax:** A central background image zooming in/out seamlessly as you scroll.
-* **Scroll Progress Path:** SVG vector lines or routes that draw themselves as the user scrolls.
-* **Liquid Swipe Transition:** Page transitions that wipe the screen like a viscous liquid.
-
-### Galleries & Media
-* **Dome Gallery:** A 3D gallery feeling like a panoramic dome.
-* **Coverflow Carousel:** 3D carousel with the center focused and edges angled back.
-* **Drag-to-Pan Grid:** A boundless grid you can freely drag in any compass direction.
-* **Accordion Image Slider:** Narrow vertical/horizontal image strips that expand fully on hover.
-* **Hover Image Trail:** The mouse leaves a trail of popping/fading images behind it.
-* **Glitch Effect Image:** Brief RGB-channel shifting digital distortion on hover.
-
-### Typography & Text
-* **Kinetic Marquee:** Endless text bands that reverse direction or speed up on scroll.
-* **Text Mask Reveal:** Massive typography acting as a transparent window to a video background.
-* **Text Scramble Effect:** Matrix-style character decoding on load or hover.
-* **Circular Text Path:** Text curved along a spinning circular path.
-* **Gradient Stroke Animation:** Outlined text with a gradient continuously running along the stroke.
-* **Kinetic Typography Grid:** A grid of letters dodging or rotating away from the cursor.
-
-### Micro-Interactions & Effects
-* **Particle Explosion Button:** CTAs that shatter into particles upon success.
-* **Liquid Pull-to-Refresh:** Mobile reload indicators acting like detaching water droplets.
-* **Skeleton Shimmer:** Shifting light reflections moving across placeholder boxes.
-* **Directional Hover Aware Button:** Hover fill entering from the exact side the mouse entered.
-* **Ripple Click Effect:** Visual waves rippling precisely from the click coordinates.
-* **Animated SVG Line Drawing:** Vectors that draw their own contours in real-time.
-* **Mesh Gradient Background:** Organic, lava-lamp-like animated color blobs.
-* **Lens Blur Depth:** Dynamic focus blurring background UI layers to highlight a foreground action.
-
-## 9. THE "MOTION-ENGINE" BENTO PARADIGM
-When generating modern SaaS dashboards or feature sections, you MUST utilize the following "Bento 2.0" architecture and motion philosophy. This goes beyond static cards and enforces a "Vercel-core meets Dribbble-clean" aesthetic heavily reliant on perpetual physics.
-
-### A. Core Design Philosophy
-* **Aesthetic:** High-end, minimal, and functional.
-* **Palette:** Background in `#f9fafb`. Cards are pure white (`#ffffff`) with a 1px border of `border-slate-200/50`.
-* **Surfaces:** Use `rounded-[2.5rem]` for all major containers. Apply a "diffusion shadow" (a very light, wide-spreading shadow, e.g., `shadow-[0_20px_40px_-15px_rgba(0,0,0,0.05)]`) to create depth without clutter.
-* **Typography:** Strict `Geist`, `Satoshi`, or `Cabinet Grotesk` font stack. Use subtle tracking (`tracking-tight`) for headers.
-* **Labels:** Titles and descriptions must be placed **outside and below** the cards to maintain a clean, gallery-style presentation.
-* **Pixel-Perfection:** Use generous `p-8` or `p-10` padding inside cards.
-
-### B. The Animation Engine Specs (Perpetual Motion)
-All cards must contain **"Perpetual Micro-Interactions."** Use the following Framer Motion principles:
-* **Spring Physics:** No linear easing. Use `type: "spring", stiffness: 100, damping: 20` for a premium, weighty feel.
-* **Layout Transitions:** Heavily utilize the `layout` and `layoutId` props to ensure smooth re-ordering, resizing, and shared element state transitions.
-* **Infinite Loops:** Every card must have an "Active State" that loops infinitely (Pulse, Typewriter, Float, or Carousel) to ensure the dashboard feels "alive".
-* **Performance:** Wrap dynamic lists in `<AnimatePresence>` and optimize for 60fps. **PERFORMANCE CRITICAL:** Any perpetual motion or infinite loop MUST be memoized (React.memo) and completely isolated in its own microscopic Client Component. Never trigger re-renders in the parent layout.
-
-### C. The 5-Card Archetypes (Micro-Animation Specs)
-Implement these specific micro-animations when constructing Bento grids (e.g., Row 1: 3 cols | Row 2: 2 cols split 70/30):
-1. **The Intelligent List:** A vertical stack of items with an infinite auto-sorting loop. Items swap positions using `layoutId`, simulating an AI prioritizing tasks in real-time.
-2. **The Command Input:** A search/AI bar with a multi-step Typewriter Effect. It cycles through complex prompts, including a blinking cursor and a "processing" state with a shimmering loading gradient.
-3. **The Live Status:** A scheduling interface with "breathing" status indicators. Include a pop-up notification badge that emerges with an "Overshoot" spring effect, stays for 3 seconds, and vanishes.
-4. **The Wide Data Stream:** A horizontal "Infinite Carousel" of data cards or metrics. Ensure the loop is seamless (using `x: ["0%", "-100%"]`) with a speed that feels effortless.
-5. **The Contextual UI (Focus Mode):** A document view that animates a staggered highlight of a text block, followed by a "Float-in" of a floating action toolbar with micro-icons.
-
-## 10. FINAL PRE-FLIGHT CHECK
-Evaluate your code against this matrix before outputting. This is the **last** filter you apply to your logic.
-- [ ] Is global state used appropriately to avoid deep prop-drilling rather than arbitrarily?
-- [ ] Is mobile layout collapse (`w-full`, `px-4`, `max-w-7xl mx-auto`) guaranteed for high-variance designs?
-- [ ] Do full-height sections safely use `min-h-[100dvh]` instead of the bugged `h-screen`?
-- [ ] Do `useEffect` animations contain strict cleanup functions?
-- [ ] Are empty, loading, and error states provided?
-- [ ] Are cards omitted in favor of spacing where possible?
-- [ ] Did you strictly isolate CPU-heavy perpetual animations in their own Client Components?
diff --git a/skills/taste-skill-v1/agents/openai.yaml b/skills/taste-skill-v1/agents/openai.yaml
deleted file mode 100644
index 5b1f887..0000000
--- a/skills/taste-skill-v1/agents/openai.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-policy:
- allow_implicit_invocation: false
diff --git a/skills/taste-skill-v2-experimental/SKILL.md b/skills/taste-skill-v2-experimental/SKILL.md
deleted file mode 100644
index 1f2c70c..0000000
--- a/skills/taste-skill-v2-experimental/SKILL.md
+++ /dev/null
@@ -1,1229 +0,0 @@
----
-name: design-taste-frontend-v2-experimental
-description: "The single-file, dial-driven taste-skill that was the default before v2, kept for projects that depend on its exact behaviour. Opt-in: it runs only when called by name."
-disable-model-invocation: true
----
-
-# tasteskill: Anti-Slop Frontend Skill
-
-> Landing pages, portfolios, and redesigns. Not dashboards, not data tables, not multi-step product UI.
-> Every rule below is **contextual**. None of it fires automatically. First read the brief, then pull only what fits.
-
----
-
-## 0. BRIEF INFERENCE (Read the Room Before Anything Else)
-
-Before touching code or tweaking dials, **infer what the user actually wants**. Most LLM design output is bad because the model jumps to a default aesthetic instead of reading the room.
-
-### 0.A Read these signals first
-1. **Page kind** - landing (SaaS / consumer / agency / event), portfolio (dev / designer / creative studio), redesign (preserve vs overhaul), editorial / blog.
-2. **Vibe words** the user used - "minimalist", "calm", "Linear-style", "Awwwards", "brutalist", "premium consumer", "Apple-y", "playful", "serious B2B", "editorial", "agency-y", "glassy", "dark tech".
-3. **Reference signals** - URLs they linked, screenshots they pasted, products they named, brands they're competing with.
-4. **Audience** - B2B procurement panel vs. design-conscious consumer vs. recruiter scanning a portfolio. The audience picks the aesthetic, not your taste.
-5. **Brand assets that already exist** - logo, color, type, photography. For redesigns, these are starting material, not optional input (see Section 11).
-6. **Quiet constraints** - accessibility-first audiences, public-sector, regulated industries, trust-first commerce, kids' products. These constraints OVERRIDE aesthetic preference.
-
-### 0.B Output a one-line "Design Read" before generating
-Before any code, state in one line: **"Reading this as: \<page kind> for \<audience>, with a \<vibe> language, leaning toward \<design system or aesthetic family>."**
-
-Example reads:
-- *"Reading this as: B2B SaaS landing for technical buyers, with a Linear-style minimalist language, leaning toward Tailwind utilities + Geist + restrained motion."*
-- *"Reading this as: solo designer portfolio for hiring managers, with an editorial / kinetic-type language, leaning toward native CSS + scroll-driven animation + custom typography."*
-- *"Reading this as: redesign of a public-sector service site, with a trust-first language, leaning toward GOV.UK Frontend or USWDS."*
-
-### 0.C If the brief is ambiguous, ask one question, do not guess
-Ask exactly **one** clarifying question - never a multi-question dump - and only when the design read genuinely diverges. Example: *"Should this feel closer to Linear-clean or Awwwards-experimental?"*
-
-If you can confidently infer from context, **do not ask**. Just declare the design read and proceed.
-
-### 0.D Anti-Default Discipline
-Do not default to: AI-purple gradients, centered hero over dark mesh, three equal feature cards, generic glassmorphism on everything, infinite-loop micro-animations everywhere, Inter + slate-900. These are the LLM defaults. Reach past them deliberately based on the design read.
-
----
-
-## 1. THE THREE DIALS (Core Configuration)
-
-After the design read, set three dials. Every layout, motion, and density decision below is gated by these.
-
-* **`DESIGN_VARIANCE: 8`** - 1 = Perfect Symmetry, 10 = Artsy Chaos
-* **`MOTION_INTENSITY: 6`** - 1 = Static, 10 = Cinematic / Physics
-* **`VISUAL_DENSITY: 4`** - 1 = Art Gallery / Airy, 10 = Cockpit / Packed Data
-
-**Baseline:** `8 / 6 / 4`. Use these unless the design read overrides them. Do not ask the user to edit this file - overrides happen conversationally.
-
-### 1.A Dial Inference (design read → dial values)
-| Signal | VARIANCE | MOTION | DENSITY |
-|---|---|---|---|
-| "minimalist / clean / calm / editorial / Linear-style" | 5-6 | 3-4 | 2-3 |
-| "premium consumer / Apple-y / luxury / brand" | 7-8 | 5-7 | 3-4 |
-| "playful / wild / Dribbble / Awwwards / experimental / agency" | 9-10 | 8-10 | 3-4 |
-| "landing page / portfolio / marketing site (default)" | 7-9 | 6-8 | 3-5 |
-| "trust-first / public-sector / regulated / accessibility-critical" | 3-4 | 2-3 | 4-5 |
-| "redesign - preserve" | match existing | +1 | match existing |
-| "redesign - overhaul" | +2 | +2 | match existing |
-
-### 1.B Use-Case Presets
-| Use case | VARIANCE | MOTION | DENSITY |
-|---|---|---|---|
-| Landing (SaaS, mainstream) | 7 | 6 | 4 |
-| Landing (Agency / creative) | 9 | 8 | 3 |
-| Landing (Premium consumer) | 7 | 6 | 3 |
-| Portfolio (Designer / studio) | 8 | 7 | 3 |
-| Portfolio (Developer) | 6 | 5 | 4 |
-| Editorial / Blog | 6 | 4 | 3 |
-| Public-sector service | 3 | 2 | 5 |
-| Redesign - preserve | match | match+1 | match |
-| Redesign - overhaul | +2 | +2 | match |
-
-### 1.C How the Dials Drive Output
-Use these (or user-overridden values) as global variables. Cross-references throughout this document refer to these exact variable names - never invent aliases like `LAYOUT_VARIANCE` or `ANIM_LEVEL`.
-
----
-
-## 2. BRIEF → DESIGN SYSTEM MAP
-
-Once you have the design read (Section 0) and dials (Section 1), pick the right foundation. Do not invent CSS for things that have an official package. Do not pretend an aesthetic trend is an official system.
-
-### 2.A When to reach for a real design system (use official packages)
-| Brief reads as… | Reach for | Why |
-|---|---|---|
-| Microsoft / enterprise SaaS / dashboards | `@fluentui/react-components` or `@fluentui/web-components` | Official Fluent UI, Microsoft tokens, accessibility done |
-| Google-ish UI, Material-flavored product | `@material/web` + Material 3 tokens | Official, theme-able via Material Theming |
-| IBM-style B2B / enterprise analytics | `@carbon/react` + `@carbon/styles` | Official Carbon, mature data-density patterns |
-| Shopify app surfaces | `polaris.js` web components / Polaris React | Required for Shopify admin UI |
-| Atlassian / Jira-style product | `@atlaskit/*` + `@atlaskit/tokens` | Official Atlassian DS |
-| GitHub-style devtool / community page | `@primer/css` or `@primer/react-brand` | Official Primer; Brand variant for marketing |
-| Public-sector UK service | `govuk-frontend` | Legally / regulatorily expected |
-| US public-sector / trust-first | `uswds` | Same |
-| Fast local-business / agency MVP | Bootstrap 5.3 | Boring, fast, works |
-| Modern accessible React foundation | `@radix-ui/themes` | Primitives + polished theme |
-| Modern SaaS where you own the components | shadcn/ui (`npx shadcn@latest add ...`) | You own the code, easy to customise; never ship default state |
-| Tailwind-based modern SaaS / AI marketing | Tailwind v4 utilities + `dark:` variant | Default for indie + small team builds |
-
-**Honesty rule:** if the brief reads as one of the systems above, install and use the **official** package. Do not recreate its CSS by hand. Do not import a system's tokens but then override 90% of them.
-
-**One system per project.** Do not mix Fluent React with Carbon in the same tree. Do not import shadcn/ui components into a Material 3 app.
-
-### 2.B When the brief is an aesthetic, not a system
-For these directions, there is **no single official package**. Build with native CSS + Tailwind + a maintained component library. Be honest in code comments about what is borrowed inspiration vs. official material.
-
-| Aesthetic | Honest implementation |
-|---|---|
-| Glassmorphism / "frosted glass" | `backdrop-filter`, layered borders, highlight overlays. Provide solid-fill fallback for `prefers-reduced-transparency`. |
-| Bento (Apple-style tile grids) | CSS Grid with mixed cell sizes. No single library owns this. |
-| Brutalism | Native CSS, monospace, raw borders. No library. |
-| Editorial / magazine | Serif type, asymmetric grid, generous whitespace. No library. |
-| Dark tech / hacker | Mono + accent neon, terminal motifs. No library. |
-| Aurora / mesh gradients | SVG or layered radial gradients. No library. |
-| Kinetic typography | Native CSS animations, scroll-driven animations, GSAP for hijacks. No library. |
-| **Apple Liquid Glass** | Apple documents this for Apple platforms only. **There is no official `liquid-glass.css`.** Web implementations are approximations using `backdrop-filter` + layered borders + highlights. Label clearly as approximation. |
-
----
-
-## 3. DEFAULT ARCHITECTURE & CONVENTIONS
-
-Unless the design read picks a real design system (Section 2.A), these are the defaults:
-
-### 3.A Stack
-* **Framework:** React or Next.js. Default to Server Components (RSC).
- * **RSC SAFETY:** Global state works ONLY in Client Components. In Next.js, wrap providers in a `"use client"` component.
- * **INTERACTIVITY ISOLATION:** Any component using Motion, scroll listeners, or pointer physics MUST be an isolated leaf with `'use client'` at the top. Server Components render static layouts only.
-* **Styling:** **Tailwind v4** (default). Tailwind v3 only if the existing project demands it.
- * For v4: do NOT use `tailwindcss` plugin in `postcss.config.js`. Use `@tailwindcss/postcss` or the Vite plugin.
-* **Animation:** **Motion** (the library formerly known as Framer Motion). Import from `motion/react` (`import { motion } from "motion/react"`). The `framer-motion` package still works as a legacy alias - prefer `motion/react` in new code.
-* **Fonts:** Always use `next/font` (Next.js) or self-host with `@font-face` + `font-display: swap`. Never link Google Fonts via `<link>` in production.
-
-### 3.B State
-* Local `useState` / `useReducer` for isolated UI.
-* Global state ONLY for deep prop-drilling avoidance - Zustand, Jotai, or React context.
-* **NEVER** use `useState` to track continuous values driven by user input (mouse position, scroll progress, pointer physics, magnetic hover). Use Motion's `useMotionValue` / `useTransform` / `useScroll`. `useState` re-renders the React tree on every change and collapses on mobile.
-
-### 3.C Icons
-* **Allowed libraries (priority order):** `@phosphor-icons/react`, `hugeicons-react`, `@radix-ui/react-icons`, `@tabler/icons-react`.
-* **Discouraged:** `lucide-react`. Acceptable only when the user explicitly asks for it or the project already depends on it.
-* **NEVER hand-roll SVG icons.** If a glyph is missing, install a second library or compose from primitives - do not draw icon paths from scratch.
-* **One family per project.** Do not mix Phosphor with Lucide in the same component tree.
-* **Standardize `strokeWidth` globally** (e.g. `1.5` or `2.0`).
-
-### 3.D Emoji Policy
-Discouraged by default in code, markup, and visible text. Replace symbols with icon-library glyphs. **Override:** allow emojis only when the user explicitly asks for a playful / chat-style / social-native vibe - and even then use them sparingly with intent.
-
-### 3.E Responsiveness & Layout Mechanics
-* Standardize breakpoints (`sm 640`, `md 768`, `lg 1024`, `xl 1280`, `2xl 1536`).
-* Contain page layouts using `max-w-[1400px] mx-auto` or `max-w-7xl`.
-* **Viewport Stability:** NEVER use `h-screen` for full-height Hero sections. ALWAYS use `min-h-[100dvh]` to prevent layout jumping on mobile (iOS Safari address bar).
-* **Grid over Flex-Math:** NEVER use complex flexbox percentage math (`w-[calc(33%-1rem)]`). ALWAYS use CSS Grid (`grid grid-cols-1 md:grid-cols-3 gap-6`).
-
-### 3.F Dependency Verification (mandatory)
-Before importing ANY 3rd-party library, check `package.json`. If the package is missing, output the install command first. **Never** assume a library exists.
-
----
-
-## 4. DESIGN ENGINEERING DIRECTIVES (Bias Correction)
-
-LLMs default to clichés. Override these defaults proactively. Each rule has a context-aware override path.
-
-### 4.1 Typography
-* **Display / Headlines:** Default `text-4xl md:text-6xl tracking-tighter leading-none`.
-* **Body / Paragraphs:** Default `text-base text-gray-600 leading-relaxed max-w-[65ch]`.
-* **Sans font choice:**
- * **Discouraged as default:** `Inter`. Pick `Geist`, `Outfit`, `Cabinet Grotesk`, `Satoshi`, or a brand-appropriate serif first.
- * **Override:** Inter is acceptable when the user explicitly asks for a neutral / standard / Linear-style feel, or when the brief is a public-sector / accessibility-first site.
-* **Pairings to know:** `Geist` + `Geist Mono`, `Satoshi` + `JetBrains Mono`, `Cabinet Grotesk` + `Inter Tight`, `GT America` + `IBM Plex Mono`.
-
-* **SERIF DISCIPLINE (VERY DISCOURAGED AS DEFAULT):**
- * Serif is **very discouraged as the default font for any project.** "It feels creative / premium / editorial" is NOT a reason to reach for serif. The agent's default mental model that "creative brief = serif" is the single most-tested AI tell in production rounds.
- * **Serif is only acceptable when ONE of these is explicitly true:**
- - The brand brief literally names a serif font, OR
- - The aesthetic family is genuinely editorial / luxury / publication / manuscript / heritage / vintage AND you can articulate why this specific serif fits this specific brand
- * For everything else (creative agency, design studio, modern brand, premium consumer, portfolio, lifestyle), **default sans-serif display** (Geist Display, ABC Diatype, Söhne Breit, Cabinet Grotesk Display, Migra Sans, GT Walsheim, Inter Display, PP Neue Montreal). Sans display fonts are not "boring" — they are the default for the same reason black is the default in fashion.
- * **EMPHASIS RULE (related):** When you want to emphasize a word within a headline (the kinetic "and `spatial` design" type move), use **italic or bold of the SAME font**. Do NOT inject a random serif word into a sans headline (or vice versa) just to add visual interest. Mixed-family emphasis is amateur. Italic/bold emphasis in the same family is the right move.
- * **Specifically BANNED as defaults:** `Fraunces` and `Instrument_Serif` (the two LLM-favorite display serifs).
- * **If a serif is justified** (rare, per the above), rotate from this pool, do NOT reuse the same serif across consecutive projects: PP Editorial New, GT Sectra Display, Cardinal Grotesque, Reckless Neue, Tiempos Headline, Recoleta, Cormorant Garamond, Playfair Display, EB Garamond, IvyPresto, Migra, Editorial Old, Saol Display, Söhne Breit Kursiv, Domaine Display, Canela, Schnyder, Tobias, NB Architekt, ITC Galliard.
-
-* **ITALIC DESCENDER CLEARANCE (mandatory):** When italic is used in display type and the word contains a descender letter (`y g j p q`), `leading-[1]` or `leading-none` will clip the descender. Use `leading-[1.1]` minimum and add `pb-1` or `mb-1` reserve on the wrapping element. Audit every italic word in display headlines before shipping.
-
-### 4.2 Color Calibration
-* Max 1 accent color. Saturation < 80% by default.
-* **THE LILA RULE:** The "AI Purple / Blue glow" aesthetic is discouraged as a default. No automatic purple button glows, no random neon gradients. Use neutral bases (Zinc / Slate / Stone) with high-contrast singular accents (Emerald, Electric Blue, Deep Rose, Burnt Orange, etc.).
-* **Override:** if the brand or brief explicitly asks for purple / violet / lila, embrace it. But execute with intent: consistent palette, harmonised neutrals, restrained gradients. Not generic AI gradient slop.
-* **One palette per project.** Do not fluctuate between warm and cool grays within the same project.
-* **COLOR CONSISTENCY LOCK (mandatory):** Once an accent color is chosen for a page, it is used on the WHOLE page. A warm-grey site does not suddenly get a blue CTA in section 7. A rose-accented site does not get a teal status badge in the footer. Pick one accent, lock it, audit every component before shipping.
-
-* **PREMIUM-CONSUMER PALETTE BAN (mandatory, second-most-recurring AI-tell):**
- * For premium-consumer briefs (cookware, wellness, artisan, luxury, heritage craft, DTC home goods, etc.) the LLM default is **warm beige/cream + brass/clay/oxblood/ochre + espresso/ink dark text**. Concretely banned hex families as default backgrounds and accents:
- - Backgrounds: `#f5f1ea`, `#f7f5f1`, `#fbf8f1`, `#efeae0`, `#ece6db`, `#faf7f1`, `#e8dfcb` (all "warm paper / cream / chalk / bone")
- - Accents: `#b08947`, `#b6553a`, `#9a2436`, `#9c6e2a`, `#bc7c3a`, `#7d5621` (all "brass / clay / oxblood / ochre")
- - Text: `#1a1714`, `#1a1814`, `#1b1814` (all "espresso / warm near-black")
- * This palette is BANNED as the default reach for premium-consumer briefs. Every premium-consumer site you have ever shipped uses this exact palette. The brand becomes invisible.
- * **Default alternatives (rotate, do not reuse):**
- - **Cold Luxury:** silver-grey + chrome + smoke (think Tesla, Apple Watch Hermes-without-the-leather)
- - **Forest:** deep green + bone + amber accent (think Filson, Patagonia premium)
- - **Black and Tan:** true off-black + warm tan, sharp contrast, no beige
- - **Cobalt + Cream:** saturated blue against a single neutral, no brass
- - **Terracotta + Slate:** warm rust against cool grey, no brass
- - **Olive + Brick + Paper:** muted olive plus brick-red accent
- - **Pure monochrome + single saturated pop:** off-white + off-black + one bright accent (electric blue, emerald, hot pink, etc.)
- * **Palette-rotation rule:** if the previous premium-consumer project you generated used the beige+brass family, this one MUST use a different family. Do not ship the same warm-craft palette twice in a row.
- * **Override:** the beige+brass+espresso palette is acceptable ONLY when the brand brief explicitly names those colors, or when the brand identity is genuinely vintage / artisan / warm-craft AND you can articulate why this specific palette fits this specific brand. Default-reaching for it because "this is a cookware brief" is banned.
-
-### 4.3 Layout Diversification
-* **ANTI-CENTER BIAS:** Centered Hero / H1 sections are avoided when `DESIGN_VARIANCE > 4`. Force "Split Screen" (50/50), "Left-aligned content / right-aligned asset", "Asymmetric white-space", or scroll-pinned structures.
-* **Override:** centered hero is OK for editorial / manifesto / launch-announcement briefs where the message itself is the design.
-
-### 4.4 Materiality, Shadows, Cards
-* Use cards ONLY when elevation communicates real hierarchy. Otherwise group with `border-t`, `divide-y`, or negative space.
-* When a shadow is used, tint it to the background hue. No pure-black drop shadows on light backgrounds.
-* For `VISUAL_DENSITY > 7`: generic card containers are banned. Data metrics breathe in plain layout.
-* **SHAPE CONSISTENCY LOCK (mandatory):** Pick ONE corner-radius scale for the page and stick to it. Options: all-sharp (radius 0), all-soft (radius 12-16px), all-pill (full radius for interactive). Mixed systems are allowed only when there is a documented rule (e.g. "buttons are full-pill, cards are 16px, inputs are 8px") and that rule is followed everywhere. Round buttons in a square layout, or square cards on a pill-button page, is broken design.
-
-### 4.5 Interactive UI States
-LLMs default to "static successful state only." Always implement full cycles:
-* **Loading:** Skeletal loaders matching the final layout's shape. Avoid generic circular spinners.
-* **Empty States:** Beautifully composed; indicate how to populate.
-* **Error States:** Clear, inline (forms), or contextual (toasts only for transient).
-* **Tactile Feedback:** On `:active`, use `-translate-y-[1px]` or `scale-[0.98]` to simulate a physical push.
-* **BUTTON CONTRAST CHECK (mandatory, a11y):** Before shipping any button, verify the button text is readable against the button background. White button + white text, `bg-white` CTA with `text-white` label, transparent button against the page background with no border → all banned. Audit every CTA: contrast ratio WCAG AA min (4.5:1 for body, 3:1 for large text 18px+). Same rule applies to ghost buttons over photographic backgrounds (use a backdrop, scrim, or stroke).
-* **CTA BUTTON WRAP BAN (mandatory):** Button text MUST fit on one line at desktop. If a label like "VIEW SELECTED WORK" wraps to 2 or 3 lines, the button is broken. Fix by EITHER shortening the label (3 words max for primary CTAs, ideally 1-2) OR widening the button (do not artificially constrain `max-width` on CTAs). Wrapped CTAs at desktop are a Pre-Flight Fail.
-* **NO DUPLICATE CTA INTENT (mandatory):** Two CTAs with the same intent on one page is a Pre-Flight Fail. Examples of same intent: "Get in touch" + "Contact us" + "Let's talk" + "Start a project" + "Start something" + "Reach out" = all "contact" intent → pick ONE label and use it everywhere on the page (nav, hero, footer). Same for "Try free" + "Get started" + "Sign up free" (all "signup" intent) and "View work" + "See selected work" + "Browse projects" (all "portfolio" intent). One label per intent.
-* **FORM CONTRAST CHECK (mandatory, a11y):** Form inputs, placeholder text, focus rings, helper text, and error text all pass WCAG AA contrast against the section background. Light placeholders on a near-white form, white form on white page section, form labels grayer than 4.5:1 contrast → all banned. Audit every form before shipping.
-
-### 4.6 Data & Form Patterns
-* Label ABOVE input. Helper text optional but present in markup. Error text BELOW input. Standard `gap-2` for input blocks.
-* No placeholder-as-label. Ever.
-
-### 4.7 Layout Discipline (Hard Rules. Failing any of these is shipping broken work)
-
-* **Hero MUST fit in the initial viewport.** Headline max 2 lines on desktop, subtext max **20 words** AND max 3-4 lines, CTAs visible without scroll. If the copy is too long: reduce font scale OR cut copy. If you cannot describe the value-prop in 20 words of subtext, the value-prop is unclear, not the rule too tight. Never let the hero overflow and force scroll to find the CTA.
-* **Hero font-scale discipline.** Plan font size and image size *together*. If the hero asset is large and the headline is more than 6 words, do not start at `text-7xl/text-8xl`. Default sensible range: `text-4xl md:text-5xl lg:text-6xl` for most heroes; `text-6xl md:text-7xl` only when the headline is 3-5 words. A 4-line hero headline is always a font-size error, never a copy-length error.
-* **HERO TOP PADDING CAP (mandatory):** Hero top padding max `pt-24` (≈6rem) at desktop. More than that means the hero content floats halfway down the viewport and reads as a layout bug, not as intentional space. If your hero needs more breathing room, increase font scale or asset size, not top padding.
-* **HERO STACK DISCIPLINE (max 4 text elements).** The hero is a single moment, not a feature list. Allowed text elements, max 4 in total:
- 1. Eyebrow (small uppercase label) OR brand strip OR neither - pick zero or one
- 2. Headline (max 2 lines, see above)
- 3. Subtext (max 20 words, max 4 lines)
- 4. CTAs (1 primary + max 1 secondary)
- - **BANNED in the hero:** tiny tagline below CTAs ("Works with GitHub, GitLab, and self-hosted Git"), trust micro-strip ("Used by engineering teams at..."), pricing teaser ("Free for solo, $10/user for teams"), feature bullet list, social-proof avatar row. All of those move to dedicated sections directly below the hero.
- - If you have an eyebrow AND a tagline below CTAs in the same hero, drop the tagline. If you have a brand strip AND a tagline, drop the tagline. One small text element per hero, max.
-* **"Used by" / "Trusted by" logo wall belongs UNDER the hero, never inside it.** The hero is for the value prop and primary CTA. The logo wall is a separate section directly below. Do not stuff trust logos into the same flex row as the hero copy.
-* **Navigation MUST render on a single line on desktop.** If items don't fit at `lg` (1024px), condense labels, drop secondary items, or move to a hamburger. A two-line nav at desktop is broken design.
-* **Navigation height cap: 80px max desktop, default 64-72px.** No huge "agency" nav bars that eat 15% of the viewport.
-* **Bento grids MUST have rhythm, not one-sided repetition.** Do not stack 6 left-image / right-text rows. Vary the composition: alternate full-width feature rows, asymmetric tile sizes, vertical breaks.
-* **BENTO CELL COUNT RULE (mandatory):** A bento grid has EXACTLY as many cells as you have content for. 3 items → 3 cells (1+2 split, or 2+1, or asymmetric trio). 5 items → 5 cells (2+3, 3+2, hero+4, etc.). If your grid has an empty cell in the middle or at the end, you planned wrong. Re-shape the grid; do not paste a blank tile.
-* **Section-Layout-Repetition Ban.** Once you use a layout family for a section (e.g., 3-column-image-cards, full-width-quote, split-text-image), that family can appear at most ONCE on the page. "Selected commissions" must not look like "What we do." A landing page with 8 sections must use at least 4 different layout families.
-* **ZIGZAG ALTERNATION CAP (mandatory).** Alternating "left-image + right-text" then "left-text + right-image" zigzag layout = banal. Max 2 sections in a row with this image+text-split pattern. The 3rd consecutive image+text split is a Pre-Flight Fail. Break the pattern with a full-width section, a vertical-stack section, a bento grid, a marquee, or a different layout family.
-* **EYEBROW RESTRAINT (mandatory, the #1 violated rule in production tests).** An "eyebrow" is the small uppercase wide-tracking label sitting above a section headline (e.g. `FOUR COLORWAYS`, `SELECTED WORK`, `THE HARDWARE`, `Git-native task management`). Typical CSS signature: `text-[11px] uppercase tracking-[0.18em]`, `font-mono text-[10.5px] uppercase tracking-[0.22em]`. Every AI-built site puts an eyebrow above EVERY section header, producing the same templated rhythm. Hard rule:
- - **Maximum 1 eyebrow per 3 sections.** Hero counts as 1. So a page with 9 sections may use at most 3 eyebrows total.
- - If section A has an eyebrow, the next 2 sections cannot have one.
- - **Pre-Flight Check is mechanical:** count instances of `uppercase tracking` (or similar small-caps mono labels above headlines) across all section components. If count > ceil(sectionCount / 3), the output fails.
- - **What to do instead of an eyebrow:** drop it entirely. The headline alone is enough. If you need to categorize a section, the section's location on the page already categorizes it; no label needed.
-* **SPLIT-HEADER BAN (mandatory).** The pattern "left big headline + right small explainer paragraph" as a section header (left col-span-7/8, right col-span-4/5 with a small body paragraph floating in the right column) is **banned as default**. Sections should have ONE focused message. If you genuinely need both a headline and an explainer paragraph, stack them vertically (headline on top, body below, max-width 65ch). Reach for the split-header pattern only when there is a real compositional reason (e.g., the right column carries a visual or interactive element, not just filler text).
-* **Bento Background Diversity (mandatory).** Bento and feature-grid sections cannot be 6 white-on-white cards with text inside. At least 2-3 cells in any multi-cell grid need real visual variation: a real image, a brand-appropriate gradient (not AI-purple), a pattern, a tinted background. A cream-on-cream bento with only typography inside reads as boring AI default, even when the rest of the page is good.
-* **Mobile collapse must be explicit per section.** For every multi-column layout, declare the `< 768px` fallback in the same component. No "it'll work, Tailwind handles it" assumptions.
-
-### 4.8 Image & Visual Asset Strategy
-
-Landing pages and portfolios are **visual products**. Text-only pages with fake-screenshot divs are slop.
-
-**Priority order for visual assets:**
-1. **Image-generation tool first.** If ANY image-gen tool is available in the environment (`generate_image`, MCP image tool, IDE-integrated gen, OpenAI image tools, etc.) you MUST use it to create section-specific assets: hero photography, product shots, texture backgrounds, mood images. Generate at the right aspect ratio for the section. Do not skip this step because hand-rolled CSS feels faster.
-2. **Real web images second.** When no gen tool is available, use real photography sources. Acceptable defaults:
- * `https://picsum.photos/seed/{descriptive-seed}/{w}/{h}` for placeholder photography (seed should describe the section, e.g. `marrow-cookware-kitchen`)
- * Actual stock or brand URLs when the brief provides them
- * Open-license sources (Unsplash via direct URL, Pexels) if explicitly allowed
-3. **Last resort: tell the user.** If neither is possible, do NOT fill the page with hand-rolled SVG illustrations or div-based "fake screenshots." Instead, leave clearly-labeled placeholder slots (`<!-- TODO: hero product photo, 1600x1200 -->`) and at the end of the response say: *"This page needs real images at: \[list of placements\]. Please generate or provide them."*
-
-**Even minimalist sites need real images.** A pure-text page is not minimalism. It is incomplete work. Even an editorial Linear-style site needs at least 2-3 real images (hero, one product/lifestyle shot, one supporting image). Generate B&W minimalist photography if the brief is restrained; do not skip images entirely because the dial is low.
-
-**Real company logos for social proof.** When the brief calls for a "Trusted by / Used by / Customers" logo wall, do NOT default to plain text wordmarks (`<span>Acme Co</span>` styled in a row). Use real SVG logos:
-* **Source: Simple Icons** (`https://cdn.simpleicons.org/{slug}/ffffff` for any color, or `simple-icons` npm package). Covers most known brands.
-* **Alternative: devicon** for tech-stack logos (`@svgr/cli` or CDN).
-* **Make-up the brand name? Then make-up an SVG mark too.** Generate a simple monogram (one letter in a circle, two-letter ligature, abstract glyph) rendered as an inline `<svg>` matching the page style. Plain text wordmarks for invented brand names look generic.
-* **Always** ensure logos render in both light and dark mode (white-on-dark, black-on-light, or single-color theme variable).
-* **LOGO-ONLY rule (mandatory):** logo wall = logos and nothing else. Do NOT print industry / category labels below each logo (no `Vercel` + `hosting` underneath, no `Stripe` + `payments`, no `Cloudflare` + `infra`). The logo is the credibility, the label adds nothing the user does not already know. Optional: brand name as alt-text for screen readers, optional link to the brand's site. That is it.
-
-**Hand-rolled illustrations:**
-* SVG icons from libraries: fine (see Section 3.C).
-* Hand-rolled decorative SVGs (custom illustrations, logos, marks): **strongly discouraged**, never as default. Acceptable only when:
- - The brief explicitly calls for it ("draw me an SVG logo")
- - It's a single, simple geometric mark (a square, a circle, a wordmark in display type)
- - You're confident in the output quality
-
-**Div-based fake screenshots are banned.** A "hand-built product preview" rendered with `<div>` rectangles, fake task lists, fake dashboards, fake terminal windows is a Tell. If you need to show a product:
-* Use a real screenshot URL if one exists
-* Generate one via image tool
-* Use a real component preview (an actual mini-version of the UI inside the page)
-* Or skip the preview entirely and use editorial photography
-
-**Hero needs a real visual.** Text + gradient blob is not a hero - it's a placeholder.
-
-### 4.9 Content Density
-
-Landing pages live on the **first impression**, not the full read. Cut ruthlessly.
-
-* **Default content shape per section:** short headline (≤ 8 words) + short sub-paragraph (≤ 25 words) + one visual asset OR one CTA. Anything more must be justified by the section's job.
-* **No data-dump sections.** A 20-row publication table, a 30-row award list, a giant pricing matrix on a marketing page = wrong layout. Use:
- - Top 3-5 highlights + "View full list" link
- - Marquee / carousel for breadth
- - Different page entirely if the data is the product
-* **Long lists need a different UI component, not a longer list.** Default `<ul>` with bullets / `divide-y` rows is the lazy choice. If you have > 5 items, reach for one of these instead:
- - 2-column split with grouped items
- - Card grid with image + label per item
- - Tabs / accordion if items are categorisable
- - Horizontal scroll-snap pills
- - Carousel for breadth-heavy lists (testimonials, logos, capabilities)
- - Marquee for "lots-of-things-that-don't-need-individual-attention"
- A spec sheet with 10 rows + a hairline under every row is the WORST default. Either group rows into 2-3 chunks with sparse dividers, or move to a card-per-spec layout.
-* **Spec sheets specifically (the Marrow-cookware pattern).** A long product specification table with `border-b` on every row is the AI default for cookware / hardware / apparel / artisan-goods briefs. Banned. Concrete alternatives:
- - **2-col card grid:** each spec gets its own card with the spec name, the value (large display number), and a one-line "why it matters" body. Cards arranged 2-col on desktop, 1-col mobile.
- - **Scroll-snap horizontal pills:** each spec is a pill, user can flick through.
- - **Grouped chunks:** group 10 specs into 3 logical clusters (e.g. "Materials", "Cooking", "Warranty"), each cluster gets ONE soft divider and a cluster heading.
- - **Featured-vs-rest:** 3-4 hero specs visualised as large display tiles, the rest collapsed under a "View full specifications" disclosure.
-
-* **COPY SELF-AUDIT (mandatory before ship):** Before declaring any task done, re-read every visible string on the page (headlines, subheads, eyebrows, button labels, body copy, captions, alt text, footer text, error messages). Flag any string that is:
- - **Grammatically broken** ("free on its past", "two plans but one is honest", "to put it on the table" out of context)
- - **Has unclear referents** ("we plan to stay that way" without prior context)
- - **Sounds like AI hallucination** (cute-but-wrong wordplay, forced metaphors that don't track, "elegant nothing" phrases)
- - **Reads like an LLM trying to sound thoughtful** (passive-aggressive humility, fake-craftsman labels, mock-poetic micro-meta)
- Rewrite every flagged string. If unsure whether a string makes sense, replace it with a plain functional sentence. AI-generated cute copy is worse than boring copy.
-* **Fake-precise numbers are flagged.** Numbers like `92%`, `4.1×`, `48k`, `5.8 mm`, `13.4 lb` either:
- - Come from real data (brief, brand guidelines, public metrics) - fine
- - Are explicitly labeled as mock (`<!-- mock -->`, "example", "sample data") - fine
- - Are AI-invented spec aesthetics - banned. Don't fake engineering precision the brand doesn't claim.
-* **One copy register per page.** Don't mix technical mono ("47 tasks · 0.6 ctx-switches/day"), editorial prose, and marketing punch in the same composition unless the brand voice explicitly calls for it.
-
-### 4.10 Quotes & Testimonials
-
-* **Max 3 lines** of quote body. Never 6. If the original quote is longer → cut it. A landing-page quote is a snippet, not the full review.
-* For very small font sizes (e.g. footer-style testimonials), the line cap can stretch slightly. Spirit: "fits in a glance."
-* **No em-dashes inside the quote text** as design flourish (long pauses, kinetic em-dashes, em-dash-bullets). See Section 9.G - em-dash is completely banned.
-* Attribution: name + role + (optionally) company. Never name only ("- Sarah").
-* Quote marks: use real typographic quotes ( " " ) or none at all. Not straight ASCII ( " ).
-
-### 4.11 Page Theme Lock (Light / Dark Mode Consistency)
-
-The page has ONE theme. Sections do not invert.
-
-* If the page is dark mode, ALL sections are dark mode. No light-mode-warm-paper section sandwiched between dark sections (or vice versa). The user must not feel they walked into a different website mid-scroll.
-* The exception: if the brief explicitly calls for a "Color Block Story" or "Theme Switch on Scroll" device AND that is a deliberate composition (one full theme switch with a strong transition, not random alternation), it is allowed once per page.
-* Default behaviour: pick light, dark, or auto (`prefers-color-scheme`) at the page level and lock it. Section-level background tints within the same theme family are fine (`bg-zinc-950` next to `bg-zinc-900`); flipping to `bg-amber-50` in the middle of a `bg-zinc-950` page is broken.
-* When using a design system with built-in theming (Radix Themes, shadcn/ui with `<Theme>`), set the theme ONCE in `layout.tsx` or the page root. Do not let individual sections override.
-
----
-
-## 5. CONTEXT-AWARE PROACTIVITY
-
-These are tools, not defaults. Use them when the design read calls for them. **None of these fire automatically.**
-
-* **Liquid Glass / Glassmorphism:** Appropriate for premium consumer, Apple-adjacent, luxury brand, or media-overlay vibes. Inappropriate for dashboards, public-sector, or "boring B2B." When used, go beyond `backdrop-blur`: add a 1px inner border (`border-white/10`) and a subtle inner shadow (`shadow-[inset_0_1px_0_rgba(255,255,255,0.1)]`) for physical edge refraction. Provide a solid-fill fallback under `prefers-reduced-transparency`.
-* **Magnetic Micro-physics:** Use when `MOTION_INTENSITY > 5` AND the brief reads premium / playful / agency. Implement EXCLUSIVELY with Motion's `useMotionValue` / `useTransform` outside the React render cycle. Never `useState`. See Section 3.B.
-* **Perpetual Micro-Interactions** (Pulse, Typewriter, Float, Shimmer, Carousel): Use when `MOTION_INTENSITY > 5` AND the section actively benefits from motion (status indicators, live feeds, AI-feel). **Not every card needs an infinite loop.** If a section is informational, leave it still. Apply Spring Physics (`type: "spring", stiffness: 100, damping: 20`) - no linear easing.
-* **"Motion claimed, motion shown."** If `MOTION_INTENSITY > 4`, the page must actually move: entry transitions on hero, scroll-reveal on key sections, hover physics on CTAs, at minimum. A static page that claims `MOTION_INTENSITY: 7` is broken. Conversely, if you cannot ship working motion in the available scope, drop the dial to 3 and ship a clean static page. Never half-build motion that breaks (cut-off ScrollTriggers, jumpy enters, missing cleanups).
-* **MOTION MUST BE MOTIVATED (mandatory).** Before adding any animation, ask: "what does this animation communicate?" Valid answers: hierarchy (drawing attention to the right thing), storytelling (revealing content in sequence that matches a narrative), feedback (acknowledging a user action), state transition (showing something changed). Invalid answer: "it looked cool". GSAP everywhere because GSAP is available is amateur. Each ScrollTrigger, each marquee, each pinned section needs a reason. If you cannot articulate the reason in one sentence, drop the animation.
-* **MARQUEE MAX-ONE-PER-PAGE (mandatory).** Horizontal scrolling text marquees ("logos endlessly scrolling", "manifesto scrolling sideways", "kinetic word strip") are appropriate at most ONCE per page. Two or more marquees on the same page reads as lazy filler. Pick the one section where the marquee actually serves the content; the others get a different layout.
-* **GSAP Sticky-Stack Pattern (when scroll-stack is used).** A "card stack on scroll" must be a REAL sticky-stack, not a sequential reveal list. See Section 5.A below for the canonical code skeleton. Common failure: trigger fires halfway through scroll instead of pinning at viewport top. Fix: `start: "top top"` not `start: "top center"` or `"top 80%"`.
-* **GSAP Horizontal-Pan Pattern (when horizontal scroll-hijack is used).** See Section 5.B below for the canonical skeleton. Common failure: animation starts before the section is pinned, so the user sees half a slide. Same fix: `start: "top top"`, pin the wrapper, scrub the inner track.
-
-### 5.A Sticky-Stack - Canonical Skeleton
-
-```tsx
-"use client";
-import { useRef, useEffect, useId, type ReactNode } from "react";
-import { gsap } from "gsap";
-import { ScrollTrigger } from "gsap/ScrollTrigger";
-import { useReducedMotion } from "motion/react";
-
-gsap.registerPlugin(ScrollTrigger);
-
-export function StickyStack({ cards }: { cards: ReactNode[] }) {
- const ref = useRef<HTMLDivElement>(null);
- const reduce = useReducedMotion();
- const instanceId = useId().replace(/:/g, "");
- const cardClass = `stack-card-${instanceId}`;
- const innerClass = `stack-card-inner-${instanceId}`;
-
- useEffect(() => {
- if (reduce || !ref.current || cards.length <= 1) return;
- const ctx = gsap.context(() => {
- const cardEls = gsap.utils.toArray<HTMLElement>(`.${cardClass}`);
- cardEls.forEach((card, i) => {
- if (i === cardEls.length - 1) return;
- ScrollTrigger.create({
- trigger: card,
- start: "top top", // pin at viewport top
- endTrigger: cardEls[cardEls.length - 1],
- end: "top top",
- pin: true,
- pinSpacing: false,
- anticipatePin: 1,
- invalidateOnRefresh: true,
- });
- const inner = card.querySelector(`.${innerClass}`);
- if (!inner) return;
- gsap.to(inner, {
- scale: 0.92,
- opacity: 0.55,
- ease: "none",
- scrollTrigger: {
- trigger: cardEls[i + 1],
- start: "top bottom",
- end: "top top",
- scrub: true,
- invalidateOnRefresh: true,
- },
- });
- });
- }, ref);
- return () => ctx.revert();
- }, [reduce, cards.length, cardClass, innerClass]);
-
- return (
- <div ref={ref} className="relative">
- {cards.map((card, i) => (
- <div
- key={i}
- style={{ zIndex: i + 1 }}
- className={`${cardClass} relative min-h-[100dvh] flex items-center justify-center`}
- >
- <div className={`${innerClass} w-full flex items-center justify-center will-change-transform`}>
- {card}
- </div>
- </div>
- ))}
- </div>
- );
-}
-```
-
-Critical points: `start: "top top"`, `pin: true`, every card except the last is pinned, the scale/opacity transform is driven by the NEXT card's scroll trigger (so previous card shrinks as next one arrives). Never combine CSS `position: sticky` with `pin: true` on the same element: the native sticky engine and ScrollTrigger's `position: fixed` fight at the hand-off (judder, snapping, coordinate drift). The pinned element must also not be the element being transformed - pin the outer card and animate an inner wrapper, or the scale tween throws off the pin measurements. Scope the card class per instance (`useId`) so two stacks on one page do not cross-select; stack with ascending `zIndex`. Under `prefers-reduced-motion` the component renders a plain list: no pin, no transforms, all content reachable.
-
-### 5.B Horizontal-Pan - Canonical Skeleton
-
-```tsx
-"use client";
-import { useRef, useEffect, type ReactNode } from "react";
-import { gsap } from "gsap";
-import { ScrollTrigger } from "gsap/ScrollTrigger";
-import { useReducedMotion } from "motion/react";
-
-gsap.registerPlugin(ScrollTrigger);
-
-export function HorizontalPan({ children }: { children: ReactNode }) {
- const wrap = useRef<HTMLElement>(null);
- const track = useRef<HTMLDivElement>(null);
- const reduce = useReducedMotion();
-
- useEffect(() => {
- if (reduce || !wrap.current || !track.current) return;
- const ctx = gsap.context(() => {
- const getDistance = () =>
- Math.max(0, track.current!.scrollWidth - wrap.current!.clientWidth);
- gsap.to(track.current, {
- x: () => -getDistance(),
- ease: "none",
- scrollTrigger: {
- trigger: wrap.current,
- start: "top top", // pin starts when section top hits viewport top
- end: () => `+=${getDistance()}`, // scroll distance = track width minus viewport, recomputed on refresh
- pin: true,
- scrub: 1,
- anticipatePin: 1,
- invalidateOnRefresh: true,
- },
- });
- }, wrap);
- return () => ctx.revert();
- }, [reduce]);
-
- return (
- <section
- ref={wrap}
- role="region"
- aria-label="Horizontal content track"
- tabIndex={reduce ? 0 : undefined}
- className={`relative w-full ${reduce ? "overflow-x-auto scroll-smooth" : "overflow-hidden"}`}
- >
- <div
- ref={track}
- className={`flex h-[100dvh] w-max items-center ${reduce ? "snap-x snap-mandatory" : ""}`}
- >
- {children}
- </div>
- </section>
- );
-}
-```
-
-Critical points: `start: "top top"`, `pin: true`, `end: "+=${getDistance()}"` (scroll length = horizontal travel needed), `scrub: 1`. The wrapper is pinned, the inner track slides horizontally as the user scrolls vertically. `x` and `end` must be function-based and paired with `invalidateOnRefresh: true`; a `distance` captured once never recomputes - after a resize it overshoots into blank space (or pans to nothing when the track fits). Keep `w-max` on the track and make each panel non-shrinking (`shrink-0` or an explicit width): without it, overflow compression collapses `scrollWidth` and the section pins without panning. Under `prefers-reduced-motion` keep every panel reachable: swap the wrapper to `overflow-x-auto` with snap points instead of leaving `overflow-hidden`.
-
-### 5.C Scroll-Reveal Stagger - Canonical Skeleton (lighter alternative)
-
-For simple "items appear as they enter viewport" (no pinning), prefer Motion's `whileInView` over GSAP - lighter, no ScrollTrigger needed:
-
-```tsx
-"use client";
-import { motion, useReducedMotion } from "motion/react";
-
-export function RevealStagger({ items }: { items: string[] }) {
- const reduce = useReducedMotion();
- return (
- <ul className="grid gap-6">
- {items.map((item, i) => (
- <motion.li
- key={item}
- initial={reduce ? false : { opacity: 0, y: 24 }}
- whileInView={{ opacity: 1, y: 0 }}
- viewport={{ once: true, amount: 0.3 }}
- transition={{
- duration: 0.6,
- delay: i * 0.06,
- ease: [0.16, 1, 0.3, 1],
- }}
- >
- {item}
- </motion.li>
- ))}
- </ul>
- );
-}
-```
-
-Use this for: feature lists, testimonial grids, logo walls, anything that just needs "enter on scroll." Save GSAP for actual pin/scrub work.
-
-### 5.D Forbidden Animation Patterns
-
-* **`window.addEventListener("scroll", ...)`** is banned. It runs on every scroll frame, jank-prone, no batching. Use Motion's `useScroll()`, GSAP's `ScrollTrigger`, IntersectionObserver, or CSS `scroll-driven animations` (`animation-timeline: view()`).
-* **Custom scroll progress calculations using `window.scrollY`** in React state. Same reason. Re-renders on every frame.
-* **`requestAnimationFrame` loops that touch React state.** Use motion values (`useMotionValue` + `useTransform`) instead.
-* **Layout Transitions:** Use Motion's `layout` and `layoutId` props for visible state changes (re-ordering lists, expanding modals, shared elements between routes). Do not wrap static content in `layout` props "for safety" - it costs measurement work.
-* **Staggered Orchestration:** Use `staggerChildren` (Motion) or CSS cascade (`animation-delay: calc(var(--index) * 100ms)`) for reveal moments where sequence matters. For `staggerChildren`, parent (`variants`) and children MUST share the same Client Component tree.
-
----
-
-## 6. PERFORMANCE & ACCESSIBILITY GUARDRAILS
-
-### 6.A Hardware Acceleration
-* Animate ONLY `transform` and `opacity`. Never animate `top`, `left`, `width`, `height`.
-* Use `will-change: transform` sparingly - only on elements that will actually animate.
-
-### 6.B Reduced Motion (mandatory)
-* **Any motion above `MOTION_INTENSITY > 3` MUST honor `prefers-reduced-motion`.** This is non-negotiable.
-* In Motion: wrap with `useReducedMotion()` and degrade to static.
-* In CSS: gate animations behind `@media (prefers-reduced-motion: no-preference)` or provide an override block under `@media (prefers-reduced-motion: reduce)` that disables.
-* Infinite loops, parallax, scroll-hijack, and magnetic physics MUST collapse to static / instant under reduced motion.
-
-### 6.C Dark Mode (mandatory for any consumer-facing page)
-* Design for **both modes from the start**. Never ship light-only or dark-only without explicit user instruction.
-* Use Tailwind `dark:` variant OR CSS variables for tokens. Pick one strategy per project.
-* **Do not prescribe specific dark-mode colors here.** The brief decides. Maintain visual hierarchy, brand identity, and WCAG AA contrast (AAA for body) across both modes.
-* Respect `prefers-color-scheme: dark`. Default to system preference unless the brand insists on one mode.
-
-### 6.D Core Web Vitals Targets
-* **LCP** < 2.5s. Hero image must be `next/image priority` or preloaded.
-* **INP** < 200ms. Heavy work off main thread.
-* **CLS** < 0.1. Reserve space for images, fonts, embeds.
-* Run Lighthouse before declaring a page done.
-
-### 6.E DOM Cost
-* Apply grain / noise filters EXCLUSIVELY to fixed, `pointer-events-none` pseudo-elements (e.g., `fixed inset-0 z-[60] pointer-events-none`). NEVER on scrolling containers - continuous GPU repaints destroy mobile FPS.
-* Be aware of bundle size. Motion is not tiny. Three.js is large. Lazy-load anything that's not above-the-fold.
-
-### 6.F Z-Index Restraint
-NEVER spam arbitrary `z-50` or `z-10`. Use z-index strictly for systemic layer contexts (sticky navbars, modals, overlays, grain). Document the z-index scale in a project constants file.
-
----
-
-## 7. DIAL DEFINITIONS (Technical Reference)
-
-### DESIGN_VARIANCE (Level 1-10)
-* **1-3 (Predictable):** Symmetrical CSS Grid (12-col, equal fr-units), equal paddings, centered alignment.
-* **4-7 (Offset):** `margin-top: -2rem` overlaps, varied image aspect ratios (4:3 next to 16:9), left-aligned headers over center-aligned data.
-* **8-10 (Asymmetric):** Masonry layouts, CSS Grid with fractional units (`grid-template-columns: 2fr 1fr 1fr`), massive empty zones (`padding-left: 20vw`).
-* **MOBILE OVERRIDE:** For levels 4-10, asymmetric layouts above `md:` MUST collapse to strict single-column (`w-full`, `px-4`, `py-8`) on viewports `< 768px`.
-
-### MOTION_INTENSITY (Level 1-10)
-* **1-3 (Static):** No automatic animations. CSS `:hover` and `:active` states only. `prefers-reduced-motion` is the default mode anyway.
-* **4-7 (Fluid CSS):** `transition: transform 0.3s cubic-bezier(0.16, 1, 0.3, 1), opacity 0.3s cubic-bezier(0.16, 1, 0.3, 1)` (name the properties; never `transition: all`, which also animates layout properties off the GPU, see 6.A). `animation-delay` cascades for load-ins.
-* **8-10 (Advanced Choreography):** Complex scroll-triggered reveals, parallax, scroll-driven animation (CSS `animation-timeline` or GSAP ScrollTrigger). Use Motion hooks. **NEVER use `window.addEventListener('scroll')`** - it is a hard ban, not a "prefer-not." See Section 5.D for the allowed alternatives.
-
-### VISUAL_DENSITY (Level 1-10)
-* **1-3 (Art Gallery):** Lots of white space. Huge section gaps (`py-32` to `py-48`). Expensive, clean.
-* **4-7 (Daily App):** Standard web app spacing (`py-16` to `py-24`).
-* **8-10 (Cockpit):** Tight paddings. No card boxes; 1px lines separate data. Mandatory: `font-mono` for all numbers.
-
----
-
-## 8. DARK MODE PROTOCOL
-
-Dual-mode by default. Never assume light-only unless the brief is print-emulating editorial.
-
-### 8.A Token Strategy (pick one, stick to it)
-* **Tailwind `dark:` variant** (default for utility-first projects): every color utility paired with its dark variant (`bg-white dark:bg-zinc-950`, `text-gray-900 dark:text-gray-100`).
-* **CSS variables** (for shadcn/ui, Radix Themes, or component libraries with theming): define semantic tokens (`--surface`, `--surface-elevated`, `--text-primary`, `--accent`) and swap values under `[data-theme="dark"]` or `@media (prefers-color-scheme: dark)`.
-
-### 8.B Do Not Prescribe Specific Colors Here
-The brief and brand decide. This skill enforces only:
-* **Contrast** - WCAG AA minimum for body text, AAA target for hero copy.
-* **Hierarchy parity** - visual hierarchy that works in light must work in dark. If a CTA pops in light, it pops in dark.
-* **Brand fidelity** - primary brand color stays recognisable. Don't desaturate the brand into a dark mode.
-* **No pure `#000000` and no pure `#ffffff`** - use off-black (zinc-950, near-black warm gray) and off-white. Pure values kill depth.
-
-### 8.C Default Mode
-Respect `prefers-color-scheme` unless the brand insists. Add a manual toggle if either mode would lose key brand expression.
-
-### 8.D Test in Both Modes Before Finishing
-Open the page in both modes during development. Do not ship a page you've only seen in one mode.
-
----
-
-## 9. AI TELLS (Forbidden Patterns)
-
-Avoid these signatures unless the brief explicitly asks for them.
-
-### 9.A Visual & CSS
-* **NO neon / outer glows** by default. Use inner borders or subtle tinted shadows.
-* **NO pure black (`#000000`).** Off-black, zinc-950, or charcoal.
-* **NO oversaturated accents.** Desaturate to blend with neutrals.
-* **NO excessive gradient text** for large headers.
-* **NO custom mouse cursors.** Outdated, accessibility-hostile, perf-hostile.
-
-### 9.B Typography
-* **AVOID Inter as default.** See Section 4.1. Override path exists.
-* **NO oversized H1s** that just scream. Control hierarchy with weight + color, not raw scale.
-* **Serif constraints:** Serif for editorial / luxury / publication. Not for dashboards.
-
-### 9.C Layout & Spacing
-* **Mathematically perfect** padding and margins. No floating elements with awkward gaps.
-* **NO 3-column equal feature cards.** The generic "three identical cards horizontally" feature row is banned. Use 2-column zig-zag, asymmetric grid, scroll-pinned, or horizontal-scroll alternative.
-
-### 9.D Content & Data ("Jane Doe" Effect)
-* **NO generic names.** "John Doe", "Sarah Chan", "Jack Su" → use creative, realistic, locale-appropriate names.
-* **NO generic avatars.** No SVG "egg" or Lucide user icons → use believable photo placeholders or specific styling.
-* **NO fake-perfect numbers.** Avoid `99.99%`, `50%`, `1234567`. Use organic, messy data (`47.2%`, `+1 (312) 847-1928`).
-* **NO startup-slop brand names.** "Acme", "Nexus", "SmartFlow", "Cloudly" → invent contextual, premium names that sound real.
-* **NO filler verbs.** "Elevate", "Seamless", "Unleash", "Next-Gen", "Revolutionize" → concrete verbs only.
-
-### 9.E External Resources & Components
-* **NO hand-rolled SVG icons.** Use Phosphor / HugeIcons / Radix / Tabler. Lucide on explicit request only.
-* **Hand-rolled decorative SVGs strongly discouraged** as default (see Section 4.8).
-* **NO div-based fake screenshots.** Never build a fake product UI out of `<div>` rectangles to simulate a screenshot. Use real images, generated images, or skip the preview.
-* **NO broken Unsplash links.** Use `https://picsum.photos/seed/{descriptive-string}/{w}/{h}`, or generated photo placeholders, or actual assets.
-* **shadcn/ui customization:** Allowed, but NEVER in default state. Customize radii, colors, shadows, typography to the project aesthetic.
-* **Production-Ready Cleanliness:** Code visually clean, memorable, meticulously refined.
-
-### 9.F Production-Test Tells (banned outright)
-
-These patterns came out of real LLM-generated landing-page tests. They are the signatures the model defaults to when it tries to "look designed." Treat them as hard bans unless the brief explicitly calls for one.
-
-**Hero & top-of-page**
-* **NO version labels in the hero.** `V0.6`, `v2.0`, `BETA`, `INVITE-ONLY PREVIEW`, `EARLY ACCESS`, `ALPHA` - banned as default eyebrows. Only acceptable when the brief is explicitly about a product launch / preview status.
-* **NO "Brand · No. 01"-style sub-eyebrows.** "Marrow · No. 01 · The 6-quart" type micro-meta lines. Skip them.
-
-**Section numbering & micro-labels**
-* **NO section-number eyebrows.** `00 / INDEX`, `001 · Capabilities`, `002 · Featured commission`, `06 · how it works`, `05 · The honest table` - banned. Eyebrows should name the topic in plain language, not enumerate.
-* **NO `01 / 4`-style pagination on images or bento tiles.** If the user can count, they don't need the label.
-* **NO `Scroll · 001 Capabilities`-style scroll cues.** A simple arrow or "Scroll" is enough; no section-number prefix.
-* **NO "Index of Work, 2018 - 2026"-style range labels** as eyebrows. Just say what the section is.
-
-**Separators & dots**
-* **The middle-dot (`·`) is rationed.** Maximum 1 per line in metadata strips. Do NOT use it as the default separator for everything ("foo · bar · baz · qux · quux"). If you need a separator family, prefer line breaks, hairlines, or columns.
-* **NO decorative colored status dots on every list/nav/badge.** A colored dot before "ONE Q4 SLOT OPEN" or before every nav link, or every task row - banned by default. Acceptable only when the dot conveys actual semantic state (a server status, an availability flag) and is used sparingly.
-
-**Em-dashes & typography flourishes**
-* **NO em-dash (`—`) as a design element OR anywhere else.** See Section 9.G below for the complete, non-negotiable ban. The em-dash character is forbidden in headlines, eyebrows, pills, body copy, quotes, attribution, captions, button text, and alt text. Use the regular hyphen (`-`).
-* **NO `<br>`-broken-and-italicized headlines** as a default "design move." "for thirty\<br\>*years.*" type splits. Headlines should read naturally first, get clever only when the brief demands it.
-* **NO vertical rotated text** ("INDEX OF WORK, 2018 - 2026" rotated 90°). Agency-portfolio cliché. Use it only when the brief is explicitly agency / Awwwards / experimental AND it serves a real composition purpose.
-* **NO crosshair / hairline grid lines as decoration.** Vertical and horizontal lines drawn just to make the page "feel designed" - banned. Use them only when they organize real content.
-
-**Fake product previews**
-* **NO div-based fake product UI in the hero** (fake task list, fake terminal, fake dashboard built from styled divs). It is the #1 LLM-design Tell. Use a real screenshot, a generated image, a real component preview, or none at all.
-* **NO fake version footers** ("v0.6.2-rc.1", "last sync 4s ago · main") inside fake screenshots. Adds nothing, screams AI.
-
-**Marketing-copy Tells**
-* **NO "Quietly in use at" / "Quietly trusted by"** social-proof headers. Use natural language: "Trusted by", "Used at", "Customers include", or skip the heading entirely if the logos speak.
-* **NO "From the field" / "Field notes" / "Currently on the bench" / "On our desks" / "Loose plates" style poetic labels** on quote, blog, or sidebar sections. Reads as performative-craftsman. Use plain functional labels ("Testimonials", "Latest writing", "Now working on") or skip the label.
-* **NO "We respect the French ones"-style** mock-humble industry-references in body copy. Cute and AI-y.
-* **NO weather / locale strips** ("LIS 14:23 · 18°C") in headers/footers unless the brief is explicitly about a place / time-zone-distributed studio.
-* **NO micro-meta-sentences under eyebrows.** Sentences like *"Each of these is a feature we ship today, not a roadmap promise. The list will stay short on purpose."* sitting under a section heading are clutter. Eyebrow + Headline + Body is enough.
-* **NO generic step labels.** "Stage 1 / Stage 2 / Stage 3", "Step 1 / Step 2 / Step 3", "Phase 01 / Phase 02 / Phase 03", "Pass One / Pass Two / Pass Three". Banned. The actual step content is the label. If you must show progression, use the verb-noun directly ("Install", "Configure", "Ship") not "Stage 1: Install".
-
-**Pills, labels and version stamps**
-* **NO pills/labels/tags overlaid on images.** No `<span>` overlays on photos with tags like `Brand · 02`, `PLATE · BRAND`, `Field notes - journal`. Either let the image speak alone, or add a caption directly below (outside the image).
-* **NO photo-credit captions as decoration.** Strings like `Field study no. 12 · Ines Caetano`, `Plate 03 · House archive`, `Frame XII · 35mm` under stock/picsum images are pretentious. Photo credit is allowed ONLY when there is a real photographer being credited for a real photo (with permission). Otherwise: skip the caption or use a one-line functional caption ("The 6-quart, in Sage.").
-* **NO version footers on marketing pages.** Footer strings like `v1.4.2`, `Build 0048`, `last sync 4s ago · main` are CLI / devtool fixtures, not landing-page content. Banned on marketing/landing/portfolio pages.
-* **NO "Reservation 412 of 800"-style live-stock counters** as decoration. Only if the brief is explicitly a limited-run waitlist with real data.
-
-**Decoration text strips**
-* **NO decoration text strip at hero bottom.** Patterns like `BRAND. MOTION. SPATIAL.`, `TYPE / FORM / MOTION`, `DESIGN · BUILD · SHIP`, `ESTD. 2018 · LISBON · BRAND. MOTION. SPATIAL.` as a small mono-caps strip across the bottom of the hero are an agency-portfolio cliché. Banned by default. Only acceptable when the strip carries real, navigable links (sticky bottom nav) or real status info (cookie banner, build info on a docs site).
-* **NO floating top-right sub-text in section headings.** Pattern: section has a giant left-aligned headline; in the top-right corner of the same section header there is a small explainer paragraph floating with no clear alignment to anything else. That floater is the Tell. Either put the sub-text directly under the headline, or build a clean 2-column header (left: headline, right: aligned body), but not a tiny corner paragraph.
-
-**Lists, dividers and scoring**
-* **NO `border-t` + `border-b` on every row of a long list / spec table.** Pick one (bottom-border between rows OR top-border above the group) and use it sparsely. A 10-row spec table with hairlines under each row is the laziest layout - see Section 4.9 for alternative UI components.
-* **NO scoring/progress bars with filled background tracks** as comparison visuals. If you need to show "X out of Y" comparisons, prefer a number + small icon, or a tiny inline bar WITHOUT a background track. Big filled `bg-zinc-200` tracks with a partial fill on top are dashboard-UI clutter on a landing page.
-
-**Locale, time, scroll cues**
-* **Locale / city-name / time / weather strips are banned for 99% of briefs.** "Lisbon, working with founders" in the hero, "1200-690 Lisbon, Portugal" in the footer, "Lisbon 14:23 · 18°C" in the nav. These are agency-portfolio decoration tells. Allowed ONLY when: the brief explicitly describes a globally-distributed studio with timezone-relevant work, OR a travel-focused brand, OR a real-world physical venue. A single contact-address mention in the footer is fine; an atmospheric locale strip is not.
-* **Scroll cues are banned.** `Scroll`, `↓ scroll`, `Scroll to explore`, `Scroll to walk through it`, animated mouse-wheel icons. If the user has not scrolled yet, they are looking at the hero. They know what scroll is. The bottom of the viewport does not need a label.
-* **ZERO decorative status dots by default.** A coloured dot before nav items, before list rows, before badges, before status labels is a Tell. Only acceptable when conveying real semantic state (a live indicator on actual server status, a live availability flag) and limited to one per page section.
-
-### 9.G EM-DASH BAN (the single most-violated Tell)
-
-**Em-dash (`—`) is COMPLETELY banned.** It is the LLM's signature stylistic crutch and it is the #1 visual Tell in production tests. There is no "limited use" allowance, no "natural language frequency" allowance, no "in body copy is fine" allowance. None.
-
-* **Banned in headlines.** Use a period or a comma.
-* **Banned in eyebrows / labels / pills / button text / image captions / nav items.** Replace with line breaks, columns, or hairlines.
-* **Banned in body copy.** Restructure the sentence: two sentences with a period, OR a comma, OR parentheses, OR a colon.
-* **Banned in quote attribution.** Use a normal hyphen with spaces (` - `) or a line break + smaller-weight name.
-* **Banned in en-dash form too (`–`) when used as a separator.** Date ranges (`2018-2026`) use a hyphen. Number ranges (`€40-80k`) use a hyphen.
-
-The ONLY permitted dash characters on the page are:
-* Regular hyphen `-` (for compound words, ranges, line dividers in markup)
-* Minus sign in math (`-5°C`)
-
-If your output contains a single `—` or `–` anywhere visible to the user, the output fails the Pre-Flight Check and must be rewritten.
-
-This rule is non-negotiable. The agent has historically ignored em-dash limits when phrased as "use sparingly." The phrasing here is binary: zero em-dashes.
-
----
-
-## 10. REFERENCE VOCABULARY (Pattern Names the Agent Should Know)
-
-This is a vocabulary, not a library. The agent should KNOW these pattern names to communicate about them, design with them in mind, and reach for them when the design read calls for them. **Implementations and code sketches live in the Block Library (Section 12), which is populated iteratively.**
-
-### Hero Paradigms
-* **Asymmetric Split Hero** - Text on one side, asset on the other, generous white space.
-* **Editorial Manifesto Hero** - Large type, no asset, almost-poster.
-* **Video / Media Mask Hero** - Type cut out as mask over video background.
-* **Kinetic-Type Hero** - Animated typography as the primary visual.
-* **Curtain-Reveal Hero** - Hero parts on scroll like a curtain.
-* **Scroll-Pinned Hero** - Hero stays pinned while content scrolls behind.
-
-### Navigation & Menus
-* **Mac OS Dock Magnification** - Edge nav, icons scale fluidly on hover.
-* **Magnetic Button** - Pulls toward cursor.
-* **Gooey Menu** - Sub-items detach like viscous liquid.
-* **Dynamic Island** - Morphing pill for status / alerts.
-* **Contextual Radial Menu** - Circular menu expanding at click point.
-* **Floating Speed Dial** - FAB springing into curved secondary actions.
-* **Mega Menu Reveal** - Full-screen dropdown, stagger-fade content.
-
-### Layout & Grids
-* **Bento Grid** - Asymmetric tile grouping (Apple Control Center).
-* **Masonry Layout** - Staggered grid, no fixed row height.
-* **Chroma Grid** - Borders / tiles with subtle animating gradients.
-* **Split-Screen Scroll** - Two halves sliding in opposite directions.
-* **Sticky-Stack Sections** - Sections that pin and stack on scroll.
-
-### Cards & Containers
-* **Parallax Tilt Card** - 3D tilt tracking mouse coordinates.
-* **Spotlight Border Card** - Borders illuminate under cursor.
-* **Glassmorphism Panel** - Frosted glass with inner refraction.
-* **Holographic Foil Card** - Iridescent rainbow shift on hover.
-* **Tinder Swipe Stack** - Physical card stack, swipe-away.
-* **Morphing Modal** - Button expands into its own dialog.
-
-### Scroll Animations
-* **Sticky Scroll Stack** - Cards stick and physically stack.
-* **Horizontal Scroll Hijack** - Vertical scroll → horizontal pan.
-* **Locomotive / Sequence Scroll** - Video / 3D sequence tied to scrollbar.
-* **Zoom Parallax** - Central background image zooming on scroll.
-* **Scroll Progress Path** - SVG line drawing along scroll.
-* **Liquid Swipe Transition** - Page transition like viscous liquid.
-
-### Galleries & Media
-* **Dome Gallery** - 3D panoramic gallery.
-* **Coverflow Carousel** - 3D carousel with angled edges.
-* **Drag-to-Pan Grid** - Boundless draggable canvas.
-* **Accordion Image Slider** - Narrow strips expanding on hover.
-* **Hover Image Trail** - Mouse leaves popping image trail.
-* **Glitch Effect Image** - RGB-channel shift on hover.
-
-### Typography & Text
-* **Kinetic Marquee** - Endless text bands reversing on scroll.
-* **Text Mask Reveal** - Massive type as transparent window to video.
-* **Text Scramble Effect** - Matrix-style decoding on load / hover.
-* **Circular Text Path** - Text curving along spinning circle.
-* **Gradient Stroke Animation** - Outlined text with running gradient.
-* **Kinetic Typography Grid** - Letters dodging the cursor.
-
-### Micro-Interactions & Effects
-* **Particle Explosion Button** - CTA shatters into particles on success.
-* **Liquid Pull-to-Refresh** - Reload indicator like detaching droplets.
-* **Skeleton Shimmer** - Shifting light reflection across placeholders.
-* **Directional Hover-Aware Button** - Fill enters from cursor's exact side.
-* **Ripple Click Effect** - Wave from click coordinates.
-* **Animated SVG Line Drawing** - Vectors drawing themselves in real time.
-* **Mesh Gradient Background** - Organic lava-lamp blobs.
-* **Lens Blur Depth** - Background UI blurred to focus foreground action.
-
-### Animation Library Choice
-* **Motion (`motion/react`)** - default for UI / Bento / state-change motion.
-* **GSAP + ScrollTrigger** - for full-page scrolltelling and scroll hijacks. Isolate in dedicated leaf components with `useEffect` cleanup.
-* **Three.js / WebGL** - for canvas backgrounds and 3D scenes. Same isolation rule.
-* **NEVER mix GSAP / Three.js with Motion in the same component tree.** They fight over the same frames.
-
----
-
-## 11. REDESIGN PROTOCOL
-
-This skill handles **greenfield builds AND redesigns**. Misclassifying the mode is the single biggest source of bad redesign output.
-
-### 11.A Detect the Mode (first action)
-* **Greenfield** - no existing site, or full overhaul approved. Dial baseline from Section 1.
-* **Redesign - Preserve** - modernise without breaking the brand. Audit first, extract brand tokens, evolve gradually.
-* **Redesign - Overhaul** - new visual language on top of existing content. Treat as greenfield for visuals; preserve content and IA.
-
-If ambiguous, ask **once**: *"Should this redesign preserve the existing brand, or are we starting visually from scratch?"*
-
-### 11.B Audit Before Touching
-Document the current state before proposing changes:
-* **Brand tokens** - primary / accent colors, type stack, logo treatment, radii.
-* **Information architecture** - page tree, primary nav, key conversion paths.
-* **Content blocks** - what exists, what's doing work, what's filler.
-* **Patterns to preserve** - signature interactions, recognisable hero, copy voice.
-* **Patterns to retire** - AI-slop tells, broken layouts, dead links, generic stock imagery, perf traps.
-* **Dial reading of the existing site** - infer current `DESIGN_VARIANCE` / `MOTION_INTENSITY` / `VISUAL_DENSITY`. That's your starting point, not the baseline.
-* **SEO baseline** - current ranking pages, meta titles, structured data, OG cards. **SEO migration is the #1 redesign risk.**
-
-### 11.C Preservation Rules
-* **Do not change information architecture** unless asked. Keep page slugs, anchor IDs, primary nav labels stable for SEO and muscle memory.
-* **Extract brand colors before applying Section 4.2.** A brand that is already purple stays purple - apply the LILA RULE's override.
-* **Preserve copy voice** unless asked for a rewrite. Visual modernisation ≠ content rewrite.
-* **Honor existing accessibility wins.** Do not regress focus states, alt text, keyboard nav, contrast.
-* **Respect existing analytics events.** Do not rename buttons, form fields, section IDs that downstream tracking depends on.
-
-### 11.D Modernisation Levers (priority order)
-Apply in order - stop when the brief is satisfied:
-1. **Typography refresh** - biggest visual lift per unit of risk.
-2. **Spacing & rhythm** - increase section padding, fix vertical rhythm.
-3. **Color recalibration** - desaturate, unify neutrals, keep brand accent.
-4. **Motion layer** - add `MOTION_INTENSITY`-appropriate micro-interactions to existing components.
-5. **Hero & key-section recomposition** - restructure top-of-funnel using Section 10 vocabulary.
-6. **Full block replacement** - only when the existing block is unsalvageable.
-
-### 11.E Decision Tree: Targeted Evolution vs Full Redesign
-* IA, content, and SEO sound → **targeted evolution** (Levers 1-4). ~70% of value at ~40% of risk.
-* Visual debt is structural (broken IA, no design system, broken mobile) → **full redesign** with strict content preservation.
-* Brand itself is changing → **greenfield**.
-
-### 11.F What Never Changes Silently
-Never modify without explicit user approval:
-* URL structure / route slugs.
-* Primary nav labels.
-* Form field names or order (breaks analytics + autofill).
-* Brand logo or wordmark.
-* Existing legal / consent / cookie copy.
-
----
-
-## 12. THE BLOCK LIBRARY (Contract - Implementations Land Here Iteratively)
-
-The Reference Vocabulary (Section 10) names patterns. The Block Library implements them with real props, real motion specs, and real code sketches.
-
-**Status:** schema defined here. Blocks will be added iteratively. Do not freelance new blocks without following this schema.
-
-### 12.A File Location
-```
-skills/taste-skill/blocks/
- hero/
- asymmetric-split.md
- editorial-manifesto.md
- kinetic-type.md
- ...
- feature/
- bento-grid.md
- sticky-scroll-stack.md
- zig-zag.md
- ...
- social-proof/
- pricing/
- cta/
- footer/
- navigation/
- portfolio/
- transition/
-```
-
-### 12.B Required Frontmatter
-```yaml
----
-name: asymmetric-split-hero
-category: hero
-dial_compatibility:
- variance: [6, 10]
- motion: [3, 10]
- density: [2, 5]
-when_to_use: "Landing pages with one strong asset and one strong message. Default hero for SaaS, agency, premium consumer."
-not_for: "Editorial / manifesto launches where the message IS the design."
-stack: ["react", "next", "tailwind", "motion"]
----
-```
-
-### 12.C Required Body Sections
-1. **Visual sketch** - short ASCII or description of the layout.
-2. **Props API** - the component's interface.
-3. **Code sketch** - minimal working implementation (Server Component default, Client island for motion).
-4. **Mobile fallback** - explicit collapse rules for `< 768px`.
-5. **Motion variants** - one variant per `MOTION_INTENSITY` band (1-3, 4-7, 8-10). Reduced-motion fallback explicit.
-6. **Dark-mode notes** - token strategy specific to this block.
-7. **Anti-patterns** - common ways this block goes wrong.
-8. **References** - links to real examples in production.
-
-### 12.D Block-Library Discipline
-* One block per file. No multi-block files.
-* Every block must work standalone (drop it into a page, it renders).
-* Every block must pass the Pre-Flight Check (Section 14).
-* Blocks that depend on a design system from Section 2.A live under `blocks/<category>/<name>--<system>.md` (e.g. `feature/bento-grid--material.md`).
-
----
-
-## 13. OUT OF SCOPE
-
-This skill is NOT for:
-* Dashboards / dense product UI / admin panels (use Fluent, Carbon, Atlassian, or Polaris from Section 2.A).
-* Data tables (use TanStack Table or AG Grid).
-* Multi-step forms / wizards (use Form-specific patterns; this skill won't make them better).
-* Code editors (use Monaco / CodeMirror with their official skinning).
-* Native mobile (use Apple HIG / Material directly).
-* Realtime collab UIs (presence, cursors, OT-aware - different problem class).
-
-If the brief is one of the above, **say so explicitly**, point to the right tool, and only apply this skill's marketing-page / about-page / landing-page parts to the surfaces where they apply.
-
----
-
-## 14. FINAL PRE-FLIGHT CHECK
-
-Run this matrix before outputting code. This is the last filter.
-
-**THIS IS NOT OPTIONAL. Run every box. If any box fails, the output is not done.**
-
-- [ ] **Brief inference** declared (Section 0.B one-liner)?
-- [ ] **Dial values** explicit and reasoned from the brief, not silently using baseline?
-- [ ] **Design system** chosen from Section 2 if applicable, or aesthetic labeled honestly?
-- [ ] **Redesign mode** detected and audit performed (if applicable, Section 11)?
-- [ ] **ZERO em-dashes (`—`) anywhere on the page.** Headlines, eyebrows, pills, body, quotes, attribution, captions, buttons, alt text. Zero. (Section 9.G - non-negotiable.)
-- [ ] **Page Theme Lock**: ONE theme (light, dark, or auto) for the whole page. No section flips to inverted mode mid-page (Section 4.11)?
-- [ ] **Color Consistency Lock**: one accent color used identically across all sections (Section 4.2)?
-- [ ] **Shape Consistency Lock**: one corner-radius system applied consistently (Section 4.4)?
-- [ ] **Button Contrast Check**: every CTA text is readable against its background (no white-on-white, WCAG AA 4.5:1)?
-- [ ] **CTA Button Wrap**: no CTA label wraps to 2+ lines at desktop?
-- [ ] **Form Contrast Check**: form inputs, placeholders, focus rings, labels all pass WCAG AA against the section background?
-- [ ] **Serif discipline**: if a serif is used, it is NOT Fraunces or Instrument_Serif (or it is, with explicit brand justification)? Different serif from your previous project?
-- [ ] **Premium-consumer palette check**: if the brief is premium-consumer (cookware / wellness / artisan / luxury), the palette is NOT the AI-default beige+brass+oxblood+espresso family? Different family from your previous premium-consumer project?
-- [ ] **Italic descender clearance**: every italic word with `y g j p q` has `leading-[1.1]` min + `pb-1` reserve?
-- [ ] **Hero fits the viewport**: headline ≤ 2 lines, subtext ≤ 20 words AND ≤ 4 lines, CTA visible without scroll, font scale planned around image?
-- [ ] **Hero top padding**: max `pt-24` at desktop, hero content does not float halfway down the viewport?
-- [ ] **Hero stack discipline**: max 4 text elements in hero (eyebrow OR brand strip, headline, subtext, CTAs)? No tiny tagline below CTAs, no trust micro-strip in hero?
-- [ ] **EYEBROW COUNT (mechanical)**: count instances of `uppercase tracking` micro-labels above section headlines across all components. Count ≤ ceil(sectionCount / 3)? Hero counts as 1.
-- [ ] **Split-Header Ban**: no "left big headline + right small explainer paragraph" pattern as a section header (vertical stack instead)?
-- [ ] **Zigzag Alternation Cap**: no 3+ consecutive sections with the same image+text-split layout?
-- [ ] **No Duplicate CTA Intent**: no two CTAs with the same intent ("Get in touch" + "Let's talk" both on page = Fail)?
-- [ ] **Logo wall = logo only**: no industry / category labels printed below logos?
-- [ ] **Bento Background Diversity**: at least 2-3 bento cells have real visual variation (image, gradient, pattern), not all white-on-white text cards?
-- [ ] **"Used by / Trusted by" logo wall** lives UNDER the hero, not inside it, uses REAL SVG logos (Simple Icons / devicon) or generated SVG marks, NOT plain text wordmarks?
-- [ ] **Copy Self-Audit**: every visible string re-read, no grammatically-broken or AI-hallucinated phrases ("free on its past" type) shipped?
-- [ ] **Motion motivated**: every animation can be justified in one sentence (hierarchy / storytelling / feedback / state transition), no GSAP-for-show?
-- [ ] **Marquee max-one-per-page**: no two horizontal marquees on the same page?
-- [ ] **Navigation on ONE line** at desktop, height ≤ 80px?
-- [ ] **Section-Layout-Repetition** check: no two sections share the same layout family (at least 4 different families across 8 sections)?
-- [ ] **Bento has rhythm AND exact cell count** (N items → N cells, no empty cells in middle or at end)?
-- [ ] **Long lists use the right UI component** (not default `<ul>` with `divide-y` for > 5 items - see Section 4.9 alternatives)?
-- [ ] **Real images used** (gen-tool first, then Picsum-seed, then explicit placeholder slots) - NO div-based fake screenshots, NO hand-rolled decorative SVGs, NO pure-text minimalism?
-- [ ] **No pills/labels overlaid on images** (no `Plate · Brand`, no `Field notes - journal`)?
-- [ ] **No photo-credit captions as decoration** (`Field study no. 12 · Ines Caetano`)?
-- [ ] **No version footers** (`v1.4.2`, `Build 0048`) on marketing pages?
-- [ ] **No micro-meta-sentences** under eyebrows ("Each of these is a feature we ship today...")?
-- [ ] **No decoration text strip at hero bottom** (`BRAND. MOTION. SPATIAL.`)?
-- [ ] **No floating top-right sub-text** in section headings?
-- [ ] **No scoring/progress bars with filled background tracks** as comparison visuals?
-- [ ] **No locale / city-name / time / weather strips** unless brief is genuinely globally-distributed or place-focused?
-- [ ] **No scroll cues** (`Scroll`, `↓ scroll`, `Scroll to explore`)?
-- [ ] **No version labels in hero** (V0.6, BETA, INVITE-ONLY) unless the brief is a launch?
-- [ ] **No section-numbering eyebrows** (`00 / INDEX`, `001 · Capabilities`, `06 · how it works`)?
-- [ ] **No decorative dots** (zero by default, only for real semantic state)?
-- [ ] **No `border-t` + `border-b` on every row** of long lists / spec tables?
-- [ ] **Content density** sane: no 20-row data tables, no fake-precise specs without justification, ≤ 25-word sub-paragraphs by default?
-- [ ] **Quotes ≤ 3 lines** of body, attribution clean (no em-dash)?
-- [ ] **Motion claimed = motion shown**: if `MOTION_INTENSITY > 4`, page actually animates, not just claimed?
-- [ ] **GSAP sticky-stack / horizontal-pan** implemented per Section 5.A / 5.B canonical skeleton (`start: "top top"`, `pin: true`, correct scrub)?
-- [ ] **No `window.addEventListener('scroll')`** - using Motion `useScroll()` / ScrollTrigger / IntersectionObserver / CSS scroll-driven animations only?
-- [ ] **Reduced motion** wrapped for everything `MOTION_INTENSITY > 3`?
-- [ ] **Dark mode** tokens defined and tested in both modes?
-- [ ] **Mobile collapse** explicit (`w-full`, `px-4`, `max-w-7xl mx-auto`) for high-variance layouts?
-- [ ] **Viewport stability**: `min-h-[100dvh]`, never `h-screen`?
-- [ ] **`useEffect` animations** have strict cleanup functions?
-- [ ] **Empty / loading / error** states provided?
-- [ ] **Cards omitted** in favor of spacing where possible?
-- [ ] **Icons** from an allowed library only (Phosphor / HugeIcons / Radix / Tabler), no hand-rolled SVG paths?
-- [ ] **Motion** isolated in client-leaf components with `'use client'` at the top, memoized?
-- [ ] **No AI Tells** from Section 9 (Inter as default, AI-purple, three-equal cards, Jane Doe, Acme, "Quietly in use at")?
-- [ ] **Core Web Vitals** plausibly hit (LCP < 2.5s, INP < 200ms, CLS < 0.1)?
-- [ ] **One design system** per project (no Material + shadcn mixed)?
-
-If a single checkbox cannot be honestly ticked, the page is not done. Fix it before delivering.
-
----
-
-# APPENDICES - Real Source-Backed Reference Material
-
-The sections below are vendored reference content. They give the agent real install commands, real canonical doc links, and real working starter snippets for each design system named in Section 2. Use them to ground decisions in production reality, not training-data fiction.
-
-## Appendix A - Install Commands per Design System
-
-```bash
-# Material Web (Material 3)
-npm install @material/web
-
-# Fluent UI React (v9)
-npm install @fluentui/react-components
-
-# Fluent UI Web Components (framework-free)
-npm install @fluentui/web-components @fluentui/tokens
-
-# IBM Carbon
-npm install @carbon/react @carbon/styles
-
-# Radix Themes
-npm install @radix-ui/themes
-
-# shadcn/ui (open code, owned components)
-npx shadcn@latest init
-npx shadcn@latest add button card badge separator input
-
-# Primer CSS (GitHub product/devtool UI)
-npm install --save @primer/css
-
-# Primer Brand (GitHub marketing UI)
-npm install @primer/react-brand
-
-# GOV.UK Frontend
-npm install govuk-frontend
-
-# USWDS (US Web Design System)
-npm install uswds
-
-# Atlassian Design System (Atlaskit)
-yarn add @atlaskit/css-reset @atlaskit/tokens @atlaskit/button @atlaskit/badge @atlaskit/section-message @atlaskit/card
-
-# Bootstrap 5.3
-npm install bootstrap
-
-# Shopify Polaris Web Components (Shopify apps only)
-# Add this to your app HTML head:
-# <meta name="shopify-api-key" content="%SHOPIFY_API_KEY%" />
-# <script src="https://cdn.shopify.com/shopifycloud/polaris.js"></script>
-```
-
-## Appendix B - Canonical Sources (read these before reinventing)
-
-### Material Web
-- https://github.com/material-components/material-web
-- https://material-web.dev/theming/material-theming/
-- https://m3.material.io/develop/web
-
-### Fluent UI
-- https://fluent2.microsoft.design/get-started/develop
-- https://fluent2.microsoft.design/components/web/react/
-- https://github.com/microsoft/fluentui
-- https://learn.microsoft.com/en-us/fluent-ui/web-components/
-
-### Carbon
-- https://carbondesignsystem.com/
-- https://github.com/carbon-design-system/carbon
-- https://carbondesignsystem.com/developing/react-tutorial/overview/
-- https://carbondesignsystem.com/developing/web-components-tutorial/overview/
-
-### Shopify Polaris
-- https://shopify.dev/docs/api/app-home/web-components
-- https://github.com/Shopify/polaris-react
-- https://polaris-react.shopify.com/components
-
-### Atlassian
-- https://atlassian.design/get-started/develop
-- https://atlassian.design/components/button/examples
-- https://atlaskit.atlassian.com/packages/design-system/button/example/disabled
-- https://atlassian.design/tokens/design-tokens
-
-### Primer
-- https://primer.style/
-- https://github.com/primer/css
-- https://github.com/primer/brand
-
-### GOV.UK
-- https://design-system.service.gov.uk/components/button/
-- https://design-system.service.gov.uk/styles/layout/
-- https://github.com/alphagov/govuk-frontend
-
-### USWDS
-- https://designsystem.digital.gov/documentation/developers/
-- https://designsystem.digital.gov/components/button/
-- https://designsystem.digital.gov/components/card/
-- https://github.com/uswds/uswds
-
-### Bootstrap
-- https://getbootstrap.com/docs/5.3/layout/grid/
-- https://getbootstrap.com/docs/5.3/components/card/
-
-### Tailwind
-- https://tailwindcss.com/docs/dark-mode
-- https://tailwindcss.com/blog/tailwindcss-v4
-
-### Radix
-- https://www.radix-ui.com/themes/docs/components/theme
-- https://www.radix-ui.com/themes/docs/components/card
-- https://github.com/radix-ui/themes
-
-### shadcn/ui
-- https://ui.shadcn.com/docs
-- https://ui.shadcn.com/docs/components/card
-- https://github.com/shadcn-ui/ui
-
-### Native CSS / W3C standards
-- https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/backdrop-filter
-- https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@media/prefers-color-scheme
-- https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@media/prefers-reduced-motion
-- https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Grid_layout
-- https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Scroll-driven_animations
-- https://drafts.csswg.org/scroll-animations-1/
-
-### Apple Liquid Glass (Apple platforms only)
-- https://developer.apple.com/design/human-interface-guidelines/materials
-- https://developer.apple.com/documentation/TechnologyOverviews/liquid-glass
-- https://developer.apple.com/documentation/TechnologyOverviews/adopting-liquid-glass
-- https://developer.apple.com/documentation/SwiftUI/Material
-
----
-
-## Appendix C - Apple Liquid Glass: Honest Web Approximation
-
-Do **not** treat random CSS snippets as official Apple Liquid Glass.
-
-### What is official
-Apple documents Liquid Glass inside Apple's Human Interface Guidelines and Developer Documentation for **Apple platforms**. It is a dynamic material used across Apple platform UI. Apple's native implementation belongs to Apple platform APIs and system components, **not a public web CSS package**.
-
-Relevant official docs:
-- Apple Human Interface Guidelines → Materials
-- Apple Developer Documentation → Liquid Glass
-- Apple Developer Documentation → Adopting Liquid Glass
-- SwiftUI → Material
-
-### What is NOT official
-There is no `liquid-glass.css` from Apple for normal websites.
-
-A web approximation can use:
-- `backdrop-filter`
-- transparent backgrounds
-- layered borders
-- highlight overlays
-- gradients
-- motion
-- strong contrast fallbacks
-
-But that is **web glassmorphism / frosted-glass approximation**, not official Apple Liquid Glass. Label it as such in comments.
-
-### Safer web approximation skeleton
-
-```css
-.liquid-glass-web-approx {
- position: relative;
- isolation: isolate;
- overflow: hidden;
- border-radius: 999px;
- border: 1px solid rgb(255 255 255 / .32);
- background:
- linear-gradient(135deg, rgb(255 255 255 / .30), rgb(255 255 255 / .08)),
- rgb(255 255 255 / .12);
- backdrop-filter: blur(24px) saturate(180%) contrast(1.05);
- -webkit-backdrop-filter: blur(24px) saturate(180%) contrast(1.05);
- box-shadow:
- inset 0 1px 0 rgb(255 255 255 / .48),
- inset 0 -1px 0 rgb(255 255 255 / .12),
- 0 18px 60px rgb(0 0 0 / .18);
-}
-
-.liquid-glass-web-approx::before {
- content: "";
- position: absolute;
- inset: 0;
- z-index: -1;
- border-radius: inherit;
- background:
- radial-gradient(circle at 20% 0%, rgb(255 255 255 / .55), transparent 34%),
- linear-gradient(90deg, rgb(255 255 255 / .18), transparent 42%, rgb(255 255 255 / .14));
- pointer-events: none;
-}
-
-.liquid-glass-web-approx::after {
- content: "";
- position: absolute;
- inset: 1px;
- border-radius: inherit;
- border: 1px solid rgb(255 255 255 / .14);
- pointer-events: none;
-}
-
-@media (prefers-color-scheme: dark) {
- .liquid-glass-web-approx {
- border-color: rgb(255 255 255 / .18);
- background:
- linear-gradient(135deg, rgb(255 255 255 / .16), rgb(255 255 255 / .04)),
- rgb(15 23 42 / .42);
- box-shadow:
- inset 0 1px 0 rgb(255 255 255 / .22),
- 0 18px 60px rgb(0 0 0 / .42);
- }
-}
-
-@media (prefers-reduced-transparency: reduce) {
- .liquid-glass-web-approx {
- background: rgb(255 255 255 / .96);
- backdrop-filter: none;
- -webkit-backdrop-filter: none;
- }
-}
-```
-
-**Important:** `prefers-reduced-transparency` has uneven browser support; test it. Always provide enough contrast even without blur.
-
----
-
-**End of appendices.** Install commands above are reality anchors. The Apple Liquid Glass skeleton is a labeled approximation, not an Apple-issued package. For canonical docs per design system, consult the system's official docs (links in Section 2 plus Appendix B).
diff --git a/skills/taste-skill-v2-experimental/agents/openai.yaml b/skills/taste-skill-v2-experimental/agents/openai.yaml
deleted file mode 100644
index 5b1f887..0000000
--- a/skills/taste-skill-v2-experimental/agents/openai.yaml
+++ /dev/null
@@ -1,2 +0,0 @@
-policy:
- allow_implicit_invocation: false
diff --git a/tests/skill_test.sh b/tests/skill_test.sh
deleted file mode 100644
index ca9f246..0000000
--- a/tests/skill_test.sh
+++ /dev/null
@@ -1,122 +0,0 @@
-#!/usr/bin/env bash
-
-set -u
-
-repo_root="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
-cd "$repo_root"
-
-failures=0
-
-assert_contains() {
- local actual="$1"
- local expected="$2"
-
- if [[ "$actual" != *"$expected"* ]]; then
- printf 'Expected output to contain:\n %s\nActual output:\n%s\n' "$expected" "$actual" >&2
- return 1
- fi
-}
-
-assert_not_contains() {
- local actual="$1"
- local unexpected="$2"
-
- if [[ "$actual" == *"$unexpected"* ]]; then
- printf 'Expected output not to contain:\n %s\nActual output:\n%s\n' "$unexpected" "$actual" >&2
- return 1
- fi
-}
-
-assert_equal() {
- local actual="$1"
- local expected="$2"
- local message="$3"
-
- if [[ "$actual" != "$expected" ]]; then
- printf '%s\nExpected: %s\nActual: %s\n' "$message" "$expected" "$actual" >&2
- return 1
- fi
-}
-
-run_test() {
- local name="$1"
- shift
-
- if "$@"; then
- printf 'ok - %s\n' "$name"
- else
- printf 'not ok - %s\n' "$name" >&2
- failures=$((failures + 1))
- fi
-}
-
-assert_source_returns_to_caller() {
- local expected_status="$1"
- shift
-
- local caller_output
- local caller_status
-
- caller_output="$(
- "$BASH" -c '
- set -u
- source ./skill.sh "$@" >/dev/null 2>&1
- source_status=$?
- printf "continued:%s\n" "$source_status"
- ' bash "$@"
- )"
- caller_status=$?
-
- assert_equal "$caller_status" "0" "Sourcing caller terminated before it could handle the result." || return 1
- assert_equal "$caller_output" "continued:$expected_status" "Sourced helper returned the wrong status."
-}
-
-test_help_uses_source_invocation() {
- local output
- output="$(source ./skill.sh --help)"
-
- assert_contains "$output" "Usage: source ./skill.sh <skill-name>" || return 1
- assert_contains "$output" " source ./skill.sh --list" || return 1
- assert_not_contains "$output" "Usage: ./skill.sh <skill-name>" || return 1
- assert_not_contains "$output" " ./skill.sh --list"
-}
-
-test_help_returns_to_sourcing_caller() {
- assert_source_returns_to_caller 0 --help
-}
-
-test_list_returns_to_sourcing_caller() {
- assert_source_returns_to_caller 0 --list
-}
-
-test_valid_skill_returns_path_to_sourcing_caller() {
- local caller_output
- local caller_status
-
- caller_output="$(
- "$BASH" -c '
- set -u
- source ./skill.sh taste-skill
- source_status=$?
- printf "continued:%s\n" "$source_status"
- '
- )"
- caller_status=$?
-
- assert_equal "$caller_status" "0" "Valid lookup terminated the sourcing caller." || return 1
- assert_equal "$caller_output" $'skills/taste-skill/SKILL.md\ncontinued:0' "Valid lookup returned the wrong path or status."
-}
-
-test_unknown_skill_returns_to_sourcing_caller() {
- assert_source_returns_to_caller 2 typo
-}
-
-run_test "help documents only the supported source invocation" test_help_uses_source_invocation
-run_test "help returns to the sourcing caller" test_help_returns_to_sourcing_caller
-run_test "list returns to the sourcing caller" test_list_returns_to_sourcing_caller
-run_test "valid skills return paths to the sourcing caller" test_valid_skill_returns_path_to_sourcing_caller
-run_test "unknown skills return to the sourcing caller with status 2" test_unknown_skill_returns_to_sourcing_caller
-
-if ((failures > 0)); then
- exit 1
-fi