feat: add OpenClaw platform support (#527)

* feat: add OpenClaw platform support

Add OpenClaw as an install target so the skill can be installed with
`uipro init --ai openclaw` and removed via `uipro uninstall`.

OpenClaw discovers AgentSkills-format skills from `.agents/skills` in the
agent workspace and from `~/.agents/skills` (personal library on the default
state dir), so the platform config reuses the `.agents` layout already used
by the universal/codex targets with its own display name, detection entry,
and docs.

- new platform config src/ui-ux-pro-max/templates/platforms/openclaw.json
  (synced to cli/assets via sync:assets)
- register 'openclaw' in AIType, AI_TYPES, AI_FOLDERS, AI_TO_PLATFORM
- detect the shared .agents workspace directory and describe the platform
- keep the .agents-family suggestion on codex when all four .agents
  consumers are detected (length 2-3 -> 2-4)
- cover openclaw in the dry-run, template-script-paths, and
  agent-query-contract e2e specs
- document OpenClaw in README and cli/README

* chore: bump version to 2.15.0 in skill metadata files

Aligns skill.json, marketplace.json, and plugin.json with the latest
v2.15.0 release; main was still at 2.13.0. CLI package version stays on
its own npm release track.

* fix: cover OpenClaw in offline validator and detection regression

- bump scripts/validate-agent-guide.py PLATFORM_COUNT 21 -> 23 (main
  already had 22 configs with a stale count of 21; OpenClaw widens the
  gap to 23, so update the gate and keep it meaningful)
- add e2e regression: a sole .agents directory detects all four
  consumers (antigravity, codex, universal, openclaw) and still
  suggests codex rather than all
This commit is contained in:
XiaOldMan 2026-10-12 19:08:03 +08:00 committed by GitHub
parent 026b6e172c
commit 7246805992
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
15 changed files with 95 additions and 10 deletions

View File

@ -6,14 +6,14 @@
},
"metadata": {
"description": "UI/UX design intelligence skill with 79 styles, 192 palettes, 74 font pairings, 25 charts, and 22 stack guidelines",
"version": "2.13.0"
"version": "2.15.0"
},
"plugins": [
{
"name": "ui-ux-pro-max",
"source": "./",
"description": "Professional UI/UX design intelligence for AI coding assistants. Includes searchable databases of styles, colors, typography, charts, and UX guidelines for React, Next.js, Astro, Vue, Nuxt.js, Nuxt UI, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, Jetpack Compose, Angular, Laravel, JavaFX, and Three.js.",
"version": "2.13.0",
"version": "2.15.0",
"author": {
"name": "nextlevelbuilder"
},

View File

@ -1,7 +1,7 @@
{
"name": "ui-ux-pro-max",
"description": "UI/UX design intelligence. Searchable local database with 79 styles, 192 palettes, 74 font pairings, 25 charts, and 22 stacks (React, Next.js, Vue, Nuxt.js, Nuxt UI, Svelte, Astro, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, Jetpack Compose, Angular, Laravel, JavaFX, WPF, WinUI, Avalonia, Uno Platform, UWP, Three.js). Use when designing, building, or reviewing UI: pages, components, color schemes, typography, layout, accessibility, animation, or data visualization.",
"version": "2.13.0",
"version": "2.15.0",
"author": {
"name": "nextlevelbuilder"
},

View File

@ -290,6 +290,7 @@ uipro init --ai augment # Augment
uipro init --ai codewhale # CodeWhale
uipro init --ai zcode # ZCode
uipro init --ai amazonq # Amazon Q Developer
uipro init --ai openclaw # OpenClaw (.agents/skills/)
uipro init --ai universal # Universal / Agent Standard (.agents/skills/)
uipro init --ai all # All assistants
```
@ -334,7 +335,7 @@ If it is missing, install it yourself from [python.org](https://www.python.org/d
### Skill Mode (Auto-activate)
**Supported:** Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory), KiloCode, Warp, Augment, CodeWhale, ZCode, Amazon Q Developer
**Supported:** Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory), KiloCode, Warp, Augment, CodeWhale, ZCode, Amazon Q Developer, OpenClaw
The skill activates automatically when you request UI/UX work. Just chat naturally:

View File

@ -25,6 +25,7 @@ uipro init --ai gemini # Gemini CLI
uipro init --ai trae # Trae
uipro init --ai opencode # OpenCode
uipro init --ai amazonq # Amazon Q Developer
uipro init --ai openclaw # OpenClaw (.agents/skills/)
uipro init --ai universal # Universal / Agent Standard (.agents/skills/)
uipro init --ai all # All assistants

View File

@ -0,0 +1,21 @@
{
"platform": "openclaw",
"displayName": "OpenClaw",
"installType": "full",
"folderStructure": {
"root": ".agents",
"skillPath": "skills/ui-ux-pro-max",
"filename": "SKILL.md"
},
"scriptPath": "skills/ui-ux-pro-max/scripts/search.py",
"frontmatter": {
"name": "ui-ux-pro-max",
"description": "UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks."
},
"sections": {
"quickReference": false
},
"title": "ui-ux-pro-max",
"description": "UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.",
"skillOrWorkflow": "Skill"
}

View File

@ -1,4 +1,4 @@
export type AIType = 'claude' | 'cursor' | 'windsurf' | 'antigravity' | 'copilot' | 'kiro' | 'roocode' | 'codex' | 'qoder' | 'gemini' | 'trae' | 'opencode' | 'continue' | 'codebuddy' | 'droid' | 'kilocode' | 'warp' | 'augment' | 'codewhale' | 'zcode' | 'amazonq' | 'universal' | 'all';
export type AIType = 'claude' | 'cursor' | 'windsurf' | 'antigravity' | 'copilot' | 'kiro' | 'roocode' | 'codex' | 'qoder' | 'gemini' | 'trae' | 'opencode' | 'continue' | 'codebuddy' | 'droid' | 'kilocode' | 'warp' | 'augment' | 'codewhale' | 'zcode' | 'amazonq' | 'openclaw' | 'universal' | 'all';
export type ConcreteAIType = Exclude<AIType, 'all'>;
export type InstallType = 'full' | 'reference';
@ -43,7 +43,7 @@ export interface PlatformConfig {
skillOrWorkflow: string;
}
export const AI_TYPES: AIType[] = ['claude', 'cursor', 'windsurf', 'antigravity', 'copilot', 'roocode', 'kiro', 'codex', 'qoder', 'gemini', 'trae', 'opencode', 'continue', 'codebuddy', 'droid', 'kilocode', 'warp', 'augment', 'codewhale', 'zcode', 'amazonq', 'universal', 'all'];
export const AI_TYPES: AIType[] = ['claude', 'cursor', 'windsurf', 'antigravity', 'copilot', 'roocode', 'kiro', 'codex', 'qoder', 'gemini', 'trae', 'opencode', 'continue', 'codebuddy', 'droid', 'kilocode', 'warp', 'augment', 'codewhale', 'zcode', 'amazonq', 'openclaw', 'universal', 'all'];
// Legacy folder mapping for backward compatibility with ZIP-based installs.
// Note: .shared is included for platforms that used ZIP installs. Post-ZIP platforms
@ -70,5 +70,6 @@ export const AI_FOLDERS: Record<ConcreteAIType, string[]> = {
codewhale: ['.codewhale', '.shared'],
zcode: ['.zcode', '.shared'],
amazonq: ['.amazonq', '.shared'],
openclaw: ['.agents', '.shared'],
universal: ['.agents', '.shared'],
};

View File

@ -23,6 +23,7 @@ export function detectAIType(cwd: string = process.cwd()): DetectionResult {
detected.push('antigravity');
detected.push('codex');
detected.push('universal');
detected.push('openclaw');
} else if (existsSync(join(cwd, '.agent'))) {
detected.push('antigravity');
}
@ -83,7 +84,7 @@ export function detectAIType(cwd: string = process.cwd()): DetectionResult {
if (detected.length === 1) {
suggested = detected[0];
} else if (
(detected.length === 2 || detected.length === 3) &&
(detected.length >= 2 && detected.length <= 4) &&
detected.includes('antigravity') &&
detected.includes('codex')
) {
@ -140,6 +141,8 @@ export function getAITypeDescription(aiType: AIType): string {
return 'ZCode (.zcode/skills/)';
case 'amazonq':
return 'Amazon Q Developer (.amazonq/rules/)';
case 'openclaw':
return 'OpenClaw (.agents/skills/)';
case 'universal':
return 'Universal (.agents/skills/)';
case 'all':

View File

@ -56,6 +56,7 @@ const AI_TO_PLATFORM: Record<string, string> = {
codewhale: 'codewhale',
zcode: 'zcode',
amazonq: 'amazonq',
openclaw: 'openclaw',
universal: 'universal',
};

View File

@ -6,7 +6,7 @@ const DESCRIPTION =
test('all platform metadata uses one accurate activation description', async () => {
const configs = await loadAllPlatformConfigs();
expect(configs.size).toBe(22);
expect(configs.size).toBe(23);
for (const [platform, config] of configs) {
expect(config.description, platform).toBe(DESCRIPTION);
if (config.frontmatter?.description) {

View File

@ -0,0 +1,22 @@
import { expect, test } from '@playwright/test';
import { mkdir, mkdtemp } from 'node:fs/promises';
import { tmpdir } from 'node:os';
import { join } from 'node:path';
import { detectAIType, getAITypeDescription } from '../../src/utils/detect.js';
test('a sole .agents directory detects every consumer and still suggests codex', async () => {
const scratch = await mkdtemp(join(tmpdir(), 'uipro-detect-agents-'));
await mkdir(join(scratch, '.agents'));
const { detected, suggested } = detectAIType(scratch);
// All four .agents consumers are detected, OpenClaw included.
expect(detected).toEqual(['antigravity', 'codex', 'universal', 'openclaw']);
// The shared folder must not degrade the suggestion to "all" now that a
// fourth consumer exists — it stays on the .agents-family default.
expect(suggested).toBe('codex');
});
test('openclaw has a platform description', async () => {
expect(getAITypeDescription('openclaw')).toBe('OpenClaw (.agents/skills/)');
});

View File

@ -58,6 +58,19 @@ test('dry-run plan keeps amazonq data and sub-skills out of the rules folder', a
expect(actions[2].endsWith(`: ${join(scratch, '.amazonq', 'skills')}`)).toBe(true);
});
test('dry-run plan supports the openclaw platform layout', async () => {
const scratch = await mkdtemp(join(tmpdir(), 'uipro-dry-run-openclaw-'));
const actions = await planPlatformInstallActions(scratch, 'openclaw');
const joined = actions.join('\n');
expect(joined).toContain(
join(scratch, '.agents', 'skills', 'ui-ux-pro-max', 'SKILL.md')
);
expect(joined).toContain('Would copy data + scripts:');
expect(joined).toContain('Would copy 6 sub-skills (');
});
test('dry-run plan for all platforms covers every unique layout', async () => {
const scratch = await mkdtemp(join(tmpdir(), 'uipro-dry-run-all-'));

View File

@ -9,6 +9,7 @@ const cases = [
['droid', '.factory/skills/ui-ux-pro-max/scripts/search.py'],
['zcode', '.zcode/skills/ui-ux-pro-max/scripts/search.py'],
['amazonq', '.amazonq/skills/ui-ux-pro-max/scripts/search.py'],
['openclaw', '.agents/skills/ui-ux-pro-max/scripts/search.py'],
] as const;
const SEARCH_COMMAND_COUNT = 17;

View File

@ -28,7 +28,7 @@ FLAGS = {
"-f", "--persist", "--page", "--output-dir", "-o", "--force",
"--variance", "--motion", "--density",
}
PLATFORM_COUNT = 21
PLATFORM_COUNT = 23
GUIDE_REQUIREMENTS = (
"## Query Contract", "one dominant intent", "Retry once",
"Do not persist unverified output", "explicit accessibility outcome terms",

View File

@ -2,7 +2,7 @@
"name": "ui-ux-pro-max",
"displayName": "UI/UX Pro Max",
"description": "AI-powered design intelligence with 79 UI styles, 192 color palettes, 74 font pairings, 119 UX guidelines, and 25 chart types across 22 tech stacks.",
"version": "2.13.0",
"version": "2.15.0",
"author": "NextLevelBuilder",
"license": "MIT",
"homepage": "https://uupm.cc",

View File

@ -0,0 +1,21 @@
{
"platform": "openclaw",
"displayName": "OpenClaw",
"installType": "full",
"folderStructure": {
"root": ".agents",
"skillPath": "skills/ui-ux-pro-max",
"filename": "SKILL.md"
},
"scriptPath": "skills/ui-ux-pro-max/scripts/search.py",
"frontmatter": {
"name": "ui-ux-pro-max",
"description": "UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks."
},
"sections": {
"quickReference": false
},
"title": "ui-ux-pro-max",
"description": "UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.",
"skillOrWorkflow": "Skill"
}