diff --git a/README.md b/README.md index a680c7d..4787382 100755 --- a/README.md +++ b/README.md @@ -290,6 +290,7 @@ uipro init --ai warp # Warp uipro init --ai augment # Augment uipro init --ai codewhale # CodeWhale uipro init --ai zcode # ZCode +uipro init --ai kimi # Kimi Code uipro init --ai amazonq # Amazon Q Developer uipro init --ai openclaw # OpenClaw (.agents/skills/) uipro init --ai universal # Universal / Agent Standard (.agents/skills/) @@ -304,6 +305,7 @@ The npm package is `ui-ux-pro-max-cli`; it still installs the `uipro` command. O uipro init --ai claude --global # Install to ~/.claude/skills/ uipro init --ai cursor --global # Install to ~/.cursor/skills/ uipro init --ai zcode --global # Install to ~/.zcode/skills/ +uipro init --ai kimi --global # Install to ~/.kimi-code/skills/ uipro init --ai universal --global # Install to ~/.agents/skills/ ``` @@ -336,7 +338,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, OpenClaw, GitHub Copilot +**Supported:** Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory), KiloCode, Warp, Augment, CodeWhale, ZCode, Kimi Code, Amazon Q Developer, OpenClaw, GitHub Copilot The skill activates automatically when you request UI/UX work. Just chat naturally: diff --git a/cli/assets/templates/platforms/kimi.json b/cli/assets/templates/platforms/kimi.json new file mode 100644 index 0000000..7a66ba0 --- /dev/null +++ b/cli/assets/templates/platforms/kimi.json @@ -0,0 +1,21 @@ +{ + "platform": "kimi", + "displayName": "Kimi Code", + "installType": "full", + "folderStructure": { + "root": ".kimi-code", + "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" +} diff --git a/cli/src/types/index.ts b/cli/src/types/index.ts index 6e7376d..f291f4c 100755 --- a/cli/src/types/index.ts +++ b/cli/src/types/index.ts @@ -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' | 'openclaw' | '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' | 'kimi' | 'amazonq' | 'openclaw' | 'universal' | 'all'; export type ConcreteAIType = Exclude; export type InstallType = 'full' | 'reference'; @@ -44,7 +44,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', 'openclaw', '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', 'kimi', '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,6 +70,7 @@ export const AI_FOLDERS: Record = { augment: ['.augment', '.shared'], codewhale: ['.codewhale', '.shared'], zcode: ['.zcode', '.shared'], + kimi: ['.kimi-code', '.shared'], amazonq: ['.amazonq', '.shared'], openclaw: ['.agents', '.shared'], universal: ['.agents', '.shared'], diff --git a/cli/src/utils/detect.ts b/cli/src/utils/detect.ts index 67b102d..4cede07 100755 --- a/cli/src/utils/detect.ts +++ b/cli/src/utils/detect.ts @@ -88,6 +88,9 @@ export function detectAIType(cwd: string = process.cwd()): DetectionResult { if (existsSync(join(cwd, '.zcode'))) { detected.push('zcode'); } + if (existsSync(join(cwd, '.kimi-code'))) { + detected.push('kimi'); + } if (existsSync(join(cwd, '.amazonq'))) { detected.push('amazonq'); } @@ -152,6 +155,8 @@ export function getAITypeDescription(aiType: AIType): string { return 'CodeWhale (.codewhale/skills/)'; case 'zcode': return 'ZCode (.zcode/skills/)'; + case 'kimi': + return 'Kimi Code (.kimi-code/skills/)'; case 'amazonq': return 'Amazon Q Developer (.amazonq/rules/)'; case 'openclaw': diff --git a/cli/src/utils/template.ts b/cli/src/utils/template.ts index 8de9882..b979c2a 100755 --- a/cli/src/utils/template.ts +++ b/cli/src/utils/template.ts @@ -70,6 +70,7 @@ const AI_TO_PLATFORM: Record = { augment: 'augment', codewhale: 'codewhale', zcode: 'zcode', + kimi: 'kimi', amazonq: 'amazonq', openclaw: 'openclaw', universal: 'universal', diff --git a/cli/tests/e2e/agent-query-contract.spec.ts b/cli/tests/e2e/agent-query-contract.spec.ts index 830ff1d..5aafee5 100644 --- a/cli/tests/e2e/agent-query-contract.spec.ts +++ b/cli/tests/e2e/agent-query-contract.spec.ts @@ -6,7 +6,7 @@ const DESCRIPTION = test('all platform metadata uses one accurate activation description', async () => { const configs = await loadAllPlatformConfigs(); - expect(configs.size).toBe(23); + expect(configs.size).toBe(24); for (const [platform, config] of configs) { expect(config.description, platform).toBe(DESCRIPTION); if (config.frontmatter?.description) { diff --git a/cli/tests/e2e/dry-run.spec.ts b/cli/tests/e2e/dry-run.spec.ts index 643c875..2dd9e90 100644 --- a/cli/tests/e2e/dry-run.spec.ts +++ b/cli/tests/e2e/dry-run.spec.ts @@ -43,6 +43,19 @@ test('dry-run plan supports the zcode platform layout', async () => { expect(joined).toContain('Would copy 6 sub-skills ('); }); +test('dry-run plan supports the kimi platform layout', async () => { + const scratch = await mkdtemp(join(tmpdir(), 'uipro-dry-run-kimi-')); + + const actions = await planPlatformInstallActions(scratch, 'kimi'); + + const joined = actions.join('\n'); + expect(joined).toContain( + join(scratch, '.kimi-code', '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 keeps amazonq data and sub-skills out of the rules folder', async () => { const scratch = await mkdtemp(join(tmpdir(), 'uipro-dry-run-amazonq-')); diff --git a/cli/tests/e2e/kimi-skills.spec.ts b/cli/tests/e2e/kimi-skills.spec.ts new file mode 100644 index 0000000..4995568 --- /dev/null +++ b/cli/tests/e2e/kimi-skills.spec.ts @@ -0,0 +1,54 @@ +import { expect, test } from '@playwright/test'; +import { existsSync } from 'node:fs'; +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'; +import { + generatePlatformFiles, + listBundledSubSkills, + loadPlatformConfig, + renderSkillFile, +} from '../../src/utils/template.js'; + +// Kimi Code loads project skills from .kimi-code/skills//SKILL.md +// (and .agents/skills/). SKILL.md needs name and description frontmatter: +// https://www.kimi.com/code/docs/en/kimi-code-cli/customization/skills.html + +function scratchDir(name: string): Promise { + return mkdtemp(join(tmpdir(), `uipro-kimi-${name}-`)); +} + +test('kimi SKILL.md has the name and description frontmatter Kimi Code requires', async () => { + const config = await loadPlatformConfig('kimi'); + const content = await renderSkillFile(config); + const frontmatter = content.match(/^---\n([\s\S]*?)\n---\n/)?.[1] ?? ''; + + expect(frontmatter).toMatch(/^name: ui-ux-pro-max$/m); + expect(frontmatter).toMatch(/^description: "UI\/UX design intelligence/m); +}); + +test('kimi installs the skill, its data and the sub-skills under .kimi-code/skills', async () => { + const scratch = await scratchDir('install'); + + await generatePlatformFiles(scratch, 'kimi'); + + const skills = join(scratch, '.kimi-code', 'skills'); + expect(existsSync(join(skills, 'ui-ux-pro-max', 'SKILL.md'))).toBe(true); + expect(existsSync(join(skills, 'ui-ux-pro-max', 'scripts', 'search.py'))).toBe(true); + expect(existsSync(join(skills, 'ui-ux-pro-max', 'data'))).toBe(true); + for (const name of await listBundledSubSkills()) { + expect(existsSync(join(skills, name, 'SKILL.md')), name).toBe(true); + } +}); + +test('a .kimi-code directory is detected as kimi', async () => { + const scratch = await scratchDir('detect'); + await mkdir(join(scratch, '.kimi-code')); + + const { detected, suggested } = detectAIType(scratch); + + expect(detected).toEqual(['kimi']); + expect(suggested).toBe('kimi'); + expect(getAITypeDescription('kimi')).toBe('Kimi Code (.kimi-code/skills/)'); +}); diff --git a/cli/tests/e2e/template-script-paths.spec.ts b/cli/tests/e2e/template-script-paths.spec.ts index 6938459..a062650 100644 --- a/cli/tests/e2e/template-script-paths.spec.ts +++ b/cli/tests/e2e/template-script-paths.spec.ts @@ -7,6 +7,7 @@ const cases = [ ['kiro', '.kiro/steering/ui-ux-pro-max/scripts/search.py'], ['droid', '.factory/skills/ui-ux-pro-max/scripts/search.py'], ['zcode', '.zcode/skills/ui-ux-pro-max/scripts/search.py'], + ['kimi', '.kimi-code/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; diff --git a/scripts/validate-agent-guide.py b/scripts/validate-agent-guide.py index 0ea0f96..6c0ca86 100644 --- a/scripts/validate-agent-guide.py +++ b/scripts/validate-agent-guide.py @@ -28,7 +28,7 @@ FLAGS = { "-f", "--persist", "--page", "--output-dir", "-o", "--force", "--variance", "--motion", "--density", } -PLATFORM_COUNT = 23 +PLATFORM_COUNT = 24 GUIDE_REQUIREMENTS = ( "## Query Contract", "one dominant intent", "Retry once", "Do not persist unverified output", "explicit accessibility outcome terms", diff --git a/src/ui-ux-pro-max/templates/platforms/kimi.json b/src/ui-ux-pro-max/templates/platforms/kimi.json new file mode 100644 index 0000000..7a66ba0 --- /dev/null +++ b/src/ui-ux-pro-max/templates/platforms/kimi.json @@ -0,0 +1,21 @@ +{ + "platform": "kimi", + "displayName": "Kimi Code", + "installType": "full", + "folderStructure": { + "root": ".kimi-code", + "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" +}