ui-craft
Design, build, review, or refactor visible UI, including pages, components, forms, loading/error states, and AI chat/streaming interfaces. Excludes backend, infrastructure, CLI/TUI, and docs-only work.
- License 许可
- MIT
- 所属仓库
- compozy/compozy
- 最近更新
- 2026-11-15
- Stars
- ★ 2.9k
- Forks
- 187
01 前言 Front Matter
- name
- ui-craft
- metadata
- { "author": "Pedro Nauck", "github": "https://github.com/pedronauck", "repository": "https://github.com/pedronauck/skills" }
- description
- Design, build, review, or refactor visible UI, including pages, components, forms, loading/error states, and AI chat/streaming interfaces. Excludes backend, infrastructure, CLI/TUI, and docs-only work.
02 资源文件 19
- 资产文件assets/pre-ship-checklist.md2.9 KB
- 资产文件assets/state-matrix.md4.9 KB
- 资产文件assets/ui-audit-template.md2.2 KB
- 参考文档references/accessibility-floor.md9.9 KB
- 参考文档references/ai-slop-patterns.md14.8 KB
- 参考文档references/anti-defaults.md5.6 KB
- 参考文档references/archetypes.md15.7 KB
- 参考文档references/component-patterns.md16.9 KB
- 参考文档references/dark-mode.md11.8 KB
- 参考文档references/design-system-integration.md13.5 KB
- 参考文档references/human-ai-ux.md12.3 KB
- 参考文档references/microcopy-quality.md9.6 KB
- 参考文档references/motion-patterns.md12.1 KB
- 参考文档references/performance.md5.1 KB
- 参考文档references/usability-foundations.md11.6 KB
- 参考文档references/visual-craft.md14.0 KB
- 脚本scripts/check-contrast.mjs8.5 KB
- 脚本scripts/detect-token-drift.mjs6.7 KB
- 脚本scripts/validate-metadata.py2.1 KB
03 SKILL.md 正文
UI Craft
Use the project's visual and copy authorities, shipped primitive inventory, and real runtime behavior. Preserve keyboard/focus operation, supported states, meaningful labels, contrast, reduced motion, and token ownership.
For a small edit, inspect the affected component/state and reuse existing decisions. A new surface or substantial redesign may need a short user job, scene, register, or visual dials when those resolve an actual design choice; they are not required artifacts for every tweak.
- Read the relevant design/token/copy contract. When generated documentation and runtime tokens disagree, follow the project's canonical-source rule and regenerate through its owning tool.
- Reuse existing primitives and supported states. Do not invent controls, metrics, helper copy, brand variants, or host chrome to satisfy a prototype.
- Match verification to changed interaction/visual behavior: render the affected states, check keyboard/focus where interaction changes, and compare a named reference when required. Reuse current evidence; whole-surface matrices and all-breakpoint sweeps need corresponding scope.
- Review actual hierarchy, overflow, token drift, misleading interaction, and accessibility defects. Avoid a fixed scorecard that turns subjective preferences into universal merge blockers.
- Update design authorities only for an actual token/pattern change, through their generator when owned by codegen. A missing optional reference does not justify scaffolding a new design system.
References by Need
Use the matching section and its necessary dependencies. The table is a lookup, not a list to load in full. assets/state-matrix.md, assets/pre-ship-checklist.md, and assets/ui-audit-template.md are optional working formats for substantial design/audit tasks; ordinary changes can use concise evidence.
| When | File | Covers |
|---|---|---|
| Designing a novel surface / auditing usability | references/usability-foundations.md |
Nielsen 10, Laws of UX, progressive disclosure, mental models |
| Any interactive widget (dialog, menu, combobox, tabs, slider) | references/accessibility-floor.md |
WCAG 2.2 AA non-negotiables, ARIA patterns, verification recipes |
| Buttons/inputs/dialogs/nav/tables/cards/dropdowns/tabs/toasts | references/component-patterns.md |
States, keyboard contract, a11y, and slop per component |
| Writing or reviewing user-visible text | references/microcopy-quality.md |
Banned vocabulary, per-surface tone, error/empty/CTA templates |
| Auditing AI-generated UI | references/ai-slop-patterns.md |
Before/after + remediation for the 14 patterns, detection prompts |
| A design choice needs reconsideration | references/anti-defaults.md |
Contextual alternatives for hierarchy, legibility, and interaction |
| Building an AI/agent surface | references/human-ai-ux.md |
Microsoft 18 + IBM 4 pillars, streaming/citation/confidence UI |
| Reading/extending DESIGN.md, tokens, shadcn/Radix, codegen rules | references/design-system-integration.md |
DESIGN.md sections, token discipline, Figma/Code Connect |
| No token system, or extending a scale | references/visual-craft.md |
Type/color/spacing/radius/elevation/motion defaults |
| Adding or reviewing animation | references/motion-patterns.md |
Duration bands, easing, CSS/Framer/@starting-style, reduced-motion |
| Implementing or reviewing dark mode | references/dark-mode.md |
Surface-lightness elevation, accent desaturation, dangerous pairs |
| Observed slowdown, performance-sensitive change, or requested audit | references/performance.md |
Measurement, loading feedback, relevant optimizations, project budgets |
| "We need a [Linear/Notion]-like X" | references/archetypes.md |
7 archetypes, each a six-slot signature contract |
Helpers
Resolve these from the actual skill directory (<ui-craft-dir>); run only for the question in scope:
node <ui-craft-dir>/scripts/check-contrast.mjs— read-only contrast calculation for changed rendered colors.node <ui-craft-dir>/scripts/detect-token-drift.mjs— read-only drift scan; use project lint/codegen evidence when it already owns the invariant.python3 <ui-craft-dir>/scripts/validate-metadata.py— authoring metadata validation.
Follow explicit user decisions and project authorities for trade-offs. Record material limitations honestly; do not force a scene interview, design audit, or another approval solely because this skill was used.
04 同仓库更多 Skills
security-review
Security code review for vulnerabilities. Use when asked to "security review", "find vulnerabilities", "check for security issues", "audit security", "OWASP review", or review code for injection, XSS, authentication, authorization, cryptography issues. Provides systematic review with confidence-based reporting.
lesson-learned
Extract evidence-backed engineering lessons from recent changes or incidents. Use for requested reflection, lesson updates, or retiring an obsolete workflow rule.
compozy
Operate CompozyOS. Use when working with CompozyOS sessions, agents, native tools, skills, tasks, Loops, Goals, Terminal, desktops and windows, automation, extensions, or configuration. Don't use for unrelated projects.
remotion-upgrade
Upgrade Remotion, and related packages
remotion-studio
Preview a Remotion video
remotion-saas
Build an app with Remotion