Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions .agents/skills/openclaw-design-audit/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: openclaw-design-audit
description: Audit OpenClaw frontend code and rendered interfaces for design-system drift, token misuse, primitive reimplementation, accessibility problems, responsive defects, and off-brand copy. Use for design reviews, compliance checks, or scheduled audit-and-fix workflows.
description: Audit OpenClaw frontend code and rendered interfaces for Carapace drift, token misuse, primitive reimplementation, accessibility problems, responsive defects, and off-brand copy. Use for design reviews, compliance checks, or scheduled audit-and-fix workflows.
---

# OpenClaw Design Audit
Expand All @@ -11,10 +11,10 @@ unless a documented rule makes them violations.
## Workflow

1. Read [rubric.md](references/rubric.md) and run every applicable category.
2. Read the consumer's installed design-system version and current commit SHA.
3. Read the version-matched
[token contract](../openclaw-design-system/references/tokens.md) and
[consumer adapters](../openclaw-design-system/references/consumer-adapters.md).
2. Read the consumer's installed Carapace version and current commit SHA.
3. Read the version-matched token contract and consumer adapters from the
installed product guidance skill: `openclaw-carapace` for new installs or
the `openclaw-design-system` compatibility alias for an upgraded lock.
4. Read the brand or marketing references when those categories apply.
5. Run deterministic source checks before judgment-based review.
6. Inspect representative rendered routes at desktop and mobile sizes.
Expand All @@ -31,7 +31,7 @@ Each finding must include:
- category and severity
- stable rule ID
- concise remediation
- design-system reference
- Carapace reference
- whether the finding is mechanical or judgment-based

## Curation
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ deterministic, and covered by an existing rule.
- use an established local primitive instead of a duplicate raw control
- add a missing accessible label when intent is unambiguous
- repair clipping or overflow without changing information architecture
- update the pinned design-system tag in a dedicated dependency change
- update the pinned Carapace tag in a dedicated dependency change

## Requires Human Review

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ The scheduled ClawHub audit opens a pull request directly against
`openclaw/clawhub`. It does not create or update a tracker issue.

The schedule and credentials live in the consumer repository's GitHub Actions
workflow. This design-system skill defines the audit and delivery contract; it
workflow. This Carapace skill defines the audit and delivery contract; it
does not schedule itself.

## Branch And Scope
Expand All @@ -18,7 +18,7 @@ does not schedule itself.

1. Checkout `openclaw/clawhub` with full history and fetch remote `main`.
2. Reset only the dedicated automation branch to `origin/main`.
3. Install the design system at the workflow's pinned Git tag.
3. Install Carapace at the workflow's pinned Git tag.
4. Run source checks, browser checks, and report generation.
5. Apply only fixes allowed by `fix-policy.md`.
6. Write reports under the consumer's established audit-artifact path.
Expand All @@ -32,7 +32,7 @@ does not schedule itself.

The title must identify the audit and date. The body includes:

- design-system version
- Carapace version
- audited ClawHub SHA
- count by severity
- commands and routes checked
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,9 @@ Produce both `design-audit.json` and `design-audit.md`.

```json
{
"designSystemVersion": "v0.0.1",
"schemaVersion": 2,
"carapaceVersion": "v0.1.0",
"designSystemVersion": "v0.1.0",
"consumerSha": "<sha>",
"summary": {
"errors": 0,
Expand All @@ -22,20 +24,24 @@ Produce both `design-audit.json` and `design-audit.md`.
"line": 12,
"message": "Use the semantic accent token.",
"remediation": "Replace the raw coral value with var(--oc-accent-primary).",
"reference": "openclaw-design-system/references/tokens.md"
"reference": "openclaw-carapace/references/tokens.md"
}
]
}
```

During the `v0.1.x` migration, emit both version fields with the same value.
`designSystemVersion` is retained for existing parsers; new consumers should
read `carapaceVersion`.

Sort findings by severity, rule ID, file, then line. Keep stable IDs so recurring
automation can compare runs.

## Markdown

Include:

1. audited design-system version and consumer SHA
1. audited Carapace version and consumer SHA
2. validation commands and rendered routes
3. count by severity
4. every error
Expand Down
11 changes: 9 additions & 2 deletions .agents/skills/openclaw-design-system/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,19 @@
---
name: openclaw-design-system
description: Build or modify OpenClaw application UI using canonical semantic tokens, themes, shared CSS foundations, consumer adapters, and established local primitives. Use for product interfaces, component styling, theme work, or design-token integration.
description: Compatibility alias for existing OpenClaw installations that now applies Carapace semantic tokens, themes, shared CSS foundations, consumer adapters, and established local primitives.
---

# OpenClaw Design System
# 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

Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
# Consumer Adapters

This compatibility reference uses the legacy `@openclaw/design-system`
specifier so consumers pinned to `v0.0.1` keep building. If the consumer
manifest already installs `@openclaw/carapace`, use that package name for the
same exported paths.

## Plain CSS And Astro

Use the complete contract when the global reset is desired:
Expand Down
15 changes: 10 additions & 5 deletions .agents/skills/openclaw-design-system/references/tokens.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,9 @@
# Token Contract

Import `@openclaw/design-system` for the complete foundation or use focused
exports when the consumer must control reset and adapter order.
exports when the consumer must control reset and adapter order. This legacy
specifier is intentional for consumers that have not migrated their dependency
to `@openclaw/carapace`.

## Layers

Expand All @@ -19,13 +21,16 @@ exports when the consumer must control reset and adapter order.
- Page background: `--oc-bg-page`
- Ordinary surface: `--oc-bg-surface`
- Elevated surface: `--oc-bg-elevated`
- Primary, secondary, muted text: `--oc-text-primary`,
`--oc-text-secondary`, `--oc-text-muted`
- Inset and inverted surfaces: `--oc-bg-recessed`, `--oc-bg-contrast`
- Primary, secondary, muted, inactive, inverse, and link text:
`--oc-text-primary`, `--oc-text-secondary`, `--oc-text-muted`,
`--oc-text-inactive`, `--oc-text-inverse`, `--oc-text-link`
- Primary action: `--oc-accent-primary`; hover:
`--oc-accent-primary-hover`
- Secondary accent: `--oc-accent-secondary`
- Subtle and accent borders: `--oc-border-subtle`,
`--oc-border-accent`
- Neutral control backgrounds: `--oc-control-bg`, `--oc-control-bg-hover`
- Subtle, strong, and accent borders: `--oc-border-subtle`,
`--oc-border-strong`, `--oc-border-accent`
- Focus: `--oc-focus-ring`

Use `color-mix()` from semantic variables for a local translucent state. Add a
Expand Down
9 changes: 6 additions & 3 deletions .agents/skills/openclaw-design/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: openclaw-design
description: Route OpenClaw design work to the canonical brand, product design-system, marketing-page, or design-audit guidance. Use when a task touches OpenClaw visual identity, shared CSS tokens, product UI, public web pages, or design-system compliance.
description: Route OpenClaw design work to canonical brand, Carapace product-interface, marketing-page, or design-audit guidance. Use when a task touches OpenClaw visual identity, shared CSS tokens, product UI, public web pages, or Carapace compliance.
---

# OpenClaw Design
Expand All @@ -11,13 +11,16 @@ only when the task genuinely crosses them.
| Skill | Use for |
| --- | --- |
| `openclaw-brand` | Identity decisions, typography, logos, imagery, voice, and non-product brand artifacts |
| `openclaw-design-system` | Application UI, semantic tokens, themes, component reuse, and framework adapters |
| `openclaw-carapace` | Application UI, semantic tokens, themes, component reuse, and framework adapters |
| `openclaw-design-system` | Compatibility alias for projects upgrading an existing skill lock |
| `openclaw-marketing-pages` | Public-page composition, landing/content pages, navigation, SEO, and responsive layout |
| `openclaw-design-audit` | Design drift, token misuse, component substitution, accessibility, and recurring audits |

For a public website change, start with `openclaw-marketing-pages` and add
`openclaw-brand` only when the task changes identity, logo, imagery, typography,
or voice. For a product application, start with `openclaw-design-system`.
or voice. For a product application, start with `openclaw-carapace` when it is
installed. Projects upgrading an existing lock may use
`openclaw-design-system` as the `v0.1.x` compatibility alias.

## Shared Contract

Expand Down
6 changes: 3 additions & 3 deletions skills-lock.json
Original file line number Diff line number Diff line change
Expand Up @@ -11,19 +11,19 @@
"source": "openclaw/design-system",
"sourceType": "github",
"skillPath": "openclaw-design/SKILL.md",
"computedHash": "096be7d1e5e65e62b7de5b96e3897b6ac3a1f45686ee5599dfcbaeaeb607b4ec"
"computedHash": "4a9004e762b08f6c9fc836de7b4db26fc27e7b9a90342884047bbffa51c21732"
},
"openclaw-design-audit": {
"source": "openclaw/design-system",
"sourceType": "github",
"skillPath": "openclaw-design-audit/SKILL.md",
"computedHash": "12fec90fd4aa1aa569de1beb5a3c85d06887a5e548704dbd094355edc0f52ad3"
"computedHash": "aff7655c532d67205301590f76d8655a42f36d14fbd1960d4e4b9b8149291aa3"
},
"openclaw-design-system": {
"source": "openclaw/design-system",
"sourceType": "github",
"skillPath": "openclaw-design-system/SKILL.md",
"computedHash": "475604f08f37186237fa62605fbfe16ea04367af81f4c3a8c59bcb395ae70cca"
"computedHash": "6d94e825c58fc5650a532e4ed8bc96208ede8a166089598d1924393cc46f3275"
},
"openclaw-marketing-pages": {
"source": "openclaw/design-system",
Expand Down