@design-ai/cli 4.55.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +164 -0
- package/AGENTS.ko.md +126 -0
- package/AGENTS.md +182 -0
- package/CHANGELOG.md +6883 -0
- package/CLAUDE.md +39 -0
- package/LICENSE +21 -0
- package/README.ko.md +245 -0
- package/README.md +277 -0
- package/agents/README.md +14 -0
- package/agents/a11y-reviewer.md +121 -0
- package/agents/component-architect.md +57 -0
- package/agents/design-critic.md +46 -0
- package/agents/token-extractor.md +63 -0
- package/cli/bin/design-ai-mcp.mjs +6 -0
- package/cli/bin/design-ai.mjs +40 -0
- package/cli/commands/audit.mjs +111 -0
- package/cli/commands/check.mjs +226 -0
- package/cli/commands/doctor.mjs +141 -0
- package/cli/commands/examples.mjs +58 -0
- package/cli/commands/help.mjs +271 -0
- package/cli/commands/install.mjs +161 -0
- package/cli/commands/learn.mjs +1871 -0
- package/cli/commands/list.mjs +143 -0
- package/cli/commands/mcp.mjs +27 -0
- package/cli/commands/pack.mjs +211 -0
- package/cli/commands/prompt.mjs +199 -0
- package/cli/commands/route.mjs +247 -0
- package/cli/commands/search.mjs +60 -0
- package/cli/commands/show.mjs +52 -0
- package/cli/commands/site.mjs +558 -0
- package/cli/commands/status.mjs +161 -0
- package/cli/commands/uninstall.mjs +119 -0
- package/cli/commands/update.mjs +184 -0
- package/cli/commands/version.mjs +94 -0
- package/cli/commands/workspace.mjs +176 -0
- package/cli/lib/brief.mjs +52 -0
- package/cli/lib/check.mjs +642 -0
- package/cli/lib/dispatch.mjs +109 -0
- package/cli/lib/doctor.mjs +505 -0
- package/cli/lib/examples.mjs +258 -0
- package/cli/lib/exec.mjs +63 -0
- package/cli/lib/help-flags.mjs +5 -0
- package/cli/lib/learn.mjs +3694 -0
- package/cli/lib/log.mjs +47 -0
- package/cli/lib/mcp-server.mjs +426 -0
- package/cli/lib/output.mjs +101 -0
- package/cli/lib/pack.mjs +599 -0
- package/cli/lib/paths.mjs +63 -0
- package/cli/lib/prompt.mjs +603 -0
- package/cli/lib/route.mjs +740 -0
- package/cli/lib/search.mjs +158 -0
- package/cli/lib/show.mjs +161 -0
- package/cli/lib/signals.mjs +2337 -0
- package/cli/lib/site.mjs +6617 -0
- package/cli/lib/skill-proposals.mjs +2046 -0
- package/cli/lib/suggest.mjs +66 -0
- package/cli/lib/workspace.mjs +1056 -0
- package/commands/README.md +25 -0
- package/commands/component-spec.md +34 -0
- package/commands/conversational.md +44 -0
- package/commands/design-from-brief.md +141 -0
- package/commands/design-review.md +62 -0
- package/commands/document-from-brief.md +47 -0
- package/commands/extract-tokens.md +38 -0
- package/commands/game-ui.md +40 -0
- package/commands/illustration.md +37 -0
- package/commands/iterate.md +167 -0
- package/commands/motion-design.md +54 -0
- package/commands/palette-from-brand.md +50 -0
- package/commands/print.md +49 -0
- package/commands/slide-deck.md +46 -0
- package/commands/spatial.md +47 -0
- package/commands/stability-review.md +74 -0
- package/commands/video.md +42 -0
- package/commands/website-improvement.md +77 -0
- package/docs/AGENT-DEVELOPMENT.md +658 -0
- package/docs/AI-LEARNING.md +429 -0
- package/docs/AIDER-INTEGRATION.md +224 -0
- package/docs/ARCHITECTURE.ko.md +183 -0
- package/docs/ARCHITECTURE.md +105 -0
- package/docs/CODEX-INTEGRATION.md +311 -0
- package/docs/COMPANY-WEBSITE-DOGFOOD.ko.md +144 -0
- package/docs/COMPANY-WEBSITE-DOGFOOD.md +150 -0
- package/docs/COMPANY-WEBSITE-INTAKE-TEMPLATE.ko.md +153 -0
- package/docs/COMPANY-WEBSITE-INTAKE-TEMPLATE.md +154 -0
- package/docs/CONTRIBUTING.ko.md +203 -0
- package/docs/CONTRIBUTING.md +242 -0
- package/docs/CURSOR-INTEGRATION.md +220 -0
- package/docs/DISTRIBUTION.ko.md +248 -0
- package/docs/DISTRIBUTION.md +253 -0
- package/docs/DOGFOOD-FINDINGS.md +180 -0
- package/docs/DOGFOOD-V4-FINDINGS.md +139 -0
- package/docs/DOGFOOD-V4-MKDOCS-FINDINGS.md +233 -0
- package/docs/DOGFOOD-V4-NPM-FINDINGS.md +157 -0
- package/docs/DOGFOOD-V4-VSCODE-FINDINGS.md +135 -0
- package/docs/FIGMA-INTEGRATION.md +222 -0
- package/docs/MCP-INTEGRATION.md +243 -0
- package/docs/MIGRATION-v4.md +121 -0
- package/docs/PLUGIN-PACKAGING.md +240 -0
- package/docs/PRODUCT-READINESS.md +66 -0
- package/docs/QUICKSTART.ko.md +178 -0
- package/docs/QUICKSTART.md +179 -0
- package/docs/RELEASE-CHECKLIST.md +292 -0
- package/docs/ROADMAP.md +19495 -0
- package/docs/SESSION-LOG.md +940 -0
- package/docs/TOKEN-SYNC.md +237 -0
- package/docs/USING.ko.md +206 -0
- package/docs/USING.md +218 -0
- package/docs/WEBSITE-IMPROVEMENT.ko.md +75 -0
- package/docs/WEBSITE-IMPROVEMENT.md +89 -0
- package/docs/announcements/README.md +56 -0
- package/docs/announcements/dev-to-korea.md +206 -0
- package/docs/announcements/hashnode-post.ko.md +232 -0
- package/docs/announcements/okky-post.ko.md +158 -0
- package/docs/announcements/press-kit.md +101 -0
- package/docs/announcements/reddit-r-korea.md +196 -0
- package/docs/announcements/show-hn.md +114 -0
- package/docs/announcements/twitter-thread.md +255 -0
- package/docs/external-status.md +34 -0
- package/docs/integrations/aider-walkthrough.ko.md +275 -0
- package/docs/integrations/aider-walkthrough.md +274 -0
- package/docs/integrations/codex-walkthrough.ko.md +297 -0
- package/docs/integrations/codex-walkthrough.md +297 -0
- package/docs/integrations/cursor-walkthrough.ko.md +281 -0
- package/docs/integrations/cursor-walkthrough.md +284 -0
- package/docs/integrations/design-ai-mcp-server.md +169 -0
- package/docs/integrations/figma-mcp.md +149 -0
- package/docs/integrations/github-mcp.md +178 -0
- package/docs/integrations/linear-mcp.md +215 -0
- package/docs/integrations/notion-mcp.md +174 -0
- package/docs/integrations/sdk-walkthrough.ko.md +375 -0
- package/docs/integrations/sdk-walkthrough.md +375 -0
- package/docs/integrations/slack-mcp.md +208 -0
- package/docs/integrations/vscode-walkthrough.ko.md +202 -0
- package/docs/integrations/vscode-walkthrough.md +205 -0
- package/docs/requirements.txt +16 -0
- package/docs/site-overrides/extra.css +83 -0
- package/docs/site-overrides/favicon.svg +4 -0
- package/docs/site-overrides/logo.svg +10 -0
- package/docs/site-overrides/main.html +18 -0
- package/docs/website-console/app.js +2540 -0
- package/docs/website-console/index.html +24 -0
- package/docs/website-console/styles.css +975 -0
- package/examples/README.md +252 -0
- package/examples/cases/dogfood-v4-korean-hr-onboarding.md +356 -0
- package/examples/component-accordion-actions.md +153 -0
- package/examples/component-accordion-details.md +147 -0
- package/examples/component-accordion-summary.md +180 -0
- package/examples/component-accordion.md +229 -0
- package/examples/component-account-card.md +284 -0
- package/examples/component-address-input.md +260 -0
- package/examples/component-affix.md +190 -0
- package/examples/component-alert-dialog.md +210 -0
- package/examples/component-alert-title.md +77 -0
- package/examples/component-alert.md +192 -0
- package/examples/component-amount-input.md +278 -0
- package/examples/component-anchor.md +198 -0
- package/examples/component-app-bar.md +249 -0
- package/examples/component-aspect-ratio.md +156 -0
- package/examples/component-auto-complete.md +199 -0
- package/examples/component-avatar-group.md +170 -0
- package/examples/component-avatar.md +191 -0
- package/examples/component-back-top.md +123 -0
- package/examples/component-backdrop.md +148 -0
- package/examples/component-badge.md +181 -0
- package/examples/component-banner.md +237 -0
- package/examples/component-biometric-gate.md +281 -0
- package/examples/component-blockquote.md +153 -0
- package/examples/component-border-beam.md +207 -0
- package/examples/component-bottom-navigation.md +226 -0
- package/examples/component-box.md +112 -0
- package/examples/component-breadcrumb.md +222 -0
- package/examples/component-button-base.md +190 -0
- package/examples/component-button-group.md +117 -0
- package/examples/component-button.md +213 -0
- package/examples/component-calendar.md +280 -0
- package/examples/component-callout.md +131 -0
- package/examples/component-card-actions.md +101 -0
- package/examples/component-card-content.md +90 -0
- package/examples/component-card-header.md +122 -0
- package/examples/component-card-media.md +79 -0
- package/examples/component-card.md +233 -0
- package/examples/component-carousel.md +266 -0
- package/examples/component-cascader.md +135 -0
- package/examples/component-category-picker.md +271 -0
- package/examples/component-chart.md +237 -0
- package/examples/component-chat-interface.md +399 -0
- package/examples/component-checkbox.md +149 -0
- package/examples/component-click-away-listener.md +87 -0
- package/examples/component-code.md +213 -0
- package/examples/component-collapsible.md +219 -0
- package/examples/component-color-picker.md +110 -0
- package/examples/component-combobox.md +267 -0
- package/examples/component-command.md +299 -0
- package/examples/component-config-provider.md +190 -0
- package/examples/component-context-menu.md +179 -0
- package/examples/component-css-baseline.md +148 -0
- package/examples/component-date-picker.md +249 -0
- package/examples/component-descriptions.md +242 -0
- package/examples/component-dialog-actions.md +111 -0
- package/examples/component-dialog-content-text.md +76 -0
- package/examples/component-dialog-content.md +105 -0
- package/examples/component-dialog-title.md +104 -0
- package/examples/component-dialog.md +176 -0
- package/examples/component-divider.md +182 -0
- package/examples/component-doc-page.md +217 -0
- package/examples/component-drawer.md +257 -0
- package/examples/component-dropdown.md +220 -0
- package/examples/component-email-layout.md +253 -0
- package/examples/component-empty-state.md +269 -0
- package/examples/component-empty.md +172 -0
- package/examples/component-fade.md +87 -0
- package/examples/component-feature-grid.md +201 -0
- package/examples/component-field.md +266 -0
- package/examples/component-filled-input.md +114 -0
- package/examples/component-flex.md +117 -0
- package/examples/component-float-button.md +214 -0
- package/examples/component-form-control-label.md +134 -0
- package/examples/component-form-control.md +113 -0
- package/examples/component-form-controls.md +251 -0
- package/examples/component-form-group.md +86 -0
- package/examples/component-form-helper-text.md +95 -0
- package/examples/component-form-label.md +98 -0
- package/examples/component-form.md +291 -0
- package/examples/component-game-hud.md +362 -0
- package/examples/component-game-menu.md +327 -0
- package/examples/component-grid.md +140 -0
- package/examples/component-grow.md +79 -0
- package/examples/component-hero-block.md +252 -0
- package/examples/component-hover-card.md +211 -0
- package/examples/component-icon-button.md +142 -0
- package/examples/component-icon.md +102 -0
- package/examples/component-illustration.md +280 -0
- package/examples/component-image-list.md +107 -0
- package/examples/component-image.md +282 -0
- package/examples/component-input-adornment.md +101 -0
- package/examples/component-input-base.md +134 -0
- package/examples/component-input-number.md +141 -0
- package/examples/component-input-otp.md +271 -0
- package/examples/component-input.md +213 -0
- package/examples/component-item.md +243 -0
- package/examples/component-kbd.md +197 -0
- package/examples/component-krw-amount.md +219 -0
- package/examples/component-label.md +118 -0
- package/examples/component-layout.md +217 -0
- package/examples/component-link.md +223 -0
- package/examples/component-list-item-avatar.md +72 -0
- package/examples/component-list-item-button.md +139 -0
- package/examples/component-list-item-icon.md +82 -0
- package/examples/component-list-item-text.md +98 -0
- package/examples/component-list-item.md +116 -0
- package/examples/component-list-subheader.md +70 -0
- package/examples/component-list.md +198 -0
- package/examples/component-loading-button.md +125 -0
- package/examples/component-loading-sequence.md +254 -0
- package/examples/component-lottie-player.md +279 -0
- package/examples/component-masonry.md +191 -0
- package/examples/component-mentions.md +189 -0
- package/examples/component-menu-item.md +102 -0
- package/examples/component-menu-list.md +98 -0
- package/examples/component-menu.md +139 -0
- package/examples/component-menubar.md +259 -0
- package/examples/component-message.md +162 -0
- package/examples/component-mobile-stepper.md +155 -0
- package/examples/component-modal.md +220 -0
- package/examples/component-navigation-menu.md +295 -0
- package/examples/component-notification.md +166 -0
- package/examples/component-otp-countdown.md +245 -0
- package/examples/component-outlined-input.md +145 -0
- package/examples/component-page-transition.md +281 -0
- package/examples/component-pagination.md +226 -0
- package/examples/component-paper.md +199 -0
- package/examples/component-pass-auth.md +265 -0
- package/examples/component-payment-brand-button.md +253 -0
- package/examples/component-payment-method-selector.md +272 -0
- package/examples/component-payment-receipt.md +277 -0
- package/examples/component-popconfirm.md +144 -0
- package/examples/component-popover.md +239 -0
- package/examples/component-popper.md +129 -0
- package/examples/component-pricing-cards.md +247 -0
- package/examples/component-progress.md +195 -0
- package/examples/component-qr-code.md +201 -0
- package/examples/component-radio.md +167 -0
- package/examples/component-rate.md +202 -0
- package/examples/component-resizable.md +163 -0
- package/examples/component-result.md +270 -0
- package/examples/component-scroll-area.md +199 -0
- package/examples/component-scroll-reveal.md +320 -0
- package/examples/component-segmented.md +178 -0
- package/examples/component-select.md +258 -0
- package/examples/component-separator.md +177 -0
- package/examples/component-sheet.md +277 -0
- package/examples/component-sidebar.md +257 -0
- package/examples/component-skeleton.md +178 -0
- package/examples/component-slide.md +89 -0
- package/examples/component-slider.md +208 -0
- package/examples/component-snackbar-content.md +92 -0
- package/examples/component-snackbar.md +121 -0
- package/examples/component-sonner.md +165 -0
- package/examples/component-space.md +125 -0
- package/examples/component-spatial-locomotion.md +373 -0
- package/examples/component-spatial-panel.md +330 -0
- package/examples/component-speed-dial-action.md +78 -0
- package/examples/component-speed-dial.md +177 -0
- package/examples/component-spin.md +173 -0
- package/examples/component-spinner.md +204 -0
- package/examples/component-splitter.md +210 -0
- package/examples/component-stack.md +130 -0
- package/examples/component-statistic.md +282 -0
- package/examples/component-step-button.md +157 -0
- package/examples/component-step-connector.md +157 -0
- package/examples/component-step-content.md +121 -0
- package/examples/component-step-icon.md +115 -0
- package/examples/component-step-label.md +101 -0
- package/examples/component-step.md +84 -0
- package/examples/component-steps.md +264 -0
- package/examples/component-stock-chart.md +251 -0
- package/examples/component-swipeable-drawer.md +149 -0
- package/examples/component-switch.md +99 -0
- package/examples/component-tab-scroll-button.md +180 -0
- package/examples/component-tab.md +120 -0
- package/examples/component-table-body.md +82 -0
- package/examples/component-table-cell.md +118 -0
- package/examples/component-table-container.md +75 -0
- package/examples/component-table-footer.md +72 -0
- package/examples/component-table-head.md +78 -0
- package/examples/component-table-pagination.md +137 -0
- package/examples/component-table-row.md +113 -0
- package/examples/component-table-sort-label.md +109 -0
- package/examples/component-table.md +202 -0
- package/examples/component-tabs.md +184 -0
- package/examples/component-tag-badge.md +309 -0
- package/examples/component-tag.md +102 -0
- package/examples/component-testimonial-carousel.md +218 -0
- package/examples/component-textarea-autosize.md +114 -0
- package/examples/component-textarea.md +173 -0
- package/examples/component-time-picker.md +205 -0
- package/examples/component-timeline.md +170 -0
- package/examples/component-toast.md +224 -0
- package/examples/component-toggle-button.md +129 -0
- package/examples/component-toggle.md +220 -0
- package/examples/component-toolbar.md +104 -0
- package/examples/component-tooltip.md +178 -0
- package/examples/component-tour.md +176 -0
- package/examples/component-transaction-list-item.md +243 -0
- package/examples/component-transfer.md +156 -0
- package/examples/component-tree-select.md +202 -0
- package/examples/component-tree.md +297 -0
- package/examples/component-typography.md +215 -0
- package/examples/component-upload.md +295 -0
- package/examples/component-video-hero.md +409 -0
- package/examples/component-video-player.md +340 -0
- package/examples/component-voice-input.md +408 -0
- package/examples/component-watermark.md +217 -0
- package/examples/component-zoom.md +92 -0
- package/examples/doc-explanation-example.md +196 -0
- package/examples/doc-how-to-example.md +205 -0
- package/examples/doc-tutorial-example.md +162 -0
- package/examples/dogfood-korean-fintech-system.md +433 -0
- package/examples/email-transactional-example.md +259 -0
- package/examples/palette-saas-violet.md +235 -0
- package/examples/print-business-card-spec.md +205 -0
- package/examples/print-packaging-spec.md +285 -0
- package/examples/report-example.md +228 -0
- package/examples/slide-deck-example.md +237 -0
- package/examples/website-improvement-report.md +128 -0
- package/examples/website-improvement-workspace.json +126 -0
- package/install.sh +189 -0
- package/knowledge/COVERAGE.md +740 -0
- package/knowledge/PRINCIPLES.md +108 -0
- package/knowledge/a11y/contrast.md +70 -0
- package/knowledge/a11y/keyboard-and-focus.md +108 -0
- package/knowledge/colors/color-theory.md +90 -0
- package/knowledge/colors/mui-palette-structure.md +105 -0
- package/knowledge/colors/palettes-by-product-type.md +876 -0
- package/knowledge/components/INDEX.md +231 -0
- package/knowledge/components/index.json +1470 -0
- package/knowledge/components/shadcn-registry.md +159 -0
- package/knowledge/conversational/ai-chat-interfaces.md +323 -0
- package/knowledge/conversational/chatbot-design.md +312 -0
- package/knowledge/conversational/conversational-ui-fundamentals.md +299 -0
- package/knowledge/conversational/korean-voice-conventions.md +281 -0
- package/knowledge/conversational/voice-ui-patterns.md +297 -0
- package/knowledge/design-tokens/ant-design.md +124 -0
- package/knowledge/design-tokens/material-3.md +235 -0
- package/knowledge/design-tokens/polaris-and-carbon.md +231 -0
- package/knowledge/design-tokens/tailwind-v4.md +284 -0
- package/knowledge/game-ui/game-accessibility.md +317 -0
- package/knowledge/game-ui/game-ui-fundamentals.md +281 -0
- package/knowledge/game-ui/hud-design.md +324 -0
- package/knowledge/game-ui/korean-gaming-conventions.md +312 -0
- package/knowledge/game-ui/menu-systems.md +388 -0
- package/knowledge/i18n/korean-app-store-visual.md +223 -0
- package/knowledge/i18n/korean-document-style.md +301 -0
- package/knowledge/i18n/korean-payments.md +211 -0
- package/knowledge/i18n/korean-product-conventions.md +96 -0
- package/knowledge/i18n/korean-publishing.md +139 -0
- package/knowledge/i18n/korean-typography.md +123 -0
- package/knowledge/icons/curated-sets.md +225 -0
- package/knowledge/illustration/hero-illustrations.md +234 -0
- package/knowledge/illustration/illustration-systems.md +221 -0
- package/knowledge/illustration/mascot-design.md +208 -0
- package/knowledge/illustration/spot-illustrations.md +246 -0
- package/knowledge/illustration/svg-optimization.md +308 -0
- package/knowledge/layout/spacing-and-grid.md +119 -0
- package/knowledge/motion/app-loading-sequences.md +277 -0
- package/knowledge/motion/choreography-depth.md +297 -0
- package/knowledge/motion/marketing-motion.md +223 -0
- package/knowledge/motion/micro-interactions.md +266 -0
- package/knowledge/motion/motion-tools.md +281 -0
- package/knowledge/motion/principles.md +126 -0
- package/knowledge/patterns/auth-flow-design.md +316 -0
- package/knowledge/patterns/b2b-onboarding-flows.md +182 -0
- package/knowledge/patterns/brand-identity.md +238 -0
- package/knowledge/patterns/brand-references.md +97 -0
- package/knowledge/patterns/chart-color-encoding.md +269 -0
- package/knowledge/patterns/chart-types.md +344 -0
- package/knowledge/patterns/dashboard-composition.md +299 -0
- package/knowledge/patterns/design-system-qa.md +356 -0
- package/knowledge/patterns/document-typography.md +248 -0
- package/knowledge/patterns/email-design.md +338 -0
- package/knowledge/patterns/empty-states.md +263 -0
- package/knowledge/patterns/error-states.md +318 -0
- package/knowledge/patterns/form-design.md +237 -0
- package/knowledge/patterns/information-architecture.md +341 -0
- package/knowledge/patterns/landing-hero-design.md +283 -0
- package/knowledge/patterns/landing-page-patterns.md +681 -0
- package/knowledge/patterns/list-and-feed.md +371 -0
- package/knowledge/patterns/mobile-navigation.md +278 -0
- package/knowledge/patterns/money-and-amount.md +301 -0
- package/knowledge/patterns/onboarding.md +300 -0
- package/knowledge/patterns/pricing-page-design.md +261 -0
- package/knowledge/patterns/realtime-data.md +280 -0
- package/knowledge/patterns/report-design.md +330 -0
- package/knowledge/patterns/search-ux.md +373 -0
- package/knowledge/patterns/settings-page.md +325 -0
- package/knowledge/patterns/slide-deck-design.md +316 -0
- package/knowledge/patterns/styles-catalog.md +2599 -0
- package/knowledge/patterns/technical-writing.md +306 -0
- package/knowledge/patterns/ui-reasoning.md +1853 -0
- package/knowledge/patterns/ux-guidelines.md +1454 -0
- package/knowledge/platforms/react-native.md +395 -0
- package/knowledge/print/brochures-and-flyers.md +276 -0
- package/knowledge/print/korean-print-conventions.md +284 -0
- package/knowledge/print/packaging.md +321 -0
- package/knowledge/print/print-fundamentals.md +238 -0
- package/knowledge/print/signage-and-posters.md +235 -0
- package/knowledge/print/stationery.md +262 -0
- package/knowledge/spatial/ar-patterns.md +253 -0
- package/knowledge/spatial/comfort-and-accessibility.md +245 -0
- package/knowledge/spatial/spatial-design-fundamentals.md +346 -0
- package/knowledge/spatial/spatial-ui-elements.md +343 -0
- package/knowledge/spatial/vr-patterns.md +302 -0
- package/knowledge/typography/font-pairings.md +332 -0
- package/knowledge/typography/mui-type-scale.md +57 -0
- package/knowledge/typography/type-scale-fundamentals.md +105 -0
- package/knowledge/video/in-product-video.md +277 -0
- package/knowledge/video/korean-video-conventions.md +247 -0
- package/knowledge/video/marketing-video.md +258 -0
- package/knowledge/video/social-and-short-form.md +257 -0
- package/knowledge/video/video-fundamentals.md +296 -0
- package/package.json +106 -0
- package/skills/README.md +39 -0
- package/skills/color-palette/PLAYBOOK.md +175 -0
- package/skills/color-palette/SKILL.md +6 -0
- package/skills/color-palette/TEMPLATE.md +103 -0
- package/skills/component-spec-writer/PLAYBOOK.md +169 -0
- package/skills/component-spec-writer/SKILL.md +6 -0
- package/skills/component-spec-writer/TEMPLATE.md +115 -0
- package/skills/conversational-ui-designer/PLAYBOOK.md +231 -0
- package/skills/conversational-ui-designer/SKILL.md +6 -0
- package/skills/design-broadcast/PLAYBOOK.md +146 -0
- package/skills/design-broadcast/SKILL.md +6 -0
- package/skills/design-critique/PLAYBOOK.md +137 -0
- package/skills/design-critique/SKILL.md +6 -0
- package/skills/design-pr-review/PLAYBOOK.md +171 -0
- package/skills/design-pr-review/SKILL.md +6 -0
- package/skills/design-system-builder/PLAYBOOK.md +218 -0
- package/skills/design-system-builder/SKILL.md +6 -0
- package/skills/design-system-qa/PLAYBOOK.md +163 -0
- package/skills/design-system-qa/SKILL.md +6 -0
- package/skills/document-author/PLAYBOOK.md +167 -0
- package/skills/document-author/SKILL.md +6 -0
- package/skills/figma-token-sync/PLAYBOOK.md +149 -0
- package/skills/figma-token-sync/SKILL.md +6 -0
- package/skills/game-ui-designer/PLAYBOOK.md +209 -0
- package/skills/game-ui-designer/SKILL.md +6 -0
- package/skills/handoff-spec/PLAYBOOK.md +170 -0
- package/skills/handoff-spec/SKILL.md +6 -0
- package/skills/illustration-designer/PLAYBOOK.md +166 -0
- package/skills/illustration-designer/SKILL.md +6 -0
- package/skills/motion-designer/PLAYBOOK.md +223 -0
- package/skills/motion-designer/SKILL.md +6 -0
- package/skills/print-designer/PLAYBOOK.md +209 -0
- package/skills/print-designer/SKILL.md +6 -0
- package/skills/slide-deck-author/PLAYBOOK.md +198 -0
- package/skills/slide-deck-author/SKILL.md +6 -0
- package/skills/spatial-designer/PLAYBOOK.md +238 -0
- package/skills/spatial-designer/SKILL.md +6 -0
- package/skills/ux-audit/PLAYBOOK.md +142 -0
- package/skills/ux-audit/SKILL.md +6 -0
- package/skills/video-designer/PLAYBOOK.md +240 -0
- package/skills/video-designer/SKILL.md +6 -0
- package/skills/website-improvement/PLAYBOOK.md +118 -0
- package/skills/website-improvement/SKILL.md +6 -0
- package/skills/website-improvement/TEMPLATE.md +103 -0
- package/tools/audit/changelog-generate.py +176 -0
- package/tools/audit/check-coverage.py +483 -0
- package/tools/audit/doctor_assertions.py +256 -0
- package/tools/audit/example-qa.py +108 -0
- package/tools/audit/frontmatter-check.py +199 -0
- package/tools/audit/integration-check.py +95 -0
- package/tools/audit/korean-copy-check.py +161 -0
- package/tools/audit/link-check.py +146 -0
- package/tools/audit/local-ci.py +558 -0
- package/tools/audit/package-contents.py +723 -0
- package/tools/audit/package-smoke.py +22443 -0
- package/tools/audit/raw-hex-check.py +252 -0
- package/tools/audit/registry-smoke.py +8188 -0
- package/tools/audit/release-metadata.py +9832 -0
- package/tools/audit/run-all.py +351 -0
- package/tools/audit/smoke_assertions.py +12742 -0
- package/tools/audit/stability-review.py +332 -0
- package/tools/audit/stale-check.py +156 -0
- package/tools/migrations/add-version-frontmatter.py +132 -0
- package/tools/migrations/bump-last-updated.py +131 -0
- package/tools/migrations/promote-stability.py +172 -0
- package/tools/preview/README.md +58 -0
- package/tools/preview/render-tokens.py +454 -0
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
# illustration-designer — playbook
|
|
2
|
+
|
|
3
|
+
Design and spec an illustration system, OR a single illustration within an existing system. Output is a markdown spec a designer / illustrator can produce against, OR direct SVG output for simple cases.
|
|
4
|
+
|
|
5
|
+
## When to use
|
|
6
|
+
|
|
7
|
+
- "We need an illustration system for our SaaS landing page."
|
|
8
|
+
- "Spec the empty state illustrations for our product."
|
|
9
|
+
- "Design a mascot for our Korean fintech app."
|
|
10
|
+
- "Should we use Lottie or SVG for the hero?"
|
|
11
|
+
- "Optimize this SVG."
|
|
12
|
+
|
|
13
|
+
## Inputs (ask if missing)
|
|
14
|
+
|
|
15
|
+
1. **Scope** — full system, OR single illustration.
|
|
16
|
+
2. **Surface** — empty state / hero / onboarding / spot / mascot.
|
|
17
|
+
3. **Brand voice** — 3-5 adjectives (e.g., calm, gentle, money-warm; or sharp, futuristic, controlled).
|
|
18
|
+
4. **Existing system?** — if yes, follow its style. If no, this skill defines one.
|
|
19
|
+
5. **Color tokens** — which brand tokens are available.
|
|
20
|
+
6. **Format constraint** — SVG / Lottie / PNG / WebP / mixed.
|
|
21
|
+
7. **Korean market?** — affects mascot vs minimal-geometric default.
|
|
22
|
+
8. **Production budget** — solo designer, agency, AI-assisted, none yet.
|
|
23
|
+
|
|
24
|
+
## Steps
|
|
25
|
+
|
|
26
|
+
### 1. Classify the work
|
|
27
|
+
|
|
28
|
+
| Task | Approach |
|
|
29
|
+
| --- | --- |
|
|
30
|
+
| Define a new system | Start with [`illustration-systems.md`](../../knowledge/illustration/illustration-systems.md), then apply the surface-specific illustration references |
|
|
31
|
+
| Add to existing system | Follow style guide; don't redefine |
|
|
32
|
+
| Single spot illustration | [`spot-illustrations.md`](../../knowledge/illustration/spot-illustrations.md) |
|
|
33
|
+
| Hero illustration | [`hero-illustrations.md`](../../knowledge/illustration/hero-illustrations.md) |
|
|
34
|
+
| Mascot work | [`mascot-design.md`](../../knowledge/illustration/mascot-design.md) |
|
|
35
|
+
| SVG technical / optimization | [`svg-optimization.md`](../../knowledge/illustration/svg-optimization.md) |
|
|
36
|
+
|
|
37
|
+
### 2. If defining a system — set the style
|
|
38
|
+
|
|
39
|
+
From [`illustration-systems.md`](../../knowledge/illustration/illustration-systems.md):
|
|
40
|
+
|
|
41
|
+
- **Geometric vs organic** — pick one.
|
|
42
|
+
- **Line weight rule** — stroke-only / fill-only / mixed; one stroke width.
|
|
43
|
+
- **Color treatment** — monochromatic / brand-palette / limited-extended.
|
|
44
|
+
- **Geometry rules** — grid, corner radius, stroke caps.
|
|
45
|
+
- **Perspective** — flat / isometric / front-view.
|
|
46
|
+
- **Voice** — 3-5 adjectives.
|
|
47
|
+
|
|
48
|
+
State each choice with reasoning.
|
|
49
|
+
|
|
50
|
+
### 3. Pick the format
|
|
51
|
+
|
|
52
|
+
| Format | Use |
|
|
53
|
+
| --- | --- |
|
|
54
|
+
| SVG | Default; vector, themeable |
|
|
55
|
+
| Lottie | Animated illustration |
|
|
56
|
+
| PNG / WebP | Heavy shading, painterly, photo-realistic |
|
|
57
|
+
| AVIF | Highest compression for raster |
|
|
58
|
+
|
|
59
|
+
For most: SVG. Lottie when motion is the point. Raster only when SVG can't represent the visual.
|
|
60
|
+
|
|
61
|
+
### 4. Per-illustration spec
|
|
62
|
+
|
|
63
|
+
For each illustration:
|
|
64
|
+
|
|
65
|
+
```
|
|
66
|
+
Name: <kebab-case, prefixed by category>
|
|
67
|
+
e.g., illo-empty-search.svg, illo-hero-onboarding-01.svg
|
|
68
|
+
Surface: <empty-state | error-state | onboarding-step-2 | hero-section-3>
|
|
69
|
+
Subject: <one sentence — what's depicted>
|
|
70
|
+
Voice: <encouraging | calm | celebratory | apologetic>
|
|
71
|
+
Size: <display dimensions>
|
|
72
|
+
Format: <SVG | Lottie | PNG>
|
|
73
|
+
Tokens used: <list of CSS variables / brand colors>
|
|
74
|
+
Animation? <static | subtle loop | one-shot>
|
|
75
|
+
Accessibility: <decorative | meaningful + alt text>
|
|
76
|
+
Production hours: <estimate>
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
### 5. Apply Korean conventions (if applicable)
|
|
80
|
+
|
|
81
|
+
- Heavy mascot use? See [`mascot-design.md`](../../knowledge/illustration/mascot-design.md).
|
|
82
|
+
- Soft, rounded, warm geometry preferred for B2C.
|
|
83
|
+
- Hero illustrations: less abstract, more concrete (real character / real action).
|
|
84
|
+
- See [`knowledge/i18n/korean-app-store-visual.md`](../../knowledge/i18n/korean-app-store-visual.md).
|
|
85
|
+
|
|
86
|
+
### 6. Optimize the SVG
|
|
87
|
+
|
|
88
|
+
For each shipped SVG:
|
|
89
|
+
|
|
90
|
+
- [ ] Run SVGO with config from [`svg-optimization.md`](../../knowledge/illustration/svg-optimization.md)
|
|
91
|
+
- [ ] Replace brand color hex with `currentColor` or CSS variable
|
|
92
|
+
- [ ] Verify viewBox preserved
|
|
93
|
+
- [ ] Verify no embedded raster
|
|
94
|
+
- [ ] Verify no editor metadata
|
|
95
|
+
- [ ] Verify size targets: < 1kB icon, < 10kB spot, < 50kB hero
|
|
96
|
+
- [ ] Test at 1×, 2×, 3×
|
|
97
|
+
- [ ] Test in light + dark modes
|
|
98
|
+
|
|
99
|
+
### 7. Accessibility
|
|
100
|
+
|
|
101
|
+
- Decorative: `aria-hidden="true"` on illustration.
|
|
102
|
+
- Meaningful: `role="img"` + `aria-label`.
|
|
103
|
+
- Animated: respect `prefers-reduced-motion`.
|
|
104
|
+
|
|
105
|
+
### 8. Output
|
|
106
|
+
|
|
107
|
+
Use this structure:
|
|
108
|
+
|
|
109
|
+
```markdown
|
|
110
|
+
# Illustration spec: <system or piece name>
|
|
111
|
+
|
|
112
|
+
> Scope: <system | single piece>
|
|
113
|
+
> Style: <flat geometric | soft 3D | hand-drawn | mascot-driven | editorial | generative>
|
|
114
|
+
> Voice: <3-5 adjectives>
|
|
115
|
+
> Format: <SVG | Lottie | mixed>
|
|
116
|
+
|
|
117
|
+
## Style rules
|
|
118
|
+
<line weight, color treatment, geometry, perspective>
|
|
119
|
+
|
|
120
|
+
## Color tokens
|
|
121
|
+
<list of brand tokens permitted>
|
|
122
|
+
|
|
123
|
+
## Asset list
|
|
124
|
+
| Name | Surface | Size | Format | Tokens | Anim? |
|
|
125
|
+
|
|
126
|
+
## Production checklist
|
|
127
|
+
<checklist per illustration>
|
|
128
|
+
|
|
129
|
+
## Don't
|
|
130
|
+
<2-3 specific misuses>
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
## Source files this skill reads
|
|
134
|
+
|
|
135
|
+
- [`knowledge/illustration/illustration-systems.md`](../../knowledge/illustration/illustration-systems.md) — system foundation
|
|
136
|
+
- [`knowledge/illustration/spot-illustrations.md`](../../knowledge/illustration/spot-illustrations.md) — small purposeful
|
|
137
|
+
- [`knowledge/illustration/hero-illustrations.md`](../../knowledge/illustration/hero-illustrations.md) — large brand-led
|
|
138
|
+
- [`knowledge/illustration/mascot-design.md`](../../knowledge/illustration/mascot-design.md) — character work
|
|
139
|
+
- [`knowledge/illustration/svg-optimization.md`](../../knowledge/illustration/svg-optimization.md) — SVG production
|
|
140
|
+
- [`knowledge/patterns/brand-identity.md`](../../knowledge/patterns/brand-identity.md) — brand foundation
|
|
141
|
+
- [`knowledge/motion/motion-tools.md`](../../knowledge/motion/motion-tools.md) — Lottie when animated
|
|
142
|
+
- [`knowledge/i18n/korean-app-store-visual.md`](../../knowledge/i18n/korean-app-store-visual.md) — Korean market visual
|
|
143
|
+
- [`examples/component-empty-state.md`](../../examples/component-empty-state.md) — empty state spec
|
|
144
|
+
- [`examples/component-illustration.md`](../../examples/component-illustration.md) — generic display
|
|
145
|
+
|
|
146
|
+
## Verification phase (run before declaring done)
|
|
147
|
+
|
|
148
|
+
- [ ] If defining a system: are style + voice + color rules all explicit?
|
|
149
|
+
- [ ] Is the format chosen consciously (SVG default; Lottie / PNG only with reason)?
|
|
150
|
+
- [ ] Are color tokens listed (no raw hex in the spec body)?
|
|
151
|
+
- [ ] Are illustrations sized per category (1kB icon / 10kB spot / 50kB hero)?
|
|
152
|
+
- [ ] Is accessibility specified (decorative vs meaningful + alt text)?
|
|
153
|
+
- [ ] If animated: is reduced-motion fallback specified?
|
|
154
|
+
- [ ] If Korean B2C: are mascot conventions or Toss-style restraint applied?
|
|
155
|
+
- [ ] If shipping SVG: is SVGO + currentColor + viewBox checklist passed?
|
|
156
|
+
- [ ] Does the "Don't" section catch 2-3 specific misuses?
|
|
157
|
+
|
|
158
|
+
## Done when
|
|
159
|
+
|
|
160
|
+
- One markdown spec.
|
|
161
|
+
- Style + voice + format choices explicit and reasoned.
|
|
162
|
+
- Color tokens listed.
|
|
163
|
+
- Asset list with sizes, formats, accessibility.
|
|
164
|
+
- Production checklist.
|
|
165
|
+
- "Don't" section.
|
|
166
|
+
- Verification passes.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: illustration-designer
|
|
3
|
+
description: Design and spec an illustration system or a single illustration — pick style, voice, color treatment, format (SVG / Lottie / PNG), and delivery. Covers spot illustrations, hero illustrations, mascots, and SVG production.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
See [PLAYBOOK.md](PLAYBOOK.md).
|
|
@@ -0,0 +1,223 @@
|
|
|
1
|
+
# motion-designer — playbook
|
|
2
|
+
|
|
3
|
+
Design and spec motion for a screen, component, or page. Output is a **motion spec**: a markdown document a developer can implement against without follow-ups, with the right tool chosen, durations and easings derived from tokens, and reduced-motion handled.
|
|
4
|
+
|
|
5
|
+
## When to use
|
|
6
|
+
|
|
7
|
+
- "Design the entrance for our landing page hero."
|
|
8
|
+
- "Spec the loading sequence for our app cold launch."
|
|
9
|
+
- "We want the success state to feel celebratory — design it."
|
|
10
|
+
- "Add motion to the modal open/close."
|
|
11
|
+
- "Pick a tool: should we use Framer Motion or GSAP?"
|
|
12
|
+
|
|
13
|
+
## Inputs (ask if missing)
|
|
14
|
+
|
|
15
|
+
1. **Surface** — landing page / app screen / component / route transition.
|
|
16
|
+
2. **Intent** — what motion should accomplish (stop scroll, confirm action, smooth navigation, brand moment).
|
|
17
|
+
3. **Trigger** — page load / scroll / tap / state change / hover.
|
|
18
|
+
4. **Audience + platform** — web / mobile web / native / hybrid; Korean / global.
|
|
19
|
+
5. **Performance budget** — bundle target, target devices.
|
|
20
|
+
6. **Existing motion language** — does the brand have one (rubber-band? snappy? gentle?). If not, this skill helps define it.
|
|
21
|
+
|
|
22
|
+
## Steps
|
|
23
|
+
|
|
24
|
+
### 1. Classify the moment
|
|
25
|
+
|
|
26
|
+
Pick the category. The category determines the rules:
|
|
27
|
+
|
|
28
|
+
| Category | Goal | Reference |
|
|
29
|
+
| --- | --- | --- |
|
|
30
|
+
| Micro-interaction | Confirm input within 100ms | [`knowledge/motion/micro-interactions.md`](../../knowledge/motion/micro-interactions.md) |
|
|
31
|
+
| Marketing motion | Stop scroll / reveal value / anchor brand | [`knowledge/motion/marketing-motion.md`](../../knowledge/motion/marketing-motion.md) |
|
|
32
|
+
| App loading | Hide load latency; feel intentional | [`knowledge/motion/app-loading-sequences.md`](../../knowledge/motion/app-loading-sequences.md) |
|
|
33
|
+
| Choreography | Coordinate multi-element reveal | [`knowledge/motion/choreography-depth.md`](../../knowledge/motion/choreography-depth.md) |
|
|
34
|
+
| State transition | Show change in product UI | [`knowledge/motion/principles.md`](../../knowledge/motion/principles.md) |
|
|
35
|
+
|
|
36
|
+
Get this wrong and the rules don't apply. A marketing reveal is NOT a micro-interaction; a button press is NOT a choreographed sequence.
|
|
37
|
+
|
|
38
|
+
### 2. Pick duration tier
|
|
39
|
+
|
|
40
|
+
From [`knowledge/motion/principles.md`](../../knowledge/motion/principles.md):
|
|
41
|
+
|
|
42
|
+
| Tier | Range | Use |
|
|
43
|
+
| --- | --- | --- |
|
|
44
|
+
| Instant | 0–80ms | Press feedback, focus rings |
|
|
45
|
+
| Fast | 100–200ms | Hover, micro-interactions, route fades |
|
|
46
|
+
| Medium | 200–300ms | Modal / drawer / panel open |
|
|
47
|
+
| Slow | 300–500ms | Hero entrance, page transition |
|
|
48
|
+
| Long | 500ms–1.5s | Marketing storytelling, choreographed reveals |
|
|
49
|
+
| Beyond | > 1.5s | Almost never. Justify or cut. |
|
|
50
|
+
|
|
51
|
+
State the chosen tier explicitly. Map to token: `--motion-fast`, `--motion-medium`, etc.
|
|
52
|
+
|
|
53
|
+
### 3. Pick easing
|
|
54
|
+
|
|
55
|
+
| Easing | Curve | Use |
|
|
56
|
+
| --- | --- | --- |
|
|
57
|
+
| `ease-out` | Decelerate to stop | Default for entrances ("arrive and settle") |
|
|
58
|
+
| `ease-in` | Accelerate from rest | Exits ("leave the screen") |
|
|
59
|
+
| `ease-in-out` | Both | Position-to-position movement |
|
|
60
|
+
| `cubic-bezier(0.34, 1.56, 0.64, 1)` | Slight overshoot | Confirm / playful (rubber-band) |
|
|
61
|
+
| `linear` | Constant | Loading bars, infinite spinners |
|
|
62
|
+
|
|
63
|
+
Map to token: `--ease-out`, `--ease-in`, etc. Don't ship raw cubic-beziers in components — promote them to tokens first.
|
|
64
|
+
|
|
65
|
+
### 4. Pick tool
|
|
66
|
+
|
|
67
|
+
Use [`knowledge/motion/motion-tools.md`](../../knowledge/motion/motion-tools.md) decision tree.
|
|
68
|
+
|
|
69
|
+
Bias rules:
|
|
70
|
+
- **CSS first**. Hover / press / focus / simple entrances. ~80% of motion needs this and only this.
|
|
71
|
+
- **Framer Motion** for React-side state-driven animation (modals, route transitions, layout animations).
|
|
72
|
+
- **GSAP** for marketing timelines / scroll-triggered choreography longer than 600ms.
|
|
73
|
+
- **Lottie** when designer brings After Effects animation.
|
|
74
|
+
- **Rive** when motion needs state machines and interactivity.
|
|
75
|
+
- **react-spring** only when you need physics (drag, swipe).
|
|
76
|
+
|
|
77
|
+
Don't load 4 motion libraries. Pick 1–2 max. Justify each.
|
|
78
|
+
|
|
79
|
+
### 5. Spec the motion
|
|
80
|
+
|
|
81
|
+
For each motion event, write:
|
|
82
|
+
|
|
83
|
+
```
|
|
84
|
+
Trigger: <what causes this>
|
|
85
|
+
Duration: <ms>, tier <tier>, token <var>
|
|
86
|
+
Easing: <name>, token <var>
|
|
87
|
+
Properties: <opacity | transform | filter — animate ONLY these>
|
|
88
|
+
Initial: <starting value>
|
|
89
|
+
Final: <end value>
|
|
90
|
+
Stagger (if multiple): <ms between siblings>
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Animate only `opacity`, `transform`, and (sparingly) `filter`. Never `width`/`height`/`top`/`left` — they trigger layout.
|
|
94
|
+
|
|
95
|
+
### 6. Choreograph (if multi-element)
|
|
96
|
+
|
|
97
|
+
For sequences with > 1 element, use stagger formula from [`knowledge/motion/choreography-depth.md`](../../knowledge/motion/choreography-depth.md):
|
|
98
|
+
|
|
99
|
+
```
|
|
100
|
+
total budget = parent duration + (children − 1) × stagger
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
Cap stagger at 80ms; cap total at 800ms for entrance, 300ms for in-app transitions.
|
|
104
|
+
|
|
105
|
+
Provide a timing diagram:
|
|
106
|
+
|
|
107
|
+
```
|
|
108
|
+
0ms ┃■■■■■ ┃ headline (200ms fade)
|
|
109
|
+
50ms┃ ■■■■■ ┃ sub (200ms fade)
|
|
110
|
+
100ms┃ ■■■■■■ ┃ CTA (250ms fade-up)
|
|
111
|
+
200ms┃ ■■■■■■■■ ┃ visual (300ms scale-in)
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
### 7. Reduced motion
|
|
115
|
+
|
|
116
|
+
Always specify behavior when `prefers-reduced-motion: reduce`:
|
|
117
|
+
|
|
118
|
+
| Original | Reduced fallback |
|
|
119
|
+
| --- | --- |
|
|
120
|
+
| Fade + translate | Pure fade |
|
|
121
|
+
| Slide-in | Pure fade or instant |
|
|
122
|
+
| Scale-in | Pure fade |
|
|
123
|
+
| Parallax | Disable |
|
|
124
|
+
| Auto-loop | Pause; show static frame |
|
|
125
|
+
| Hero / shared element | Instant layout swap |
|
|
126
|
+
|
|
127
|
+
Reduced motion ≠ no motion. Opacity-only is usually OK; large translations / scales are not.
|
|
128
|
+
|
|
129
|
+
### 8. Performance check
|
|
130
|
+
|
|
131
|
+
For every motion spec, verify:
|
|
132
|
+
|
|
133
|
+
- [ ] Animates only `opacity` / `transform` / (sparingly) `filter`
|
|
134
|
+
- [ ] Total page-level animation count under 10 simultaneously
|
|
135
|
+
- [ ] If above-the-fold: doesn't block LCP
|
|
136
|
+
- [ ] If using JS lib: bundle cost stated and justified
|
|
137
|
+
- [ ] If looping: pauses when offscreen / tab hidden
|
|
138
|
+
- [ ] If `filter: blur()`: only on small areas, not large lists
|
|
139
|
+
- [ ] No `setInterval` driving animation (use `requestAnimationFrame` or CSS / library)
|
|
140
|
+
|
|
141
|
+
### 9. Korean market check (if relevant)
|
|
142
|
+
|
|
143
|
+
| Question | Default for Korean B2C |
|
|
144
|
+
| --- | --- |
|
|
145
|
+
| How much motion? | Restrained, fast, smooth (Toss-style) |
|
|
146
|
+
| Brand mascot motion? | Yes if Kakao-adjacent, no otherwise |
|
|
147
|
+
| Auto-play video? | No — bandwidth + battery |
|
|
148
|
+
| Korean-language label? | All motion control labels in Korean |
|
|
149
|
+
|
|
150
|
+
Heavy motion reads as foreign / over-designed in Korean B2C. Lean restrained.
|
|
151
|
+
|
|
152
|
+
### 10. Output
|
|
153
|
+
|
|
154
|
+
Use this structure:
|
|
155
|
+
|
|
156
|
+
```markdown
|
|
157
|
+
# Motion spec: <surface name>
|
|
158
|
+
|
|
159
|
+
> Surface: <landing page hero | settings drawer | etc>
|
|
160
|
+
> Intent: <one sentence>
|
|
161
|
+
> Trigger: <what fires it>
|
|
162
|
+
> Tool: <CSS | Framer Motion | GSAP | Lottie | Rive | react-spring>
|
|
163
|
+
|
|
164
|
+
## Tokens used
|
|
165
|
+
<list>
|
|
166
|
+
|
|
167
|
+
## Sequence
|
|
168
|
+
<step-by-step with durations, easings, properties>
|
|
169
|
+
|
|
170
|
+
## Timing diagram
|
|
171
|
+
<gantt-style ASCII>
|
|
172
|
+
|
|
173
|
+
## Reduced motion
|
|
174
|
+
<fallback per element>
|
|
175
|
+
|
|
176
|
+
## Performance budget
|
|
177
|
+
<bundle delta, animation count, LCP impact>
|
|
178
|
+
|
|
179
|
+
## Code stub
|
|
180
|
+
<minimal CSS / React snippet>
|
|
181
|
+
|
|
182
|
+
## Don't
|
|
183
|
+
<2-3 specific misuses>
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
## Source files this skill reads
|
|
187
|
+
|
|
188
|
+
- [`knowledge/motion/principles.md`](../../knowledge/motion/principles.md) — durations / easings / fundamentals
|
|
189
|
+
- [`knowledge/motion/micro-interactions.md`](../../knowledge/motion/micro-interactions.md) — < 200ms moments
|
|
190
|
+
- [`knowledge/motion/marketing-motion.md`](../../knowledge/motion/marketing-motion.md) — landing / hero / scroll
|
|
191
|
+
- [`knowledge/motion/app-loading-sequences.md`](../../knowledge/motion/app-loading-sequences.md) — splash / route / progressive
|
|
192
|
+
- [`knowledge/motion/choreography-depth.md`](../../knowledge/motion/choreography-depth.md) — multi-element coordination
|
|
193
|
+
- [`knowledge/motion/motion-tools.md`](../../knowledge/motion/motion-tools.md) — tool decision tree
|
|
194
|
+
- [`examples/component-loading-sequence.md`](../../examples/component-loading-sequence.md) — reference spec
|
|
195
|
+
- [`examples/component-page-transition.md`](../../examples/component-page-transition.md) — reference spec
|
|
196
|
+
- [`examples/component-lottie-player.md`](../../examples/component-lottie-player.md) — Lottie integration
|
|
197
|
+
- [`examples/component-scroll-reveal.md`](../../examples/component-scroll-reveal.md) — scroll-triggered
|
|
198
|
+
|
|
199
|
+
## Verification phase (run before declaring done)
|
|
200
|
+
|
|
201
|
+
- [ ] Was the moment classified into one of the 5 categories?
|
|
202
|
+
- [ ] Is the duration tier explicit (not just "200ms" — "fast tier")?
|
|
203
|
+
- [ ] Is the easing named AND mapped to a token?
|
|
204
|
+
- [ ] Is the tool choice justified ("CSS because it's a < 100ms hover" — not just "Framer Motion")?
|
|
205
|
+
- [ ] Are only `opacity` / `transform` / `filter` animated?
|
|
206
|
+
- [ ] If multi-element: is stagger ≤ 80ms and total ≤ 800ms (entrance) / 300ms (in-app)?
|
|
207
|
+
- [ ] Is `prefers-reduced-motion` behavior specified for every element?
|
|
208
|
+
- [ ] Is bundle cost stated if a library is used?
|
|
209
|
+
- [ ] Does the "Don't" section catch 2–3 specific misuses?
|
|
210
|
+
- [ ] If Korean B2C: is the restraint check applied?
|
|
211
|
+
|
|
212
|
+
## Done when
|
|
213
|
+
|
|
214
|
+
- One markdown spec, < 400 lines.
|
|
215
|
+
- Surface, intent, trigger, tool stated up top.
|
|
216
|
+
- Tokens listed (no raw values in body — reference tokens).
|
|
217
|
+
- Sequence with durations + easings + properties.
|
|
218
|
+
- Timing diagram (if multi-element).
|
|
219
|
+
- Reduced-motion fallback for every element.
|
|
220
|
+
- Performance budget stated.
|
|
221
|
+
- Code stub developer can paste in.
|
|
222
|
+
- "Don't" section.
|
|
223
|
+
- Verification phase passes.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: motion-designer
|
|
3
|
+
description: Design and spec motion for a screen, component, or page — pick the right duration, easing, and tool (CSS / Framer Motion / GSAP / Lottie / Rive); deliver a motion spec a developer can implement against. Reduced-motion-safe by default.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
See [PLAYBOOK.md](PLAYBOOK.md).
|
|
@@ -0,0 +1,209 @@
|
|
|
1
|
+
# print-designer — playbook
|
|
2
|
+
|
|
3
|
+
Design and spec a print piece. Output is a print-ready spec a designer can deliver to a printer with confidence — sizes, paper, finish, color, bleed, regulatory content, file delivery format.
|
|
4
|
+
|
|
5
|
+
## When to use
|
|
6
|
+
|
|
7
|
+
- "Spec a business card for our Korean fintech."
|
|
8
|
+
- "Design a tri-fold brochure for the new product."
|
|
9
|
+
- "Build a folding carton for our cosmetics line."
|
|
10
|
+
- "Create a subway poster spec."
|
|
11
|
+
- "What paper / finish should we choose?"
|
|
12
|
+
|
|
13
|
+
## Inputs (ask if missing)
|
|
14
|
+
|
|
15
|
+
1. **Piece type** — business card / letterhead / envelope / flyer / brochure / poster / packaging / signage.
|
|
16
|
+
2. **Audience** — Korean primary / international primary / mixed.
|
|
17
|
+
3. **Tier** — basic / mid / premium / luxury.
|
|
18
|
+
4. **Quantity** — affects MOQ + cost.
|
|
19
|
+
5. **Budget**.
|
|
20
|
+
6. **Special requirements** — regulatory (food / cosmetics), sustainability, brand-critical color (Pantone match).
|
|
21
|
+
7. **Existing brand assets** — logo, colors, fonts.
|
|
22
|
+
8. **Distribution / use** — retail / mailing / hand-out / OOH.
|
|
23
|
+
|
|
24
|
+
## Steps
|
|
25
|
+
|
|
26
|
+
### 1. Pick the right piece
|
|
27
|
+
|
|
28
|
+
Use the type to select primary knowledge:
|
|
29
|
+
|
|
30
|
+
| Piece | Read |
|
|
31
|
+
| --- | --- |
|
|
32
|
+
| Business card / letterhead / envelope | [`stationery.md`](../../knowledge/print/stationery.md) |
|
|
33
|
+
| Flyer / leaflet / brochure / booklet | [`brochures-and-flyers.md`](../../knowledge/print/brochures-and-flyers.md) |
|
|
34
|
+
| Poster / banner / signage / OOH | [`signage-and-posters.md`](../../knowledge/print/signage-and-posters.md) |
|
|
35
|
+
| Box / carton / label / mailer | [`packaging.md`](../../knowledge/print/packaging.md) |
|
|
36
|
+
|
|
37
|
+
Always also read [`print-fundamentals.md`](../../knowledge/print/print-fundamentals.md). For Korean: [`korean-print-conventions.md`](../../knowledge/print/korean-print-conventions.md).
|
|
38
|
+
|
|
39
|
+
### 2. Spec dimensions
|
|
40
|
+
|
|
41
|
+
| Piece | Korean default | International default |
|
|
42
|
+
| --- | --- | --- |
|
|
43
|
+
| Business card | 90×50mm | 85×55mm |
|
|
44
|
+
| Flyer / leaflet | A5 (148×210) | Letter (216×279) |
|
|
45
|
+
| Brochure | A4 / A4 tri-fold | Letter |
|
|
46
|
+
| Poster | A2 / A1 / A0 | Tabloid / Arch |
|
|
47
|
+
| Box | per dieline | per dieline |
|
|
48
|
+
|
|
49
|
+
Always include bleed: **3mm minimum**. State trim AND bleed dimensions.
|
|
50
|
+
|
|
51
|
+
### 3. Pick paper / material
|
|
52
|
+
|
|
53
|
+
For each paper choice, consider:
|
|
54
|
+
- **Weight (gsm)** — sets perceived premium.
|
|
55
|
+
- **Finish** — matte / glossy / uncoated / soft-touch / linen.
|
|
56
|
+
- **Coating** — uncoated / aqueous / UV / lamination.
|
|
57
|
+
- **Color** — white / off-white / kraft / colored stock.
|
|
58
|
+
- **Sustainability** — FSC / recycled content.
|
|
59
|
+
|
|
60
|
+
Defaults:
|
|
61
|
+
- Business card: 300-350gsm matte coated or uncoated.
|
|
62
|
+
- Brochure: 150-200gsm coated.
|
|
63
|
+
- Folding carton: 350gsm SBS.
|
|
64
|
+
- Mailer: 120-200gsm corrugated E-flute.
|
|
65
|
+
- Poster: 150-200gsm coated for indoor; vinyl for outdoor.
|
|
66
|
+
|
|
67
|
+
### 4. Pick color system
|
|
68
|
+
|
|
69
|
+
| Need | Use |
|
|
70
|
+
| --- | --- |
|
|
71
|
+
| Standard 4-color | CMYK |
|
|
72
|
+
| Brand-critical accent | CMYK + 1-2 Pantone spots |
|
|
73
|
+
| Single-color (1-color) | 1 Pantone or 100K |
|
|
74
|
+
| Premium metallic | Foil stamp (gold/silver/copper/holo) |
|
|
75
|
+
| Neon / day-glo | Pantone special inks |
|
|
76
|
+
|
|
77
|
+
State Pantone numbers + CMYK fallback. Don't trust silent conversion.
|
|
78
|
+
|
|
79
|
+
### 5. Pick finish + special effects
|
|
80
|
+
|
|
81
|
+
Common combinations:
|
|
82
|
+
- **Matte + spot UV on logo** — premium tactile contrast.
|
|
83
|
+
- **Soft-touch lamination + emboss / deboss** — luxury feel.
|
|
84
|
+
- **Glossy + foil stamp** — vibrant + metallic.
|
|
85
|
+
- **Uncoated + letterpress** — artisanal / wedding.
|
|
86
|
+
|
|
87
|
+
Each special effect adds 20-100% cost. Cap at 1-2 per piece for restraint.
|
|
88
|
+
|
|
89
|
+
### 6. Typography
|
|
90
|
+
|
|
91
|
+
Pick fonts that:
|
|
92
|
+
- Print clearly (test small sizes).
|
|
93
|
+
- Have weights that suit each role (display, body, caption).
|
|
94
|
+
- Support all required scripts (KR + EN if bilingual).
|
|
95
|
+
- Are licensed for print use (verify, not just web).
|
|
96
|
+
|
|
97
|
+
Korean default: **Pretendard** for sans (free, modern, multi-lingual). 본명조 for serif. Adobe paid families if budget permits.
|
|
98
|
+
|
|
99
|
+
Sizing:
|
|
100
|
+
- Body 9-11pt; smaller for Korean than Latin.
|
|
101
|
+
- Headlines 18-72pt depending on piece.
|
|
102
|
+
- Captions 6.5-8pt.
|
|
103
|
+
|
|
104
|
+
### 7. Regulatory content (if applicable)
|
|
105
|
+
|
|
106
|
+
- **Food**: KFDA — ingredients, allergens, nutrition, manufacturer, country of origin.
|
|
107
|
+
- **Cosmetics**: KFDA — ingredients (Korean INCI), manufacturer, manufacturing license, expiry.
|
|
108
|
+
- **Health-functional foods**: KFDA — strict format, approved claims only.
|
|
109
|
+
- **Drugs**: KFDA — pre-approved copy, regulated formats.
|
|
110
|
+
- **Recycling marks (분리배출 표시)**: required on most consumer packaging.
|
|
111
|
+
|
|
112
|
+
See [`korean-print-conventions.md`](../../knowledge/print/korean-print-conventions.md) for details.
|
|
113
|
+
|
|
114
|
+
### 8. File delivery
|
|
115
|
+
|
|
116
|
+
Required:
|
|
117
|
+
- **PDF/X-1a** export (or PDF/X-4 if printer accepts).
|
|
118
|
+
- **3mm bleed** + crop marks + bleed marks.
|
|
119
|
+
- **Fonts outlined** (or licensed for embedding).
|
|
120
|
+
- **All images embedded** (no linked external).
|
|
121
|
+
- **CMYK** color mode + Pantone spots defined.
|
|
122
|
+
- **ICC profile** matching printer (Japan Color 2001 Coated for KR).
|
|
123
|
+
- **Total ink coverage ≤ 300%** (some printers say 280%).
|
|
124
|
+
|
|
125
|
+
Optional:
|
|
126
|
+
- Source AI / INDD files.
|
|
127
|
+
- Spec sheet with paper + finish + special-effect details.
|
|
128
|
+
- Sign-off press proof.
|
|
129
|
+
|
|
130
|
+
### 9. Output
|
|
131
|
+
|
|
132
|
+
Use this structure:
|
|
133
|
+
|
|
134
|
+
```markdown
|
|
135
|
+
# Print spec: <piece name>
|
|
136
|
+
|
|
137
|
+
> Brand: <...>
|
|
138
|
+
> Audience: <KR / international / mixed>
|
|
139
|
+
> Tier: <basic / mid / premium / luxury>
|
|
140
|
+
> Quantity: <...>
|
|
141
|
+
|
|
142
|
+
## Specs
|
|
143
|
+
| Spec | Value |
|
|
144
|
+
... dimensions, paper, finish, color, file format
|
|
145
|
+
|
|
146
|
+
## Color tokens
|
|
147
|
+
<CMYK + Pantone>
|
|
148
|
+
|
|
149
|
+
## Typography
|
|
150
|
+
<fonts, sizes, weights>
|
|
151
|
+
|
|
152
|
+
## Layout
|
|
153
|
+
<panel-by-panel for multi-panel pieces>
|
|
154
|
+
|
|
155
|
+
## Regulatory checklist (if applicable)
|
|
156
|
+
|
|
157
|
+
## Cost estimate
|
|
158
|
+
|
|
159
|
+
## File delivery
|
|
160
|
+
|
|
161
|
+
## Pre-press checklist
|
|
162
|
+
|
|
163
|
+
## Press proof approval
|
|
164
|
+
|
|
165
|
+
## Don't
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
## Source files this skill reads
|
|
169
|
+
|
|
170
|
+
- [`knowledge/print/print-fundamentals.md`](../../knowledge/print/print-fundamentals.md) — CMYK, bleed, DPI
|
|
171
|
+
- [`knowledge/print/stationery.md`](../../knowledge/print/stationery.md) — business cards, letterhead
|
|
172
|
+
- [`knowledge/print/brochures-and-flyers.md`](../../knowledge/print/brochures-and-flyers.md) — multi-page
|
|
173
|
+
- [`knowledge/print/signage-and-posters.md`](../../knowledge/print/signage-and-posters.md) — large format
|
|
174
|
+
- [`knowledge/print/packaging.md`](../../knowledge/print/packaging.md) — boxes, dielines
|
|
175
|
+
- [`knowledge/print/korean-print-conventions.md`](../../knowledge/print/korean-print-conventions.md) — KR conventions
|
|
176
|
+
- [`knowledge/typography/font-pairings.md`](../../knowledge/typography/font-pairings.md) — Pretendard pairings
|
|
177
|
+
- [`knowledge/patterns/brand-identity.md`](../../knowledge/patterns/brand-identity.md) — brand foundation
|
|
178
|
+
- [`knowledge/i18n/korean-document-style.md`](../../knowledge/i18n/korean-document-style.md) — Korean voice
|
|
179
|
+
- [`examples/print-business-card-spec.md`](../../examples/print-business-card-spec.md) — reference spec
|
|
180
|
+
- [`examples/print-packaging-spec.md`](../../examples/print-packaging-spec.md) — reference spec
|
|
181
|
+
|
|
182
|
+
## Verification phase (run before declaring done)
|
|
183
|
+
|
|
184
|
+
- [ ] Are dimensions stated AND bleed (3mm min) included?
|
|
185
|
+
- [ ] Is color mode CMYK + Pantone explicitly defined (not silent)?
|
|
186
|
+
- [ ] Is paper weight + finish specified?
|
|
187
|
+
- [ ] Are fonts named with sizes + weights for each role?
|
|
188
|
+
- [ ] If regulatory (food / cosmetics): is the regulatory checklist applied?
|
|
189
|
+
- [ ] If Korean piece: is 명함 90×50 used (vs international 85×55)?
|
|
190
|
+
- [ ] Are recycling marks specified for KR packaging?
|
|
191
|
+
- [ ] Is total ink coverage ≤ 300% noted?
|
|
192
|
+
- [ ] Is press proof step included for brand-critical color?
|
|
193
|
+
- [ ] Does the "Don't" section catch 2-3 specific misuses?
|
|
194
|
+
|
|
195
|
+
## Done when
|
|
196
|
+
|
|
197
|
+
- One markdown spec.
|
|
198
|
+
- Dimensions + bleed + safe area.
|
|
199
|
+
- Paper + finish + special effects.
|
|
200
|
+
- Color (CMYK + Pantone).
|
|
201
|
+
- Typography.
|
|
202
|
+
- Layout (per panel for multi-panel pieces).
|
|
203
|
+
- Regulatory checklist if applicable.
|
|
204
|
+
- Cost estimate.
|
|
205
|
+
- File delivery format.
|
|
206
|
+
- Pre-press checklist.
|
|
207
|
+
- Press proof step.
|
|
208
|
+
- "Don't" section.
|
|
209
|
+
- Verification passes.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: print-designer
|
|
3
|
+
description: Design and spec a print piece — business card, brochure, poster, packaging, or full stationery system. Picks size, paper, finish, color (CMYK + Pantone), bleed, regulatory content; produces a print-ready spec. Korean print conventions baked in.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
See [PLAYBOOK.md](PLAYBOOK.md).
|