feat(skills): upgrade design-handoff for greenfield + real export bundle

CLAUDE.md

@@ -60,7 +60,7 @@ Pre-commit is configured with `no-commit-to-branch` — direct commits to `main`
 - `ai/` — AI assets organized by type: `skills/`, `prompts/`, `agents/`, `rules/`, `evals/`, `tools/`, `workflows/`, `mcp/`, `knowledge/`, `memories/`. Most are placeholder directories for now; `skills/` is the populated one. Skills follow the Agent Skills convention — a `SKILL.md` with YAML frontmatter (`name`, `description`) plus optional `references/`. Current content is a `design/` suite for the Claude Design → code workflow:
   - `skills/design/explore-designs/` — guides using Claude Design to explore design directions (asks about the target frontend stack/tooling).
   - `skills/design/create-design-system/` — placeholder for design-system setup.
-  - `skills/design/design-handoff/` — full skill: reconcile a finished Claude Design export into a real codebase (tokens → shadcn/Tailwind v4 OKLCH, `/brand` page, contrast + licensing gates).
+  - `skills/design/design-handoff/` — full skill: implement a Claude Design `.tar.gz` handoff bundle into a real codebase — either reconcile into an existing design system or **bootstrap a new one** (tokens → shadcn/Tailwind v4 OKLCH, `/brand`, contrast + licensing gates). A lean phased/gated `SKILL.md` plus a `references/` set and bundled `assets/` (a zero-dependency contrast checker + Taskfile snippets).
 - `snippets/` — small reusable code snippets (placeholder).
 - `docs/` — project docs, e.g. the new-project checklist.
 - `test/` — tool configuration used by scans (e.g. `whisperConfig.yml` for Whispers); not actual tests.

README.md

@@ -13,40 +13,40 @@ Author: Evan Harmon
 
 ## Repository Structure
 
-| Directory | Contents |
-| --- | --- |
-| [`templates/`](./templates/) | Copy-paste boilerplates organized by category — see the [template index](#template-index) below |
-| [`scripts/`](./scripts/) | Standalone scripts and utilities (AppleScript/Automator apps, command snippets) |
-| [`ai/`](./ai/) | AI assets — skills, prompts, agents, rules, evals, etc. — see the [AI assets index](#ai-assets) below |
-| [`snippets/`](./snippets/) | Small reusable code snippets (work in progress) |
-| [`docs/`](./docs/) | Project docs, e.g. the new-project [checklist](./docs/CHECKLIST.md) |
+| Directory                    | Contents                                                                                              |
+| ---------------------------- | ----------------------------------------------------------------------------------------------------- |
+| [`templates/`](./templates/) | Copy-paste boilerplates organized by category — see the [template index](#template-index) below       |
+| [`scripts/`](./scripts/)     | Standalone scripts and utilities (AppleScript/Automator apps, command snippets)                       |
+| [`ai/`](./ai/)               | AI assets — skills, prompts, agents, rules, evals, etc. — see the [AI assets index](#ai-assets) below |
+| [`snippets/`](./snippets/)   | Small reusable code snippets (work in progress)                                                       |
+| [`docs/`](./docs/)           | Project docs, e.g. the new-project [checklist](./docs/CHECKLIST.md)                                   |
 
 ## Template Index
 
-| Template | Category | Description |
-| --- | --- | --- |
-| [`ansible.md`](./templates/ansible.md) | Ansible | Standard Ansible project directory structure and setup notes |
-| [`docker/genericStack`](./templates/docker/genericStack/) | Docker | Generic multi-service Compose sandbox (Ubuntu, nginx, optional DB stack with Postgres/memcached/Adminer) plus `dc*` helper scripts |
-| [`docker/n8n-compose`](./templates/docker/n8n-compose/) | Docker | n8n workflow automation behind Traefik with automatic HTTPS (Let's Encrypt) |
-| [`scriptTemplates/shellScriptTemplate.sh`](./templates/scriptTemplates/shellScriptTemplate.sh) | Scripts | Shell script starter with safe defaults, traps, and arg parsing |
-| [`scriptTemplates/pythonScriptTemplate.py`](./templates/scriptTemplates/pythonScriptTemplate.py) | Scripts | Python CLI starter with argparse, logging, and validation |
-| [`scriptTemplates/goScriptTemplate.go`](./templates/scriptTemplates/goScriptTemplate.go) | Scripts | Go CLI starter with flag parsing, logging, and validation |
-| [`serverlessFunctionTemplates/awsLambda.py`](./templates/serverlessFunctionTemplates/awsLambda.py) | Serverless | AWS Lambda handler (Python) with input validation and error responses |
-| [`serverlessFunctionTemplates/gcpFunction.py`](./templates/serverlessFunctionTemplates/gcpFunction.py) | Serverless | Google Cloud Function (Python/Flask) with input validation and error responses |
-| [`serverlessFunctionTemplates/netlifyFunction.js`](./templates/serverlessFunctionTemplates/netlifyFunction.js) | Serverless | Netlify Function (Node.js) that fetches and returns JSON from an API |
-| [`webTemplates/netlifyForm.html`](./templates/webTemplates/netlifyForm.html) | Web | Netlify-ready HTML contact form with honeypot spam protection |
+| Template                                                                                                       | Category   | Description                                                                                                                        |
+| -------------------------------------------------------------------------------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| [`ansible.md`](./templates/ansible.md)                                                                         | Ansible    | Standard Ansible project directory structure and setup notes                                                                       |
+| [`docker/genericStack`](./templates/docker/genericStack/)                                                      | Docker     | Generic multi-service Compose sandbox (Ubuntu, nginx, optional DB stack with Postgres/memcached/Adminer) plus `dc*` helper scripts |
+| [`docker/n8n-compose`](./templates/docker/n8n-compose/)                                                        | Docker     | n8n workflow automation behind Traefik with automatic HTTPS (Let's Encrypt)                                                        |
+| [`scriptTemplates/shellScriptTemplate.sh`](./templates/scriptTemplates/shellScriptTemplate.sh)                 | Scripts    | Shell script starter with safe defaults, traps, and arg parsing                                                                    |
+| [`scriptTemplates/pythonScriptTemplate.py`](./templates/scriptTemplates/pythonScriptTemplate.py)               | Scripts    | Python CLI starter with argparse, logging, and validation                                                                          |
+| [`scriptTemplates/goScriptTemplate.go`](./templates/scriptTemplates/goScriptTemplate.go)                       | Scripts    | Go CLI starter with flag parsing, logging, and validation                                                                          |
+| [`serverlessFunctionTemplates/awsLambda.py`](./templates/serverlessFunctionTemplates/awsLambda.py)             | Serverless | AWS Lambda handler (Python) with input validation and error responses                                                              |
+| [`serverlessFunctionTemplates/gcpFunction.py`](./templates/serverlessFunctionTemplates/gcpFunction.py)         | Serverless | Google Cloud Function (Python/Flask) with input validation and error responses                                                     |
+| [`serverlessFunctionTemplates/netlifyFunction.js`](./templates/serverlessFunctionTemplates/netlifyFunction.js) | Serverless | Netlify Function (Node.js) that fetches and returns JSON from an API                                                               |
+| [`webTemplates/netlifyForm.html`](./templates/webTemplates/netlifyForm.html)                                   | Web        | Netlify-ready HTML contact form with honeypot spam protection                                                                      |
 
 See [`templates/README.md`](./templates/README.md) for conventions and per-category details.
 
 ## AI Assets
 
 `ai/` collects reusable AI assets organized by type — `skills/`, `prompts/`, `agents/`, `rules/`, `evals/`, `tools/`, `workflows/`, `mcp/`, `knowledge/`, and `memories/`. Most are placeholders for now; the populated area is **skills**, which follow the Agent Skills convention (a `SKILL.md` with `name`/`description` frontmatter).
 
-| Skill | Status | Description |
-| --- | --- | --- |
-| [`design/explore-designs`](./ai/skills/design/explore-designs/) | Draft | Guides using Claude Design to explore design directions across your frontend stack |
-| [`design/create-design-system`](./ai/skills/design/create-design-system/) | Placeholder | Design-system setup |
-| [`design/design-handoff`](./ai/skills/design/design-handoff/) | Ready | Reconciles a finished Claude Design export into a real codebase — tokens → shadcn/Tailwind v4 OKLCH, `/brand` page, contrast + licensing gates |
+| Skill                                                                     | Status      | Description                                                                                                                                                                                              |
+| ------------------------------------------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`design/explore-designs`](./ai/skills/design/explore-designs/)           | Draft       | Guides using Claude Design to explore design directions across your frontend stack                                                                                                                       |
+| [`design/create-design-system`](./ai/skills/design/create-design-system/) | Placeholder | Design-system setup                                                                                                                                                                                      |
+| [`design/design-handoff`](./ai/skills/design/design-handoff/)             | Ready       | Implements a Claude Design `.tar.gz` handoff into a real codebase — reconcile an existing design system or bootstrap a new one (tokens → shadcn/Tailwind v4 OKLCH, `/brand`, contrast + licensing gates) |
 
 ## Inspired by Other Boilerplate Repos