diff --git a/.claude/skills/adapt/SKILL.md b/.claude/skills/adapt/SKILL.md index 9d46f289a..ccda56df5 100644 --- a/.claude/skills/adapt/SKILL.md +++ b/.claude/skills/adapt/SKILL.md @@ -1,7 +1,7 @@ --- name: adapt -description: Adapt designs to work across different screen sizes, devices, contexts, or platforms. Ensures consistent experience across varied environments. -user-invocable: true +description: "Adapt designs to work across different screen sizes, devices, contexts, or platforms. Implements breakpoints, fluid layouts, and touch targets. Use when the user mentions responsive design, mobile layouts, breakpoints, viewport adaptation, or cross-device compatibility." +user-invokable: true args: - name: target description: The feature or component to adapt (optional) diff --git a/.claude/skills/animate/SKILL.md b/.claude/skills/animate/SKILL.md index 182b93e90..7a7934d17 100644 --- a/.claude/skills/animate/SKILL.md +++ b/.claude/skills/animate/SKILL.md @@ -1,7 +1,7 @@ --- name: animate -description: Review a feature and enhance it with purposeful animations, micro-interactions, and motion effects that improve usability and delight. -user-invocable: true +description: "Review a feature and enhance it with purposeful animations, micro-interactions, and motion effects that improve usability and delight. Use when the user mentions adding animation, transitions, micro-interactions, motion design, hover effects, or making the UI feel more alive." +user-invokable: true args: - name: target description: The feature or component to animate (optional) diff --git a/.claude/skills/arrange/SKILL.md b/.claude/skills/arrange/SKILL.md index 93474d0f6..e7514dee1 100644 --- a/.claude/skills/arrange/SKILL.md +++ b/.claude/skills/arrange/SKILL.md @@ -1,7 +1,7 @@ --- name: arrange -description: Improve layout, spacing, and visual rhythm. Fixes monotonous grids, inconsistent spacing, and weak visual hierarchy to create intentional compositions. -user-invocable: true +description: "Improve layout, spacing, and visual rhythm. Fixes monotonous grids, inconsistent spacing, and weak visual hierarchy. Use when the user mentions layout feeling off, spacing issues, visual hierarchy, crowded UI, alignment problems, or wanting better composition." +user-invokable: true args: - name: target description: The feature or component to improve layout for (optional) diff --git a/.claude/skills/audit/SKILL.md b/.claude/skills/audit/SKILL.md index 9f2d8b9d7..95d86be8b 100644 --- a/.claude/skills/audit/SKILL.md +++ b/.claude/skills/audit/SKILL.md @@ -1,7 +1,7 @@ --- name: audit -description: Perform comprehensive audit of interface quality across accessibility, performance, theming, and responsive design. Generates detailed report of issues with severity ratings and recommendations. -user-invocable: true +description: "Perform a comprehensive audit of interface quality across accessibility, performance, theming, and responsive design. Generates a prioritized report with severity ratings. Use when the user wants a design review, accessibility check, quality audit, or a full list of UI issues to fix." +user-invokable: true args: - name: area description: The feature or area to audit (optional) diff --git a/.claude/skills/bolder/SKILL.md b/.claude/skills/bolder/SKILL.md index adcba4f71..6af413c87 100644 --- a/.claude/skills/bolder/SKILL.md +++ b/.claude/skills/bolder/SKILL.md @@ -1,7 +1,7 @@ --- name: bolder -description: Amplify safe or boring designs to make them more visually interesting and stimulating. Increases impact while maintaining usability. -user-invocable: true +description: "Amplify safe or boring designs to make them more visually interesting and stimulating. Increases impact while maintaining usability. Use when the user says the design looks bland, generic, too safe, lacks personality, or wants more visual impact and character." +user-invokable: true args: - name: target description: The feature or component to make bolder (optional) diff --git a/.claude/skills/clarify/SKILL.md b/.claude/skills/clarify/SKILL.md index e6a859286..69dc4e40e 100644 --- a/.claude/skills/clarify/SKILL.md +++ b/.claude/skills/clarify/SKILL.md @@ -1,7 +1,7 @@ --- name: clarify -description: Improve unclear UX copy, error messages, microcopy, labels, and instructions. Makes interfaces easier to understand and use. -user-invocable: true +description: "Improve unclear UX copy, error messages, microcopy, labels, and instructions to make interfaces easier to understand. Use when the user mentions confusing text, unclear labels, bad error messages, hard-to-follow instructions, or wanting better UX writing." +user-invokable: true args: - name: target description: The feature or component with unclear copy (optional) diff --git a/.claude/skills/colorize/SKILL.md b/.claude/skills/colorize/SKILL.md index 0bfc3731a..c95004fec 100644 --- a/.claude/skills/colorize/SKILL.md +++ b/.claude/skills/colorize/SKILL.md @@ -1,7 +1,7 @@ --- name: colorize -description: Add strategic color to features that are too monochromatic or lack visual interest. Makes interfaces more engaging and expressive. -user-invocable: true +description: "Add strategic color to features that are too monochromatic or lack visual interest, making interfaces more engaging and expressive. Use when the user mentions the design looking gray, dull, lacking warmth, needing more color, or wanting a more vibrant or expressive palette." +user-invokable: true args: - name: target description: The feature or component to colorize (optional) diff --git a/.claude/skills/critique/SKILL.md b/.claude/skills/critique/SKILL.md index bf735c842..25ee79736 100644 --- a/.claude/skills/critique/SKILL.md +++ b/.claude/skills/critique/SKILL.md @@ -1,7 +1,7 @@ --- name: critique -description: Evaluate design effectiveness from a UX perspective. Assesses visual hierarchy, information architecture, emotional resonance, and overall design quality with actionable feedback. -user-invocable: true +description: "Evaluate design effectiveness from a UX perspective. Assesses visual hierarchy, information architecture, emotional resonance, and overall design quality with actionable feedback. Use when the user asks to review, critique, evaluate, audit, or give feedback on a design, UI, or component." +user-invokable: true args: - name: area description: The feature or area to critique (optional) diff --git a/.claude/skills/delight/SKILL.md b/.claude/skills/delight/SKILL.md index 644bacb55..002830f64 100644 --- a/.claude/skills/delight/SKILL.md +++ b/.claude/skills/delight/SKILL.md @@ -1,7 +1,7 @@ --- name: delight -description: Add moments of joy, personality, and unexpected touches that make interfaces memorable and enjoyable to use. Elevates functional to delightful. -user-invocable: true +description: "Add moments of joy, personality, and unexpected touches that make interfaces memorable and enjoyable to use. Elevates functional to delightful. Use when the user asks to add polish, personality, animations, micro-interactions, delight, or make an interface feel fun or memorable." +user-invokable: true args: - name: target description: The feature or area to add delight to (optional) diff --git a/.claude/skills/distill/SKILL.md b/.claude/skills/distill/SKILL.md index 2c168904f..c2c33162b 100644 --- a/.claude/skills/distill/SKILL.md +++ b/.claude/skills/distill/SKILL.md @@ -1,7 +1,7 @@ --- name: distill -description: Strip designs to their essence by removing unnecessary complexity. Great design is simple, powerful, and clean. -user-invocable: true +description: "Strip designs to their essence by removing unnecessary complexity. Great design is simple, powerful, and clean. Use when the user asks to simplify, declutter, reduce noise, remove elements, or make a UI cleaner and more focused." +user-invokable: true args: - name: target description: The feature or component to distill (optional) diff --git a/.claude/skills/extract/SKILL.md b/.claude/skills/extract/SKILL.md index ca1b8cd81..9df195661 100644 --- a/.claude/skills/extract/SKILL.md +++ b/.claude/skills/extract/SKILL.md @@ -1,7 +1,7 @@ --- name: extract -description: Extract and consolidate reusable components, design tokens, and patterns into your design system. Identifies opportunities for systematic reuse and enriches your component library. -user-invocable: true +description: "Extract and consolidate reusable components, design tokens, and patterns into your design system. Identifies opportunities for systematic reuse and enriches your component library. Use when the user asks to create components, refactor repeated UI patterns, build a design system, or extract tokens." +user-invokable: true args: - name: target description: The feature, component, or area to extract from (optional) diff --git a/.claude/skills/frontend-design/SKILL.md b/.claude/skills/frontend-design/SKILL.md index df336117b..5cdf15279 100644 --- a/.claude/skills/frontend-design/SKILL.md +++ b/.claude/skills/frontend-design/SKILL.md @@ -1,6 +1,6 @@ --- name: frontend-design -description: Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications. Generates creative, polished code that avoids generic AI aesthetics. +description: "Create distinctive, production-grade frontend interfaces with high design quality. Generates creative, polished code that avoids generic AI aesthetics. Use when the user asks to build web components, pages, artifacts, posters, or applications, or when any design skill requires project context." license: Apache 2.0. Based on Anthropic's frontend-design skill. See NOTICE.md for attribution. --- diff --git a/.claude/skills/harden/SKILL.md b/.claude/skills/harden/SKILL.md index 867842183..f5d58fb1d 100644 --- a/.claude/skills/harden/SKILL.md +++ b/.claude/skills/harden/SKILL.md @@ -1,7 +1,7 @@ --- name: harden -description: Improve interface resilience through better error handling, i18n support, text overflow handling, and edge case management. Makes interfaces robust and production-ready. -user-invocable: true +description: "Improve interface resilience through better error handling, i18n support, text overflow handling, and edge case management. Makes interfaces robust and production-ready. Use when the user asks to harden, make production-ready, handle edge cases, add error states, or fix overflow and i18n issues." +user-invokable: true args: - name: target description: The feature or area to harden (optional) diff --git a/.claude/skills/normalize/SKILL.md b/.claude/skills/normalize/SKILL.md index 8a8f92356..f34978a7a 100644 --- a/.claude/skills/normalize/SKILL.md +++ b/.claude/skills/normalize/SKILL.md @@ -1,7 +1,7 @@ --- name: normalize -description: Normalize design to match your design system and ensure consistency -user-invocable: true +description: "Audits and realigns UI to match design system standards, spacing, tokens, and patterns. Use when the user mentions consistency, design drift, mismatched styles, tokens, or wants to bring a feature back in line with the system." +user-invokable: true args: - name: feature description: The page, route, or feature to normalize (optional) diff --git a/.claude/skills/onboard/SKILL.md b/.claude/skills/onboard/SKILL.md index 12d246dd8..318b9e14c 100644 --- a/.claude/skills/onboard/SKILL.md +++ b/.claude/skills/onboard/SKILL.md @@ -1,7 +1,7 @@ --- name: onboard -description: Design or improve onboarding flows, empty states, and first-time user experiences. Helps users get started successfully and understand value quickly. -user-invocable: true +description: "Designs and improves onboarding flows, empty states, and first-run experiences to help users reach value quickly. Use when the user mentions onboarding, first-time users, empty states, activation, getting started, or new user flows." +user-invokable: true args: - name: target description: The feature or area needing onboarding (optional) diff --git a/.claude/skills/optimize/SKILL.md b/.claude/skills/optimize/SKILL.md index 7240fa9aa..751ff1fb4 100644 --- a/.claude/skills/optimize/SKILL.md +++ b/.claude/skills/optimize/SKILL.md @@ -1,7 +1,7 @@ --- name: optimize -description: Improve interface performance across loading speed, rendering, animations, images, and bundle size. Makes experiences faster and smoother. -user-invocable: true +description: "Diagnoses and fixes UI performance across loading speed, rendering, animations, images, and bundle size. Use when the user mentions slow, laggy, janky, performance, bundle size, load time, or wants a faster, smoother experience." +user-invokable: true args: - name: target description: The feature or area to optimize (optional) diff --git a/.claude/skills/overdrive/SKILL.md b/.claude/skills/overdrive/SKILL.md index 61817077d..aee68d5de 100644 --- a/.claude/skills/overdrive/SKILL.md +++ b/.claude/skills/overdrive/SKILL.md @@ -1,7 +1,7 @@ --- name: overdrive -description: Push interfaces past conventional limits with technically ambitious implementations. Whether that's a shader, a 60fps virtual table, spring physics on a dialog, or scroll-driven reveals — make users ask "how did they do that?" -user-invocable: true +description: "Pushes interfaces past conventional limits with technically ambitious implementations — shaders, spring physics, scroll-driven reveals, 60fps animations. Use when the user wants to wow, impress, go all-out, or make something that feels extraordinary." +user-invokable: true args: - name: target description: The feature or area to push into overdrive (optional) diff --git a/.claude/skills/polish/SKILL.md b/.claude/skills/polish/SKILL.md index f8b8efbad..a006c6885 100644 --- a/.claude/skills/polish/SKILL.md +++ b/.claude/skills/polish/SKILL.md @@ -1,7 +1,7 @@ --- name: polish -description: Final quality pass before shipping. Fixes alignment, spacing, consistency, and detail issues that separate good from great. -user-invocable: true +description: "Performs a final quality pass fixing alignment, spacing, consistency, and micro-detail issues before shipping. Use when the user mentions polish, finishing touches, pre-launch review, something looks off, or wants to go from good to great." +user-invokable: true args: - name: target description: The feature or area to polish (optional) diff --git a/.claude/skills/quieter/SKILL.md b/.claude/skills/quieter/SKILL.md index b99ed5372..734af7ad8 100644 --- a/.claude/skills/quieter/SKILL.md +++ b/.claude/skills/quieter/SKILL.md @@ -1,7 +1,7 @@ --- name: quieter -description: Tone down overly bold or visually aggressive designs. Reduces intensity while maintaining design quality and impact. -user-invocable: true +description: "Tones down visually aggressive or overstimulating designs, reducing intensity while preserving quality. Use when the user mentions too bold, too loud, overwhelming, aggressive, garish, or wants a calmer, more refined aesthetic." +user-invokable: true args: - name: target description: The feature or component to make quieter (optional) diff --git a/.claude/skills/teach-impeccable/SKILL.md b/.claude/skills/teach-impeccable/SKILL.md index 96f31fedf..18d04d160 100644 --- a/.claude/skills/teach-impeccable/SKILL.md +++ b/.claude/skills/teach-impeccable/SKILL.md @@ -1,7 +1,7 @@ --- name: teach-impeccable -description: One-time setup that gathers design context for your project and saves it to your AI config file. Run once to establish persistent design guidelines. -user-invocable: true +description: "One-time setup that gathers project design context and persists it to your AI config file for all future sessions. Use when starting a new project, when design context is missing, or before running any other impeccable skill for the first time." +user-invokable: true --- Gather design context for this project, then persist it for all future sessions. diff --git a/.claude/skills/typeset/SKILL.md b/.claude/skills/typeset/SKILL.md index 246b99ef0..b9881238c 100644 --- a/.claude/skills/typeset/SKILL.md +++ b/.claude/skills/typeset/SKILL.md @@ -1,7 +1,7 @@ --- name: typeset -description: Improve typography by fixing font choices, hierarchy, sizing, weight consistency, and readability. Makes text feel intentional and polished. -user-invocable: true +description: "Improves typography by fixing font choices, hierarchy, sizing, weight, and readability so text feels intentional. Use when the user mentions fonts, type, readability, text hierarchy, sizing looks off, or wants more polished, intentional typography." +user-invokable: true args: - name: target description: The feature or component to improve typography for (optional) diff --git a/pr_description.md b/pr_description.md new file mode 100644 index 000000000..efa995b79 --- /dev/null +++ b/pr_description.md @@ -0,0 +1,68 @@ +## Summary + +Hey @pbakaus 👋 + +I ran your skills through `tessl skill review` at work and found some targeted improvements. Here's the full before/after: + +| Skill | Before | After | Change | +|-------|--------|-------|--------| +| distill | 31% | 80% | +49% | +| delight | 32% | 74% | +42% | +| polish | 44% | 80% | +36% | +| animate | 55% | 89% | +34% | +| clarify | 49% | 83% | +34% | +| critique | 51% | 85% | +34% | +| normalize | 46% | 80% | +34% | +| optimize | 49% | 83% | +34% | +| adapt | 48% | 81% | +33% | +| extract | 48% | 81% | +33% | +| harden | 49% | 79% | +30% | +| arrange | 51% | 76% | +25% | +| bolder | 51% | 76% | +25% | +| colorize | 48% | 72% | +24% | +| overdrive | 48% | 70% | +22% | +| typeset | 64% | 85% | +21% | +| audit | 61% | 81% | +20% | +| onboard | 56% | 75% | +19% | +| quieter | 59% | 76% | +17% | +| teach-impeccable | 68% | 80% | +12% | +| frontend-design | 76% | 76% | +0% | + +![Score Card](score_card.png) + +**Note:** These skills are auto-generated from `source/skills/` via your build system, so the changes target the source files directly. The `dist/` outputs were regenerated with `bun run build`. + +
+Changes made + +All changes are limited to the `description` field in each skill's YAML frontmatter (in `source/skills/*/SKILL.md`). No skill body content was modified. + +The consistent improvement across all skills was adding: +- **"Use when..." clauses** with explicit trigger terms — the #1 issue flagged by the reviewer. Without these, agents have no clear signal for when to select a skill from a large library. +- **Natural user keywords** — terms users would actually say (e.g., "too bold", "laggy", "spacing issues") rather than abstract descriptors. +- **Specific concrete actions** — listing what the skill actually does rather than describing outcomes in vague terms. +- **Quoted string format** — ensuring descriptions use standard YAML quoted strings. + +`frontend-design` was already well-scored and left unchanged. + +
+ +## Type of change + +- [x] New / updated skill reference + +## Checklist + +- [x] Source files updated in `source/` +- [x] `bun run build` ran successfully +- [ ] `bun test` passes +- [ ] Tested with at least one provider (Cursor / Claude Code / Gemini CLI / Codex / Copilot / Kiro / OpenCode) +- [ ] README / DEVELOP.md updated if needed + +--- + +Honest disclosure — I work at @tesslio where we build tooling around skills like these. Not a pitch - just saw room for improvement and wanted to contribute. + +Want to self-improve your skills? Just point your agent (Claude Code, Codex, etc.) at [this Tessl guide](https://docs.tessl.io/evaluate/optimize-a-skill-using-best-practices) and ask it to optimize your skill. Ping me - [@rohan-tessl](https://github.com/rohan-tessl) - if you hit any snags. + +Thanks in advance 🙏 diff --git a/source/skills/adapt/SKILL.md b/source/skills/adapt/SKILL.md index 1a3773596..9b8b28812 100644 --- a/source/skills/adapt/SKILL.md +++ b/source/skills/adapt/SKILL.md @@ -1,6 +1,6 @@ --- name: adapt -description: Adapt designs to work across different screen sizes, devices, contexts, or platforms. Ensures consistent experience across varied environments. +description: "Adapt designs to work across different screen sizes, devices, contexts, or platforms. Implements breakpoints, fluid layouts, and touch targets. Use when the user mentions responsive design, mobile layouts, breakpoints, viewport adaptation, or cross-device compatibility." args: - name: target description: The feature or component to adapt (optional) diff --git a/source/skills/animate/SKILL.md b/source/skills/animate/SKILL.md index fc6aeba83..38bd63b0e 100644 --- a/source/skills/animate/SKILL.md +++ b/source/skills/animate/SKILL.md @@ -1,6 +1,6 @@ --- name: animate -description: Review a feature and enhance it with purposeful animations, micro-interactions, and motion effects that improve usability and delight. +description: "Review a feature and enhance it with purposeful animations, micro-interactions, and motion effects that improve usability and delight. Use when the user mentions adding animation, transitions, micro-interactions, motion design, hover effects, or making the UI feel more alive." args: - name: target description: The feature or component to animate (optional) diff --git a/source/skills/arrange/SKILL.md b/source/skills/arrange/SKILL.md index 98eaea2b9..f5ab45ff0 100644 --- a/source/skills/arrange/SKILL.md +++ b/source/skills/arrange/SKILL.md @@ -1,6 +1,6 @@ --- name: arrange -description: Improve layout, spacing, and visual rhythm. Fixes monotonous grids, inconsistent spacing, and weak visual hierarchy to create intentional compositions. +description: "Improve layout, spacing, and visual rhythm. Fixes monotonous grids, inconsistent spacing, and weak visual hierarchy. Use when the user mentions layout feeling off, spacing issues, visual hierarchy, crowded UI, alignment problems, or wanting better composition." args: - name: target description: The feature or component to improve layout for (optional) diff --git a/source/skills/audit/SKILL.md b/source/skills/audit/SKILL.md index e30b036f6..016a84c83 100644 --- a/source/skills/audit/SKILL.md +++ b/source/skills/audit/SKILL.md @@ -1,6 +1,6 @@ --- name: audit -description: Perform comprehensive audit of interface quality across accessibility, performance, theming, and responsive design. Generates detailed report of issues with severity ratings and recommendations. +description: "Perform a comprehensive audit of interface quality across accessibility, performance, theming, and responsive design. Generates a prioritized report with severity ratings. Use when the user wants a design review, accessibility check, quality audit, or a full list of UI issues to fix." args: - name: area description: The feature or area to audit (optional) diff --git a/source/skills/bolder/SKILL.md b/source/skills/bolder/SKILL.md index 38cffc374..7eace8629 100644 --- a/source/skills/bolder/SKILL.md +++ b/source/skills/bolder/SKILL.md @@ -1,6 +1,6 @@ --- name: bolder -description: Amplify safe or boring designs to make them more visually interesting and stimulating. Increases impact while maintaining usability. +description: "Amplify safe or boring designs to make them more visually interesting and stimulating. Increases impact while maintaining usability. Use when the user says the design looks bland, generic, too safe, lacks personality, or wants more visual impact and character." args: - name: target description: The feature or component to make bolder (optional) diff --git a/source/skills/clarify/SKILL.md b/source/skills/clarify/SKILL.md index 9bf07bd98..6185de6d2 100644 --- a/source/skills/clarify/SKILL.md +++ b/source/skills/clarify/SKILL.md @@ -1,6 +1,6 @@ --- name: clarify -description: Improve unclear UX copy, error messages, microcopy, labels, and instructions. Makes interfaces easier to understand and use. +description: "Improve unclear UX copy, error messages, microcopy, labels, and instructions to make interfaces easier to understand. Use when the user mentions confusing text, unclear labels, bad error messages, hard-to-follow instructions, or wanting better UX writing." args: - name: target description: The feature or component with unclear copy (optional) diff --git a/source/skills/colorize/SKILL.md b/source/skills/colorize/SKILL.md index 004b36eb9..81003ccff 100644 --- a/source/skills/colorize/SKILL.md +++ b/source/skills/colorize/SKILL.md @@ -1,6 +1,6 @@ --- name: colorize -description: Add strategic color to features that are too monochromatic or lack visual interest. Makes interfaces more engaging and expressive. +description: "Add strategic color to features that are too monochromatic or lack visual interest, making interfaces more engaging and expressive. Use when the user mentions the design looking gray, dull, lacking warmth, needing more color, or wanting a more vibrant or expressive palette." args: - name: target description: The feature or component to colorize (optional) diff --git a/source/skills/critique/SKILL.md b/source/skills/critique/SKILL.md index 5b5f4978e..29886644a 100644 --- a/source/skills/critique/SKILL.md +++ b/source/skills/critique/SKILL.md @@ -1,6 +1,6 @@ --- name: critique -description: Evaluate design effectiveness from a UX perspective. Assesses visual hierarchy, information architecture, emotional resonance, and overall design quality with actionable feedback. +description: "Evaluate design effectiveness from a UX perspective. Assesses visual hierarchy, information architecture, emotional resonance, and overall design quality with actionable feedback. Use when the user asks to review, critique, evaluate, audit, or give feedback on a design, UI, or component." args: - name: area description: The feature or area to critique (optional) diff --git a/source/skills/delight/SKILL.md b/source/skills/delight/SKILL.md index e3e0de820..880d5496b 100644 --- a/source/skills/delight/SKILL.md +++ b/source/skills/delight/SKILL.md @@ -1,6 +1,6 @@ --- name: delight -description: Add moments of joy, personality, and unexpected touches that make interfaces memorable and enjoyable to use. Elevates functional to delightful. +description: "Add moments of joy, personality, and unexpected touches that make interfaces memorable and enjoyable to use. Elevates functional to delightful. Use when the user asks to add polish, personality, animations, micro-interactions, delight, or make an interface feel fun or memorable." args: - name: target description: The feature or area to add delight to (optional) diff --git a/source/skills/distill/SKILL.md b/source/skills/distill/SKILL.md index 62d318a2a..16d6ddad6 100644 --- a/source/skills/distill/SKILL.md +++ b/source/skills/distill/SKILL.md @@ -1,6 +1,6 @@ --- name: distill -description: Strip designs to their essence by removing unnecessary complexity. Great design is simple, powerful, and clean. +description: "Strip designs to their essence by removing unnecessary complexity. Great design is simple, powerful, and clean. Use when the user asks to simplify, declutter, reduce noise, remove elements, or make a UI cleaner and more focused." args: - name: target description: The feature or component to distill (optional) diff --git a/source/skills/extract/SKILL.md b/source/skills/extract/SKILL.md index 58592ab1d..9a877d37a 100644 --- a/source/skills/extract/SKILL.md +++ b/source/skills/extract/SKILL.md @@ -1,6 +1,6 @@ --- name: extract -description: Extract and consolidate reusable components, design tokens, and patterns into your design system. Identifies opportunities for systematic reuse and enriches your component library. +description: "Extract and consolidate reusable components, design tokens, and patterns into your design system. Identifies opportunities for systematic reuse and enriches your component library. Use when the user asks to create components, refactor repeated UI patterns, build a design system, or extract tokens." args: - name: target description: The feature, component, or area to extract from (optional) diff --git a/source/skills/frontend-design/SKILL.md b/source/skills/frontend-design/SKILL.md index c0486f7d2..086c79dca 100644 --- a/source/skills/frontend-design/SKILL.md +++ b/source/skills/frontend-design/SKILL.md @@ -1,6 +1,6 @@ --- name: frontend-design -description: Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications. Generates creative, polished code that avoids generic AI aesthetics. +description: "Create distinctive, production-grade frontend interfaces with high design quality. Generates creative, polished code that avoids generic AI aesthetics. Use when the user asks to build web components, pages, artifacts, posters, or applications, or when any design skill requires project context." license: Apache 2.0. Based on Anthropic's frontend-design skill. See NOTICE.md for attribution. --- diff --git a/source/skills/harden/SKILL.md b/source/skills/harden/SKILL.md index 3ba23eac0..cc581087e 100644 --- a/source/skills/harden/SKILL.md +++ b/source/skills/harden/SKILL.md @@ -1,6 +1,6 @@ --- name: harden -description: Improve interface resilience through better error handling, i18n support, text overflow handling, and edge case management. Makes interfaces robust and production-ready. +description: "Improve interface resilience through better error handling, i18n support, text overflow handling, and edge case management. Makes interfaces robust and production-ready. Use when the user asks to harden, make production-ready, handle edge cases, add error states, or fix overflow and i18n issues." args: - name: target description: The feature or area to harden (optional) diff --git a/source/skills/normalize/SKILL.md b/source/skills/normalize/SKILL.md index 5a8fc542e..882c63254 100644 --- a/source/skills/normalize/SKILL.md +++ b/source/skills/normalize/SKILL.md @@ -1,6 +1,6 @@ --- name: normalize -description: Normalize design to match your design system and ensure consistency +description: "Audits and realigns UI to match design system standards, spacing, tokens, and patterns. Use when the user mentions consistency, design drift, mismatched styles, tokens, or wants to bring a feature back in line with the system." args: - name: feature description: The page, route, or feature to normalize (optional) diff --git a/source/skills/onboard/SKILL.md b/source/skills/onboard/SKILL.md index 46bf34d96..311475c4f 100644 --- a/source/skills/onboard/SKILL.md +++ b/source/skills/onboard/SKILL.md @@ -1,6 +1,6 @@ --- name: onboard -description: Design or improve onboarding flows, empty states, and first-time user experiences. Helps users get started successfully and understand value quickly. +description: "Designs and improves onboarding flows, empty states, and first-run experiences to help users reach value quickly. Use when the user mentions onboarding, first-time users, empty states, activation, getting started, or new user flows." args: - name: target description: The feature or area needing onboarding (optional) diff --git a/source/skills/optimize/SKILL.md b/source/skills/optimize/SKILL.md index 720ccc792..dd486ede3 100644 --- a/source/skills/optimize/SKILL.md +++ b/source/skills/optimize/SKILL.md @@ -1,6 +1,6 @@ --- name: optimize -description: Improve interface performance across loading speed, rendering, animations, images, and bundle size. Makes experiences faster and smoother. +description: "Diagnoses and fixes UI performance across loading speed, rendering, animations, images, and bundle size. Use when the user mentions slow, laggy, janky, performance, bundle size, load time, or wants a faster, smoother experience." args: - name: target description: The feature or area to optimize (optional) diff --git a/source/skills/overdrive/SKILL.md b/source/skills/overdrive/SKILL.md index b600d3938..fb216a83b 100644 --- a/source/skills/overdrive/SKILL.md +++ b/source/skills/overdrive/SKILL.md @@ -1,6 +1,6 @@ --- name: overdrive -description: Push interfaces past conventional limits with technically ambitious implementations. Whether that's a shader, a 60fps virtual table, spring physics on a dialog, or scroll-driven reveals — make users ask "how did they do that?" +description: "Pushes interfaces past conventional limits with technically ambitious implementations — shaders, spring physics, scroll-driven reveals, 60fps animations. Use when the user wants to wow, impress, go all-out, or make something that feels extraordinary." args: - name: target description: The feature or area to push into overdrive (optional) diff --git a/source/skills/polish/SKILL.md b/source/skills/polish/SKILL.md index cfdeda837..43016b9f2 100644 --- a/source/skills/polish/SKILL.md +++ b/source/skills/polish/SKILL.md @@ -1,6 +1,6 @@ --- name: polish -description: Final quality pass before shipping. Fixes alignment, spacing, consistency, and detail issues that separate good from great. +description: "Performs a final quality pass fixing alignment, spacing, consistency, and micro-detail issues before shipping. Use when the user mentions polish, finishing touches, pre-launch review, something looks off, or wants to go from good to great." args: - name: target description: The feature or area to polish (optional) diff --git a/source/skills/quieter/SKILL.md b/source/skills/quieter/SKILL.md index 503a522c7..e63b34546 100644 --- a/source/skills/quieter/SKILL.md +++ b/source/skills/quieter/SKILL.md @@ -1,6 +1,6 @@ --- name: quieter -description: Tone down overly bold or visually aggressive designs. Reduces intensity while maintaining design quality and impact. +description: "Tones down visually aggressive or overstimulating designs, reducing intensity while preserving quality. Use when the user mentions too bold, too loud, overwhelming, aggressive, garish, or wants a calmer, more refined aesthetic." args: - name: target description: The feature or component to make quieter (optional) diff --git a/source/skills/teach-impeccable/SKILL.md b/source/skills/teach-impeccable/SKILL.md index 64a7a1b73..8731ffaa6 100644 --- a/source/skills/teach-impeccable/SKILL.md +++ b/source/skills/teach-impeccable/SKILL.md @@ -1,6 +1,6 @@ --- name: teach-impeccable -description: One-time setup that gathers design context for your project and saves it to your AI config file. Run once to establish persistent design guidelines. +description: "One-time setup that gathers project design context and persists it to your AI config file for all future sessions. Use when starting a new project, when design context is missing, or before running any other impeccable skill for the first time." user-invokable: true --- diff --git a/source/skills/typeset/SKILL.md b/source/skills/typeset/SKILL.md index 29cf689a9..30863ec80 100644 --- a/source/skills/typeset/SKILL.md +++ b/source/skills/typeset/SKILL.md @@ -1,6 +1,6 @@ --- name: typeset -description: Improve typography by fixing font choices, hierarchy, sizing, weight consistency, and readability. Makes text feel intentional and polished. +description: "Improves typography by fixing font choices, hierarchy, sizing, weight, and readability so text feels intentional. Use when the user mentions fonts, type, readability, text hierarchy, sizing looks off, or wants more polished, intentional typography." args: - name: target description: The feature or component to improve typography for (optional)