diff --git a/.agents/skills/openclaw-carapace/references/tokens.md b/.agents/skills/openclaw-carapace/references/tokens.md
index 64cf84637c..29e35d3579 100644
--- a/.agents/skills/openclaw-carapace/references/tokens.md
+++ b/.agents/skills/openclaw-carapace/references/tokens.md
@@ -11,9 +11,16 @@ exports when the consumer must control reset and adapter order.
 | Semantic | `--oc-bg-*`, `--oc-text-*`, `--oc-accent-*` | Theme-aware UI intent |
 | Scale | `--oc-space-*`, `--oc-font-size-*`, `--oc-radius-*` | Shared dimensions |
 | Motion | `--oc-duration-*`, `--oc-ease-*` | Shared interaction timing |
+| Layer | `--oc-layer-*` | Popover and non-modal notification stacking roles |
 | Product | `--oc-status-*`, `--oc-input-*`, `--oc-diff-*` | Opt-in operational UI |
 | Consumer alias | Unprefixed legacy names | Migration compatibility only |
 
+Component styles consume semantic and product roles in their owning
+stylesheet; Carapace does not define a global component-token namespace. When
+a component genuinely needs a local custom property, scope it to the component
+root and document the override point beside that component rather than turning
+it into a second palette.
+
 ## Semantic Choices
 
 - Page background: `--oc-bg-page`
@@ -27,6 +34,10 @@ exports when the consumer must control reset and adapter order.
   `--oc-accent-primary-hover`
 - Secondary accent: `--oc-accent-secondary`
 - Neutral control backgrounds: `--oc-control-bg`, `--oc-control-bg-hover`
+- Modal isolation: `--oc-surface-modal-backdrop`; ordinary translucent
+  surfaces continue to use `--oc-surface-overlay`
+- Product fields: `--oc-input-*`; status feedback: paired `--oc-status-*-bg`
+  and `--oc-status-*-fg` roles
 - Subtle, strong, and accent borders: `--oc-border-subtle`,
   `--oc-border-strong`, `--oc-border-accent`
 - Focus: `--oc-focus-ring`
diff --git a/.agents/skills/openclaw-design-system/references/tokens.md b/.agents/skills/openclaw-design-system/references/tokens.md
index 20263ce99f..1d1219423a 100644
--- a/.agents/skills/openclaw-design-system/references/tokens.md
+++ b/.agents/skills/openclaw-design-system/references/tokens.md
@@ -13,9 +13,16 @@ to `@openclaw/carapace`.
 | Semantic | `--oc-bg-*`, `--oc-text-*`, `--oc-accent-*` | Theme-aware UI intent |
 | Scale | `--oc-space-*`, `--oc-font-size-*`, `--oc-radius-*` | Shared dimensions |
 | Motion | `--oc-duration-*`, `--oc-ease-*` | Shared interaction timing |
+| Layer | `--oc-layer-*` | Popover and non-modal notification stacking roles |
 | Product | `--oc-status-*`, `--oc-input-*`, `--oc-diff-*` | Opt-in operational UI |
 | Consumer alias | Unprefixed legacy names | Migration compatibility only |
 
+Component styles consume semantic and product roles in their owning
+stylesheet; Carapace does not define a global component-token namespace. When
+a component genuinely needs a local custom property, scope it to the component
+root and document the override point beside that component rather than turning
+it into a second palette.
+
 ## Semantic Choices
 
 - Page background: `--oc-bg-page`
@@ -29,6 +36,10 @@ to `@openclaw/carapace`.
   `--oc-accent-primary-hover`
 - Secondary accent: `--oc-accent-secondary`
 - Neutral control backgrounds: `--oc-control-bg`, `--oc-control-bg-hover`
+- Modal isolation: `--oc-surface-modal-backdrop`; ordinary translucent
+  surfaces continue to use `--oc-surface-overlay`
+- Product fields: `--oc-input-*`; status feedback: paired `--oc-status-*-bg`
+  and `--oc-status-*-fg` roles
 - Subtle, strong, and accent borders: `--oc-border-subtle`,
   `--oc-border-strong`, `--oc-border-accent`
 - Focus: `--oc-focus-ring`
diff --git a/skills-lock.json b/skills-lock.json
index 8c2dca30ab..98c5a8d561 100644
--- a/skills-lock.json
+++ b/skills-lock.json
@@ -11,7 +11,7 @@
       "source": "openclaw/carapace",
       "sourceType": "github",
       "skillPath": "openclaw-carapace/SKILL.md",
-      "computedHash": "6d7a33003875107ab35d4ac978753cc95b38b38aaaa306ae3db54f935d5451f7"
+      "computedHash": "84d8602ecdf8e1ad39cd4c5ae8f1165da571619746ab705a471d6fdfe7f4ef3e"
     },
     "openclaw-design": {
       "source": "openclaw/carapace",
@@ -29,7 +29,7 @@
       "source": "openclaw/carapace",
       "sourceType": "github",
       "skillPath": "openclaw-design-system/SKILL.md",
-      "computedHash": "6d94e825c58fc5650a532e4ed8bc96208ede8a166089598d1924393cc46f3275"
+      "computedHash": "e7ff42933430aaf28bd2ca7a9e861c62e4aadddc7604d777118b7fec3304b042"
     },
     "openclaw-marketing-pages": {
       "source": "openclaw/carapace",