Carapace Compatibility Alias
This skill identifier remains available for existing skills-lock.json
entries during the v0.1.x migration. New installations should use
openclaw-carapace.
Use the shared package for foundations and framework-neutral visual primitives.
Keep consumer-specific behavior, data, routes, and layout composition local.
Before changing imports, inspect the consumer manifest: use
@openclaw/carapace when it is installed, otherwise preserve the legacy
@openclaw/design-system specifier until the dependency is migrated.
Workflow
- Read tokens.md before choosing colors, spacing, type, radii, or shadows.
- Read consumer-adapters.md for the current framework.
- Inspect the consumer's existing shared primitives before creating a component.
- Use semantic tokens for UI intent; use palette primitives only for documented exceptions.
- Keep application behavior, routes, and information architecture unchanged unless the task says otherwise.
- Validate the affected routes with existing tests and real browser screenshots.
Interface Rules
- Import the complete CSS contract or its focused exported entry points.
- Compose shared classes from
components.css before adding a one-off visual implementation.
- Use local shared primitives before raw controls or one-off component implementations.
- Keep one primary action per decision area.
- Use familiar icons for icon-only commands and provide accessible names.
- Use status colors for status, warning, success, error, and informational meaning.
- Keep cards, controls, and repeated fixed-format elements dimensionally stable.
- Avoid nested decorative cards and page sections styled as floating cards.
- Keep surfaces, controls, and insets square through their semantic radius tokens.
- Reserve round geometry for avatars, status dots, and other truly circular indicators.
- Keep focus, hover, active, disabled, loading, and invalid states coherent.
- Keep text within its container at supported viewport sizes.
- Prefer dense, scan-friendly composition for operational product surfaces.
Ownership
Move visual implementation into this repository when its interface is
framework-neutral and useful across consumers. Keep runtime behavior and
framework adapters local until at least two consumers need the same interface
and behavior.
1---
2name: openclaw-design-system
3description: Compatibility alias for existing OpenClaw installations that now applies Carapace semantic tokens, themes, shared CSS foundations, consumer adapters, and established local primitives.
4metadata:
5 source: https://skillmd.com/skills/openclaw/openclaw-design-system
6---
7
8# Carapace Compatibility Alias
9
10This skill identifier remains available for existing `skills-lock.json`
11entries during the `v0.1.x` migration. New installations should use
12`openclaw-carapace`.
13
14Use the shared package for foundations and framework-neutral visual primitives.
15Keep consumer-specific behavior, data, routes, and layout composition local.
16Before changing imports, inspect the consumer manifest: use
17`@openclaw/carapace` when it is installed, otherwise preserve the legacy
18`@openclaw/design-system` specifier until the dependency is migrated.
19
20## Workflow
21
221. Read [tokens.md](references/tokens.md) before choosing colors, spacing, type, radii, or shadows.
232. Read [consumer-adapters.md](references/consumer-adapters.md) for the current framework.
243. Inspect the consumer's existing shared primitives before creating a component.
254. Use semantic tokens for UI intent; use palette primitives only for documented exceptions.
265. Keep application behavior, routes, and information architecture unchanged unless the task says otherwise.
276. Validate the affected routes with existing tests and real browser screenshots.
28
29## Interface Rules
30
31- Import the complete CSS contract or its focused exported entry points.
32- Compose shared classes from `components.css` before adding a one-off visual implementation.
33- Use local shared primitives before raw controls or one-off component implementations.
34- Keep one primary action per decision area.
35- Use familiar icons for icon-only commands and provide accessible names.
36- Use status colors for status, warning, success, error, and informational meaning.
37- Keep cards, controls, and repeated fixed-format elements dimensionally stable.
38- Avoid nested decorative cards and page sections styled as floating cards.
39- Keep surfaces, controls, and insets square through their semantic radius tokens.
40- Reserve round geometry for avatars, status dots, and other truly circular indicators.
41- Keep focus, hover, active, disabled, loading, and invalid states coherent.
42- Keep text within its container at supported viewport sizes.
43- Prefer dense, scan-friendly composition for operational product surfaces.
44
45## Ownership
46
47Move visual implementation into this repository when its interface is
48framework-neutral and useful across consumers. Keep runtime behavior and
49framework adapters local until at least two consumers need the same interface
50and behavior.