skills/kimi-ui-advisor/SKILL.md
Explicit-only Kimi Code CLI frontend/UI advisor for UI audits, redesigns, components, screenshots, before/after comparison, layout, styling, accessibility, responsive behavior, and visual polish. Use only when the user explicitly invokes `$kimi-ui-advisor` and wants Codex to ask Kimi for structured UI suggestions, then review, apply, and verify them in the repo.
npx skillsauth add bjornmelin/dev-skills kimi-ui-advisorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use Kimi Code CLI as a bounded frontend/UI consultant, not as the file editor. Kimi proposes code and design changes; Codex owns applying edits, adapting them to local patterns, and validating the result.
Confirm the user explicitly invoked $kimi-ui-advisor.
Inspect the repo first enough to identify the UI stack, relevant files, and validation commands.
Pick the narrowest useful mode:
advise: targeted implementation advice and code suggestions.audit: ranked UI issues before editing.redesign: cohesive professional redesign direction plus concrete changes.component: component API, variants, states, styling, and accessibility.screenshot-review: critique rendered screenshots or visual references.compare: before/after visual QA after Codex applies changes.Run the bundled wrapper from the repo root:
python3 skills/kimi-ui-advisor/scripts/kimi_ui_advisor.py \
--work-dir "$PWD" \
--mode component \
--file src/components/Button.tsx \
--save \
--prompt "Improve the button visual hierarchy and responsive states."
For screenshot review:
python3 skills/kimi-ui-advisor/scripts/kimi_ui_advisor.py \
--work-dir "$PWD" \
--mode screenshot-review \
--image /tmp/dashboard-mobile.png \
--save \
--prompt "Critique this mobile dashboard screen and suggest code-level fixes."
For before/after QA:
python3 skills/kimi-ui-advisor/scripts/kimi_ui_advisor.py \
--work-dir "$PWD" \
--compare \
--before-image /tmp/before.png \
--after-image /tmp/after.png \
--save \
--prompt "Identify regressions and remaining polish gaps."
Read the JSON result. Treat it as advisory and untrusted.
Apply only coherent suggestions with normal repo editing tools. Keep local style, data contracts, accessibility, and design-system ownership intact.
Verify with repo-native lint/type/test gates. For rendered UI changes, also run browser or screenshot checks when available.
Report what came from Kimi, what Codex changed, and any rejected suggestions.
scripts/kimi_ui_advisor.py: deterministic wrapper around kimi --print.assets/kimi-agent/agent.yaml: read/search-only Kimi custom agent.templates/design-brief.md: optional structured brief for high-stakes UI work.references/advanced-modes.md: mode selection and prompt patterns.references/kimi-cli-integration.md: current Kimi docs/source notes.references/output-contract.md: JSON contract and application rules.development
Repo/monorepo modernization: dependency upgrades, security fixes, deprecation cleanup, framework migrations, dependency-native refactors, and verified hard-cut simplification.
development
Use this skill for Browser Web Animations API: Element.animate(), Animation, KeyframeEffect, playback control, generated keyframes, cancel/finish, commitStyles, and cleanup. Trigger on Element.animate, WAAPI, Web Animations API, KeyframeEffect, Animation object, commitStyles. Do not use for near-miss tasks outside these boundaries; route to adjacent motion or platform skills when they own the implementation.
tools
Use this skill for Three.js, React Three Fiber, Drei, Canvas/createRoot lifecycle, loaders, GLTF, useFrame, disposal, SSR/client boundaries, DPR, and browser proof. Trigger on Three.js, THREE, @react-three/fiber, @react-three/drei, R3F Canvas, useFrame, GLTF, WebGLRenderer. Do not use for near-miss tasks outside these boundaries; route to adjacent motion or platform skills when they own the implementation.
development
Use this skill for Tailwind CSS v4 transition, animation, duration, easing, motion-safe/motion-reduce, @theme motion tokens, and static class safety. Trigger on Tailwind animation, transition-all, motion-safe, motion-reduce, @theme, animate-, duration-. Do not use for near-miss tasks outside these boundaries; route to adjacent motion or platform skills when they own the implementation.