diff --git a/optional-skills/creative/impeccable/SKILL.md b/optional-skills/creative/impeccable/SKILL.md
index 10f1d0c3c8..f4c0e98d17 100644
--- a/optional-skills/creative/impeccable/SKILL.md
+++ b/optional-skills/creative/impeccable/SKILL.md
@@ -1,14 +1,15 @@
 ---
 name: impeccable
-description: Design guidance for frontend work — /impeccable init, craft, critique, audit, polish, bolder, quieter, animate, typeset, layout, and 18 more sub-commands, plus a deterministic anti-slop detector CLI. Use for websites, landing pages, dashboards, product UI, components, and design systems.
+description: Frontend design guidance, upstream-maintained (impeccable).
 version: 4.1.2
 author: Paul Bakaus (pbakaus)
 license: Apache-2.0
+platforms: [linux, macos, windows]
 metadata:
   hermes:
     tags: [design, frontend, ui, ux, web-design, anti-slop]
     category: creative
-    related_skills: [premium-webapp-ui, claude-design, popular-web-designs]
+    related_skills: [claude-design, popular-web-designs]
     upstream:
       repo: pbakaus/impeccable
       path: .hermes/skills/impeccable
diff --git a/website/docs/reference/optional-skills-catalog.md b/website/docs/reference/optional-skills-catalog.md
index b2751927e8..4ab09825e9 100644
--- a/website/docs/reference/optional-skills-catalog.md
+++ b/website/docs/reference/optional-skills-catalog.md
@@ -63,7 +63,7 @@ hermes skills uninstall <skill-name>
 | [**draw-your-font**](/docs/user-guide/skills/optional/creative/creative-draw-your-font) | Turn a photo of handwriting into an installable font (TTF/WOFF). |
 | [**heartmula**](/docs/user-guide/skills/optional/creative/creative-heartmula) | HeartMuLa: Suno-like song generation from lyrics + tags. |
 | [**hyperframes**](/docs/user-guide/skills/optional/creative/creative-hyperframes) | Render MP4/WebM videos from HTML compositions. |
-| [**impeccable**](/docs/user-guide/skills/optional/creative/creative-impeccable) | Frontend design guidance: 23 /impeccable sub-commands + anti-slop detector (upstream-maintained). |
+| [**impeccable**](/docs/user-guide/skills/optional/creative/creative-impeccable) | Frontend design guidance, upstream-maintained (impeccable). |
 | [**kanban-video-orchestrator**](/docs/user-guide/skills/optional/creative/creative-kanban-video-orchestrator) | Plan and run multi-agent video production pipelines. |
 | [**meme-generation**](/docs/user-guide/skills/optional/creative/creative-meme-generation) | Create meme PNGs from templates with Pillow text overlay. |
 | [**pixel-art**](/docs/user-guide/skills/optional/creative/creative-pixel-art) | Pixel art w/ era palettes (NES, Game Boy, PICO-8). |
diff --git a/website/docs/user-guide/skills/optional/creative/creative-impeccable.md b/website/docs/user-guide/skills/optional/creative/creative-impeccable.md
index f0f067e3aa..55e475d1cd 100644
--- a/website/docs/user-guide/skills/optional/creative/creative-impeccable.md
+++ b/website/docs/user-guide/skills/optional/creative/creative-impeccable.md
@@ -1,14 +1,14 @@
 ---
-title: "Impeccable"
+title: "Impeccable — Frontend design guidance, upstream-maintained (impeccable)"
 sidebar_label: "Impeccable"
-description: "Design guidance for frontend work — /impeccable init, craft, critique, audit, polish, bolder, quieter, animate, typeset, layout, and 18 more sub-commands, pl..."
+description: "Frontend design guidance, upstream-maintained (impeccable)"
 ---
 
 {/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
 
 # Impeccable
 
-Design guidance for frontend work — /impeccable init, craft, critique, audit, polish, bolder, quieter, animate, typeset, layout, and 18 more sub-commands, plus a deterministic anti-slop detector CLI. Use for websites, landing pages, dashboards, product UI, components, and design systems.
+Frontend design guidance, upstream-maintained (impeccable).
 
 ## Skill metadata
 
@@ -19,8 +19,9 @@ Design guidance for frontend work — /impeccable init, craft, critique, audit,
 | Version | `4.1.2` |
 | Author | Paul Bakaus (pbakaus) |
 | License | Apache-2.0 |
+| Platforms | linux, macos, windows |
 | Tags | `design`, `frontend`, `ui`, `ux`, `web-design`, `anti-slop` |
-| Related skills | `premium-webapp-ui`, [`claude-design`](/docs/user-guide/skills/bundled/creative/creative-claude-design), [`popular-web-designs`](/docs/user-guide/skills/bundled/creative/creative-popular-web-designs) |
+| Related skills | [`claude-design`](/docs/user-guide/skills/bundled/creative/creative-claude-design), [`popular-web-designs`](/docs/user-guide/skills/bundled/creative/creative-popular-web-designs) |
 
 ## Reference: full SKILL.md