ccg-workflow 1.8.2 → 2.0.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/dist/cli.mjs +1 -1
- package/dist/index.d.mts +1 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.mjs +1 -1
- package/dist/shared/{ccg-workflow.B1RHp04H.mjs → ccg-workflow.iK6lgCG3.mjs} +204 -6
- package/package.json +1 -1
- package/templates/commands/agents/team-architect.md +97 -0
- package/templates/commands/agents/team-qa.md +121 -0
- package/templates/commands/agents/team-reviewer.md +112 -0
- package/templates/output-styles/abyss-command.md +56 -0
- package/templates/output-styles/abyss-concise.md +89 -0
- package/templates/output-styles/abyss-ritual.md +70 -0
- package/templates/rules/ccg-skill-routing.md +83 -0
- package/templates/skills/domains/ai/SKILL.md +34 -0
- package/templates/skills/domains/ai/agent-dev.md +242 -0
- package/templates/skills/domains/ai/llm-security.md +288 -0
- package/templates/skills/domains/ai/prompt-and-eval.md +279 -0
- package/templates/skills/domains/ai/rag-system.md +542 -0
- package/templates/skills/domains/architecture/SKILL.md +42 -0
- package/templates/skills/domains/architecture/api-design.md +225 -0
- package/templates/skills/domains/architecture/caching.md +299 -0
- package/templates/skills/domains/architecture/cloud-native.md +285 -0
- package/templates/skills/domains/architecture/message-queue.md +329 -0
- package/templates/skills/domains/architecture/security-arch.md +297 -0
- package/templates/skills/domains/data-engineering/SKILL.md +207 -0
- package/templates/skills/domains/development/SKILL.md +46 -0
- package/templates/skills/domains/development/cpp.md +246 -0
- package/templates/skills/domains/development/go.md +323 -0
- package/templates/skills/domains/development/java.md +277 -0
- package/templates/skills/domains/development/python.md +288 -0
- package/templates/skills/domains/development/rust.md +313 -0
- package/templates/skills/domains/development/shell.md +313 -0
- package/templates/skills/domains/development/typescript.md +277 -0
- package/templates/skills/domains/devops/SKILL.md +39 -0
- package/templates/skills/domains/devops/cost-optimization.md +272 -0
- package/templates/skills/domains/devops/database.md +217 -0
- package/templates/skills/domains/devops/devsecops.md +198 -0
- package/templates/skills/domains/devops/git-workflow.md +181 -0
- package/templates/skills/domains/devops/observability.md +280 -0
- package/templates/skills/domains/devops/performance.md +336 -0
- package/templates/skills/domains/devops/testing.md +283 -0
- package/templates/skills/domains/frontend-design/SKILL.md +242 -0
- package/templates/skills/domains/frontend-design/agents/openai.yaml +4 -0
- package/templates/skills/domains/frontend-design/claymorphism/SKILL.md +119 -0
- package/templates/skills/domains/frontend-design/claymorphism/references/tokens.css +52 -0
- package/templates/skills/domains/frontend-design/component-patterns.md +202 -0
- package/templates/skills/domains/frontend-design/engineering.md +287 -0
- package/templates/skills/domains/frontend-design/glassmorphism/SKILL.md +140 -0
- package/templates/skills/domains/frontend-design/glassmorphism/references/tokens.css +32 -0
- package/templates/skills/domains/frontend-design/liquid-glass/SKILL.md +137 -0
- package/templates/skills/domains/frontend-design/liquid-glass/references/tokens.css +81 -0
- package/templates/skills/domains/frontend-design/neubrutalism/SKILL.md +143 -0
- package/templates/skills/domains/frontend-design/neubrutalism/references/tokens.css +44 -0
- package/templates/skills/domains/frontend-design/reference/color-and-contrast.md +132 -0
- package/templates/skills/domains/frontend-design/reference/interaction-design.md +195 -0
- package/templates/skills/domains/frontend-design/reference/motion-design.md +99 -0
- package/templates/skills/domains/frontend-design/reference/responsive-design.md +114 -0
- package/templates/skills/domains/frontend-design/reference/spatial-design.md +100 -0
- package/templates/skills/domains/frontend-design/reference/typography.md +133 -0
- package/templates/skills/domains/frontend-design/reference/ux-writing.md +107 -0
- package/templates/skills/domains/frontend-design/state-management.md +680 -0
- package/templates/skills/domains/frontend-design/ui-aesthetics.md +110 -0
- package/templates/skills/domains/frontend-design/ux-principles.md +156 -0
- package/templates/skills/domains/infrastructure/SKILL.md +200 -0
- package/templates/skills/domains/mobile/SKILL.md +224 -0
- package/templates/skills/domains/orchestration/SKILL.md +29 -0
- package/templates/skills/domains/orchestration/multi-agent.md +263 -0
- package/templates/skills/domains/security/SKILL.md +72 -0
- package/templates/skills/domains/security/blue-team.md +436 -0
- package/templates/skills/domains/security/code-audit.md +265 -0
- package/templates/skills/domains/security/pentest.md +226 -0
- package/templates/skills/domains/security/red-team.md +374 -0
- package/templates/skills/domains/security/threat-intel.md +372 -0
- package/templates/skills/domains/security/vuln-research.md +369 -0
- package/templates/skills/impeccable/adapt/SKILL.md +199 -0
- package/templates/skills/impeccable/animate/SKILL.md +174 -0
- package/templates/skills/impeccable/arrange/SKILL.md +124 -0
- package/templates/skills/impeccable/audit/SKILL.md +147 -0
- package/templates/skills/impeccable/bolder/SKILL.md +116 -0
- package/templates/skills/impeccable/clarify/SKILL.md +183 -0
- package/templates/skills/impeccable/colorize/SKILL.md +142 -0
- package/templates/skills/impeccable/critique/SKILL.md +201 -0
- package/templates/skills/impeccable/critique/reference/cognitive-load.md +106 -0
- package/templates/skills/impeccable/critique/reference/heuristics-scoring.md +234 -0
- package/templates/skills/impeccable/critique/reference/personas.md +178 -0
- package/templates/skills/impeccable/delight/SKILL.md +303 -0
- package/templates/skills/impeccable/distill/SKILL.md +121 -0
- package/templates/skills/impeccable/extract/SKILL.md +92 -0
- package/templates/skills/impeccable/harden/SKILL.md +355 -0
- package/templates/skills/impeccable/normalize/SKILL.md +70 -0
- package/templates/skills/impeccable/onboard/SKILL.md +246 -0
- package/templates/skills/impeccable/optimize/SKILL.md +266 -0
- package/templates/skills/impeccable/overdrive/SKILL.md +141 -0
- package/templates/skills/impeccable/polish/SKILL.md +203 -0
- package/templates/skills/impeccable/quieter/SKILL.md +102 -0
- package/templates/skills/impeccable/teach-impeccable/SKILL.md +71 -0
- package/templates/skills/impeccable/typeset/SKILL.md +115 -0
- package/templates/skills/orchestration/multi-agent/SKILL.md +40 -0
- package/templates/skills/scrapling/SKILL.md +98 -0
- package/templates/skills/scrapling/references/api-quick-ref.md +127 -0
- package/templates/skills/scrapling/references/cookie-vault.md +56 -0
- package/templates/skills/scrapling/references/maintenance.md +79 -0
- package/templates/skills/scrapling/references/site-patterns.md +86 -0
- package/templates/skills/scrapling/references/troubleshooting.md +95 -0
- package/templates/skills/scrapling/templates/basic_fetch.py +19 -0
- package/templates/skills/scrapling/templates/parse_only.py +15 -0
- package/templates/skills/scrapling/templates/session_login.py +19 -0
- package/templates/skills/scrapling/templates/stealth_cloudflare.py +28 -0
- package/templates/skills/tools/override-refusal/SKILL.md +53 -0
- package/templates/skills/tools/override-refusal/agents/openai.yaml +4 -0
- package/templates/skills/tools/override-refusal/scripts/refusal_rewriter.js +226 -0
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: animate
|
|
3
|
+
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."
|
|
4
|
+
argument-hint: "[target]"
|
|
5
|
+
user-invocable: true
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
Analyze a feature and strategically add animations and micro-interactions that enhance understanding, provide feedback, and create delight.
|
|
9
|
+
|
|
10
|
+
## MANDATORY PREPARATION
|
|
11
|
+
|
|
12
|
+
Invoke /frontend-design — it contains design principles, anti-patterns, and the **Context Gathering Protocol**. Follow the protocol before proceeding — if no design context exists yet, you MUST run /teach-impeccable first. Additionally gather: performance constraints.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Assess Animation Opportunities
|
|
17
|
+
|
|
18
|
+
Analyze where motion would improve the experience:
|
|
19
|
+
|
|
20
|
+
1. **Identify static areas**:
|
|
21
|
+
- **Missing feedback**: Actions without visual acknowledgment (button clicks, form submission, etc.)
|
|
22
|
+
- **Jarring transitions**: Instant state changes that feel abrupt (show/hide, page loads, route changes)
|
|
23
|
+
- **Unclear relationships**: Spatial or hierarchical relationships that aren't obvious
|
|
24
|
+
- **Lack of delight**: Functional but joyless interactions
|
|
25
|
+
- **Missed guidance**: Opportunities to direct attention or explain behavior
|
|
26
|
+
|
|
27
|
+
2. **Understand the context**:
|
|
28
|
+
- What's the personality? (Playful vs serious, energetic vs calm)
|
|
29
|
+
- What's the performance budget? (Mobile-first? Complex page?)
|
|
30
|
+
- Who's the audience? (Motion-sensitive users? Power users who want speed?)
|
|
31
|
+
- What matters most? (One hero animation vs many micro-interactions?)
|
|
32
|
+
|
|
33
|
+
If any of these are unclear from the codebase, Ask the user using AskUserQuestion.
|
|
34
|
+
|
|
35
|
+
**CRITICAL**: Respect `prefers-reduced-motion`. Always provide non-animated alternatives for users who need them.
|
|
36
|
+
|
|
37
|
+
## Plan Animation Strategy
|
|
38
|
+
|
|
39
|
+
Create a purposeful animation plan:
|
|
40
|
+
|
|
41
|
+
- **Hero moment**: What's the ONE signature animation? (Page load? Hero section? Key interaction?)
|
|
42
|
+
- **Feedback layer**: Which interactions need acknowledgment?
|
|
43
|
+
- **Transition layer**: Which state changes need smoothing?
|
|
44
|
+
- **Delight layer**: Where can we surprise and delight?
|
|
45
|
+
|
|
46
|
+
**IMPORTANT**: One well-orchestrated experience beats scattered animations everywhere. Focus on high-impact moments.
|
|
47
|
+
|
|
48
|
+
## Implement Animations
|
|
49
|
+
|
|
50
|
+
Add motion systematically across these categories:
|
|
51
|
+
|
|
52
|
+
### Entrance Animations
|
|
53
|
+
- **Page load choreography**: Stagger element reveals (100-150ms delays), fade + slide combinations
|
|
54
|
+
- **Hero section**: Dramatic entrance for primary content (scale, parallax, or creative effects)
|
|
55
|
+
- **Content reveals**: Scroll-triggered animations using intersection observer
|
|
56
|
+
- **Modal/drawer entry**: Smooth slide + fade, backdrop fade, focus management
|
|
57
|
+
|
|
58
|
+
### Micro-interactions
|
|
59
|
+
- **Button feedback**:
|
|
60
|
+
- Hover: Subtle scale (1.02-1.05), color shift, shadow increase
|
|
61
|
+
- Click: Quick scale down then up (0.95 → 1), ripple effect
|
|
62
|
+
- Loading: Spinner or pulse state
|
|
63
|
+
- **Form interactions**:
|
|
64
|
+
- Input focus: Border color transition, slight scale or glow
|
|
65
|
+
- Validation: Shake on error, check mark on success, smooth color transitions
|
|
66
|
+
- **Toggle switches**: Smooth slide + color transition (200-300ms)
|
|
67
|
+
- **Checkboxes/radio**: Check mark animation, ripple effect
|
|
68
|
+
- **Like/favorite**: Scale + rotation, particle effects, color transition
|
|
69
|
+
|
|
70
|
+
### State Transitions
|
|
71
|
+
- **Show/hide**: Fade + slide (not instant), appropriate timing (200-300ms)
|
|
72
|
+
- **Expand/collapse**: Height transition with overflow handling, icon rotation
|
|
73
|
+
- **Loading states**: Skeleton screen fades, spinner animations, progress bars
|
|
74
|
+
- **Success/error**: Color transitions, icon animations, gentle scale pulse
|
|
75
|
+
- **Enable/disable**: Opacity transitions, cursor changes
|
|
76
|
+
|
|
77
|
+
### Navigation & Flow
|
|
78
|
+
- **Page transitions**: Crossfade between routes, shared element transitions
|
|
79
|
+
- **Tab switching**: Slide indicator, content fade/slide
|
|
80
|
+
- **Carousel/slider**: Smooth transforms, snap points, momentum
|
|
81
|
+
- **Scroll effects**: Parallax layers, sticky headers with state changes, scroll progress indicators
|
|
82
|
+
|
|
83
|
+
### Feedback & Guidance
|
|
84
|
+
- **Hover hints**: Tooltip fade-ins, cursor changes, element highlights
|
|
85
|
+
- **Drag & drop**: Lift effect (shadow + scale), drop zone highlights, smooth repositioning
|
|
86
|
+
- **Copy/paste**: Brief highlight flash on paste, "copied" confirmation
|
|
87
|
+
- **Focus flow**: Highlight path through form or workflow
|
|
88
|
+
|
|
89
|
+
### Delight Moments
|
|
90
|
+
- **Empty states**: Subtle floating animations on illustrations
|
|
91
|
+
- **Completed actions**: Confetti, check mark flourish, success celebrations
|
|
92
|
+
- **Easter eggs**: Hidden interactions for discovery
|
|
93
|
+
- **Contextual animation**: Weather effects, time-of-day themes, seasonal touches
|
|
94
|
+
|
|
95
|
+
## Technical Implementation
|
|
96
|
+
|
|
97
|
+
Use appropriate techniques for each animation:
|
|
98
|
+
|
|
99
|
+
### Timing & Easing
|
|
100
|
+
|
|
101
|
+
**Durations by purpose:**
|
|
102
|
+
- **100-150ms**: Instant feedback (button press, toggle)
|
|
103
|
+
- **200-300ms**: State changes (hover, menu open)
|
|
104
|
+
- **300-500ms**: Layout changes (accordion, modal)
|
|
105
|
+
- **500-800ms**: Entrance animations (page load)
|
|
106
|
+
|
|
107
|
+
**Easing curves (use these, not CSS defaults):**
|
|
108
|
+
```css
|
|
109
|
+
/* Recommended - natural deceleration */
|
|
110
|
+
--ease-out-quart: cubic-bezier(0.25, 1, 0.5, 1); /* Smooth, refined */
|
|
111
|
+
--ease-out-quint: cubic-bezier(0.22, 1, 0.36, 1); /* Slightly snappier */
|
|
112
|
+
--ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1); /* Confident, decisive */
|
|
113
|
+
|
|
114
|
+
/* AVOID - feel dated and tacky */
|
|
115
|
+
/* bounce: cubic-bezier(0.34, 1.56, 0.64, 1); */
|
|
116
|
+
/* elastic: cubic-bezier(0.68, -0.6, 0.32, 1.6); */
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
**Exit animations are faster than entrances.** Use ~75% of enter duration.
|
|
120
|
+
|
|
121
|
+
### CSS Animations
|
|
122
|
+
```css
|
|
123
|
+
/* Prefer for simple, declarative animations */
|
|
124
|
+
- transitions for state changes
|
|
125
|
+
- @keyframes for complex sequences
|
|
126
|
+
- transform + opacity only (GPU-accelerated)
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
### JavaScript Animation
|
|
130
|
+
```javascript
|
|
131
|
+
/* Use for complex, interactive animations */
|
|
132
|
+
- Web Animations API for programmatic control
|
|
133
|
+
- Framer Motion for React
|
|
134
|
+
- GSAP for complex sequences
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
### Performance
|
|
138
|
+
- **GPU acceleration**: Use `transform` and `opacity`, avoid layout properties
|
|
139
|
+
- **will-change**: Add sparingly for known expensive animations
|
|
140
|
+
- **Reduce paint**: Minimize repaints, use `contain` where appropriate
|
|
141
|
+
- **Monitor FPS**: Ensure 60fps on target devices
|
|
142
|
+
|
|
143
|
+
### Accessibility
|
|
144
|
+
```css
|
|
145
|
+
@media (prefers-reduced-motion: reduce) {
|
|
146
|
+
* {
|
|
147
|
+
animation-duration: 0.01ms !important;
|
|
148
|
+
animation-iteration-count: 1 !important;
|
|
149
|
+
transition-duration: 0.01ms !important;
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
**NEVER**:
|
|
155
|
+
- Use bounce or elastic easing curves—they feel dated and draw attention to the animation itself
|
|
156
|
+
- Animate layout properties (width, height, top, left)—use transform instead
|
|
157
|
+
- Use durations over 500ms for feedback—it feels laggy
|
|
158
|
+
- Animate without purpose—every animation needs a reason
|
|
159
|
+
- Ignore `prefers-reduced-motion`—this is an accessibility violation
|
|
160
|
+
- Animate everything—animation fatigue makes interfaces feel exhausting
|
|
161
|
+
- Block interaction during animations unless intentional
|
|
162
|
+
|
|
163
|
+
## Verify Quality
|
|
164
|
+
|
|
165
|
+
Test animations thoroughly:
|
|
166
|
+
|
|
167
|
+
- **Smooth at 60fps**: No jank on target devices
|
|
168
|
+
- **Feels natural**: Easing curves feel organic, not robotic
|
|
169
|
+
- **Appropriate timing**: Not too fast (jarring) or too slow (laggy)
|
|
170
|
+
- **Reduced motion works**: Animations disabled or simplified appropriately
|
|
171
|
+
- **Doesn't block**: Users can interact during/after animations
|
|
172
|
+
- **Adds value**: Makes interface clearer or more delightful
|
|
173
|
+
|
|
174
|
+
Remember: Motion should enhance understanding and provide feedback, not just add decoration. Animate with purpose, respect performance constraints, and always consider accessibility. Great animation is invisible - it just makes everything feel right.
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: arrange
|
|
3
|
+
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."
|
|
4
|
+
argument-hint: "[target]"
|
|
5
|
+
user-invocable: true
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
Assess and improve layout and spacing that feels monotonous, crowded, or structurally weak — turning generic arrangements into intentional, rhythmic compositions.
|
|
9
|
+
|
|
10
|
+
## MANDATORY PREPARATION
|
|
11
|
+
|
|
12
|
+
Invoke /frontend-design — it contains design principles, anti-patterns, and the **Context Gathering Protocol**. Follow the protocol before proceeding — if no design context exists yet, you MUST run /teach-impeccable first.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Assess Current Layout
|
|
17
|
+
|
|
18
|
+
Analyze what's weak about the current spatial design:
|
|
19
|
+
|
|
20
|
+
1. **Spacing**:
|
|
21
|
+
- Is spacing consistent or arbitrary? (Random padding/margin values)
|
|
22
|
+
- Is all spacing the same? (Equal padding everywhere = no rhythm)
|
|
23
|
+
- Are related elements grouped tightly, with generous space between groups?
|
|
24
|
+
|
|
25
|
+
2. **Visual hierarchy**:
|
|
26
|
+
- Apply the squint test: blur your (metaphorical) eyes — can you still identify the most important element, second most important, and clear groupings?
|
|
27
|
+
- Is hierarchy achieved effectively? (Space and weight alone can be enough — but is the current approach working?)
|
|
28
|
+
- Does whitespace guide the eye to what matters?
|
|
29
|
+
|
|
30
|
+
3. **Grid & structure**:
|
|
31
|
+
- Is there a clear underlying structure, or does the layout feel random?
|
|
32
|
+
- Are identical card grids used everywhere? (Icon + heading + text, repeated endlessly)
|
|
33
|
+
- Is everything centered? (Left-aligned with asymmetric layouts feels more designed, but not a hard and fast rule)
|
|
34
|
+
|
|
35
|
+
4. **Rhythm & variety**:
|
|
36
|
+
- Does the layout have visual rhythm? (Alternating tight/generous spacing)
|
|
37
|
+
- Is every section structured the same way? (Monotonous repetition)
|
|
38
|
+
- Are there intentional moments of surprise or emphasis?
|
|
39
|
+
|
|
40
|
+
5. **Density**:
|
|
41
|
+
- Is the layout too cramped? (Not enough breathing room)
|
|
42
|
+
- Is the layout too sparse? (Excessive whitespace without purpose)
|
|
43
|
+
- Does density match the content type? (Data-dense UIs need tighter spacing; marketing pages need more air)
|
|
44
|
+
|
|
45
|
+
**CRITICAL**: Layout problems are often the root cause of interfaces feeling "off" even when colors and fonts are fine. Space is a design material — use it with intention.
|
|
46
|
+
|
|
47
|
+
## Plan Layout Improvements
|
|
48
|
+
|
|
49
|
+
Consult the [spatial design reference](reference/spatial-design.md) from the frontend-design skill for detailed guidance on grids, rhythm, and container queries.
|
|
50
|
+
|
|
51
|
+
Create a systematic plan:
|
|
52
|
+
|
|
53
|
+
- **Spacing system**: Use a consistent scale — whether that's a framework's built-in scale (e.g., Tailwind), rem-based tokens, or a custom system. The specific values matter less than consistency.
|
|
54
|
+
- **Hierarchy strategy**: How will space communicate importance?
|
|
55
|
+
- **Layout approach**: What structure fits the content? Flex for 1D, Grid for 2D, named areas for complex page layouts.
|
|
56
|
+
- **Rhythm**: Where should spacing be tight vs generous?
|
|
57
|
+
|
|
58
|
+
## Improve Layout Systematically
|
|
59
|
+
|
|
60
|
+
### Establish a Spacing System
|
|
61
|
+
|
|
62
|
+
- Use a consistent spacing scale — framework scales (Tailwind, etc.), rem-based tokens, or a custom scale all work. What matters is that values come from a defined set, not arbitrary numbers.
|
|
63
|
+
- Name tokens semantically if using custom properties: `--space-xs` through `--space-xl`, not `--spacing-8`
|
|
64
|
+
- Use `gap` for sibling spacing instead of margins — eliminates margin collapse hacks
|
|
65
|
+
- Apply `clamp()` for fluid spacing that breathes on larger screens
|
|
66
|
+
|
|
67
|
+
### Create Visual Rhythm
|
|
68
|
+
|
|
69
|
+
- **Tight grouping** for related elements (8-12px between siblings)
|
|
70
|
+
- **Generous separation** between distinct sections (48-96px)
|
|
71
|
+
- **Varied spacing** within sections — not every row needs the same gap
|
|
72
|
+
- **Asymmetric compositions** — break the predictable centered-content pattern when it makes sense
|
|
73
|
+
|
|
74
|
+
### Choose the Right Layout Tool
|
|
75
|
+
|
|
76
|
+
- **Use Flexbox for 1D layouts**: Rows of items, nav bars, button groups, card contents, most component internals. Flex is simpler and more appropriate for the majority of layout tasks.
|
|
77
|
+
- **Use Grid for 2D layouts**: Page-level structure, dashboards, data-dense interfaces, anything where rows AND columns need coordinated control.
|
|
78
|
+
- **Don't default to Grid** when Flexbox with `flex-wrap` would be simpler and more flexible.
|
|
79
|
+
- Use `repeat(auto-fit, minmax(280px, 1fr))` for responsive grids without breakpoints.
|
|
80
|
+
- Use named grid areas (`grid-template-areas`) for complex page layouts — redefine at breakpoints.
|
|
81
|
+
|
|
82
|
+
### Break Card Grid Monotony
|
|
83
|
+
|
|
84
|
+
- Don't default to card grids for everything — spacing and alignment create visual grouping naturally
|
|
85
|
+
- Use cards only when content is truly distinct and actionable — never nest cards inside cards
|
|
86
|
+
- Vary card sizes, span columns, or mix cards with non-card content to break repetition
|
|
87
|
+
|
|
88
|
+
### Strengthen Visual Hierarchy
|
|
89
|
+
|
|
90
|
+
- Use the fewest dimensions needed for clear hierarchy. Space alone can be enough — generous whitespace around an element draws the eye. Some of the most sophisticated designs achieve rhythm with just space and weight. Add color or size contrast only when simpler means aren't sufficient.
|
|
91
|
+
- Be aware of reading flow — in LTR languages, the eye naturally scans top-left to bottom-right, but primary action placement depends on context (e.g., bottom-right in dialogs, top in navigation).
|
|
92
|
+
- Create clear content groupings through proximity and separation.
|
|
93
|
+
|
|
94
|
+
### Manage Depth & Elevation
|
|
95
|
+
|
|
96
|
+
- Create a semantic z-index scale (dropdown → sticky → modal-backdrop → modal → toast → tooltip)
|
|
97
|
+
- Build a consistent shadow scale (sm → md → lg → xl) — shadows should be subtle
|
|
98
|
+
- Use elevation to reinforce hierarchy, not as decoration
|
|
99
|
+
|
|
100
|
+
### Optical Adjustments
|
|
101
|
+
|
|
102
|
+
- If an icon looks visually off-center despite being geometrically centered, nudge it — but only if you're confident it actually looks wrong. Don't adjust speculatively.
|
|
103
|
+
|
|
104
|
+
**NEVER**:
|
|
105
|
+
- Use arbitrary spacing values outside your scale
|
|
106
|
+
- Make all spacing equal — variety creates hierarchy
|
|
107
|
+
- Wrap everything in cards — not everything needs a container
|
|
108
|
+
- Nest cards inside cards — use spacing and dividers for hierarchy within
|
|
109
|
+
- Use identical card grids everywhere (icon + heading + text, repeated)
|
|
110
|
+
- Center everything — left-aligned with asymmetry feels more designed
|
|
111
|
+
- Default to the hero metric layout (big number, small label, stats, gradient) as a template. If showing real user data, a prominent metric can work — but it should display actual data, not decorative numbers.
|
|
112
|
+
- Default to CSS Grid when Flexbox would be simpler — use the simplest tool for the job
|
|
113
|
+
- Use arbitrary z-index values (999, 9999) — build a semantic scale
|
|
114
|
+
|
|
115
|
+
## Verify Layout Improvements
|
|
116
|
+
|
|
117
|
+
- **Squint test**: Can you identify primary, secondary, and groupings with blurred vision?
|
|
118
|
+
- **Rhythm**: Does the page have a satisfying beat of tight and generous spacing?
|
|
119
|
+
- **Hierarchy**: Is the most important content obvious within 2 seconds?
|
|
120
|
+
- **Breathing room**: Does the layout feel comfortable, not cramped or wasteful?
|
|
121
|
+
- **Consistency**: Is the spacing system applied uniformly?
|
|
122
|
+
- **Responsiveness**: Does the layout adapt gracefully across screen sizes?
|
|
123
|
+
|
|
124
|
+
Remember: Space is the most underused design tool. A layout with the right rhythm and hierarchy can make even simple content feel polished and intentional.
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: audit
|
|
3
|
+
description: "Run technical quality checks across accessibility, performance, theming, responsive design, and anti-patterns. Generates a scored report with P0-P3 severity ratings and actionable plan. Use when the user wants an accessibility check, performance audit, or technical quality review."
|
|
4
|
+
argument-hint: "[area (feature, page, component...)]"
|
|
5
|
+
user-invocable: true
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## MANDATORY PREPARATION
|
|
9
|
+
|
|
10
|
+
Invoke /frontend-design — it contains design principles, anti-patterns, and the **Context Gathering Protocol**. Follow the protocol before proceeding — if no design context exists yet, you MUST run /teach-impeccable first.
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
Run systematic **technical** quality checks and generate a comprehensive report. Don't fix issues — document them for other commands to address.
|
|
15
|
+
|
|
16
|
+
This is a code-level audit, not a design critique. Check what's measurable and verifiable in the implementation.
|
|
17
|
+
|
|
18
|
+
## Diagnostic Scan
|
|
19
|
+
|
|
20
|
+
Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the criteria below.
|
|
21
|
+
|
|
22
|
+
### 1. Accessibility (A11y)
|
|
23
|
+
|
|
24
|
+
**Check for**:
|
|
25
|
+
- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
|
|
26
|
+
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
|
|
27
|
+
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
|
|
28
|
+
- **Semantic HTML**: Improper heading hierarchy, missing landmarks, divs instead of buttons
|
|
29
|
+
- **Alt text**: Missing or poor image descriptions
|
|
30
|
+
- **Form issues**: Inputs without labels, poor error messaging, missing required indicators
|
|
31
|
+
|
|
32
|
+
**Score 0-4**: 0=Inaccessible (fails WCAG A), 1=Major gaps (few ARIA labels, no keyboard nav), 2=Partial (some a11y effort, significant gaps), 3=Good (WCAG AA mostly met, minor gaps), 4=Excellent (WCAG AA fully met, approaches AAA)
|
|
33
|
+
|
|
34
|
+
### 2. Performance
|
|
35
|
+
|
|
36
|
+
**Check for**:
|
|
37
|
+
- **Layout thrashing**: Reading/writing layout properties in loops
|
|
38
|
+
- **Expensive animations**: Animating layout properties (width, height, top, left) instead of transform/opacity
|
|
39
|
+
- **Missing optimization**: Images without lazy loading, unoptimized assets, missing will-change
|
|
40
|
+
- **Bundle size**: Unnecessary imports, unused dependencies
|
|
41
|
+
- **Render performance**: Unnecessary re-renders, missing memoization
|
|
42
|
+
|
|
43
|
+
**Score 0-4**: 0=Severe issues (layout thrash, unoptimized everything), 1=Major problems (no lazy loading, expensive animations), 2=Partial (some optimization, gaps remain), 3=Good (mostly optimized, minor improvements possible), 4=Excellent (fast, lean, well-optimized)
|
|
44
|
+
|
|
45
|
+
### 3. Theming
|
|
46
|
+
|
|
47
|
+
**Check for**:
|
|
48
|
+
- **Hard-coded colors**: Colors not using design tokens
|
|
49
|
+
- **Broken dark mode**: Missing dark mode variants, poor contrast in dark theme
|
|
50
|
+
- **Inconsistent tokens**: Using wrong tokens, mixing token types
|
|
51
|
+
- **Theme switching issues**: Values that don't update on theme change
|
|
52
|
+
|
|
53
|
+
**Score 0-4**: 0=No theming (hard-coded everything), 1=Minimal tokens (mostly hard-coded), 2=Partial (tokens exist but inconsistently used), 3=Good (tokens used, minor hard-coded values), 4=Excellent (full token system, dark mode works perfectly)
|
|
54
|
+
|
|
55
|
+
### 4. Responsive Design
|
|
56
|
+
|
|
57
|
+
**Check for**:
|
|
58
|
+
- **Fixed widths**: Hard-coded widths that break on mobile
|
|
59
|
+
- **Touch targets**: Interactive elements < 44x44px
|
|
60
|
+
- **Horizontal scroll**: Content overflow on narrow viewports
|
|
61
|
+
- **Text scaling**: Layouts that break when text size increases
|
|
62
|
+
- **Missing breakpoints**: No mobile/tablet variants
|
|
63
|
+
|
|
64
|
+
**Score 0-4**: 0=Desktop-only (breaks on mobile), 1=Major issues (some breakpoints, many failures), 2=Partial (works on mobile, rough edges), 3=Good (responsive, minor touch target or overflow issues), 4=Excellent (fluid, all viewports, proper touch targets)
|
|
65
|
+
|
|
66
|
+
### 5. Anti-Patterns (CRITICAL)
|
|
67
|
+
|
|
68
|
+
Check against ALL the **DON'T** guidelines in the frontend-design skill. Look for AI slop tells (AI color palette, gradient text, glassmorphism, hero metrics, card grids, generic fonts) and general design anti-patterns (gray on color, nested cards, bounce easing, redundant copy).
|
|
69
|
+
|
|
70
|
+
**Score 0-4**: 0=AI slop gallery (5+ tells), 1=Heavy AI aesthetic (3-4 tells), 2=Some tells (1-2 noticeable), 3=Mostly clean (subtle issues only), 4=No AI tells (distinctive, intentional design)
|
|
71
|
+
|
|
72
|
+
## Generate Report
|
|
73
|
+
|
|
74
|
+
### Audit Health Score
|
|
75
|
+
|
|
76
|
+
| # | Dimension | Score | Key Finding |
|
|
77
|
+
|---|-----------|-------|-------------|
|
|
78
|
+
| 1 | Accessibility | ? | [most critical a11y issue or "--"] |
|
|
79
|
+
| 2 | Performance | ? | |
|
|
80
|
+
| 3 | Responsive Design | ? | |
|
|
81
|
+
| 4 | Theming | ? | |
|
|
82
|
+
| 5 | Anti-Patterns | ? | |
|
|
83
|
+
| **Total** | | **??/20** | **[Rating band]** |
|
|
84
|
+
|
|
85
|
+
**Rating bands**: 18-20 Excellent (minor polish), 14-17 Good (address weak dimensions), 10-13 Acceptable (significant work needed), 6-9 Poor (major overhaul), 0-5 Critical (fundamental issues)
|
|
86
|
+
|
|
87
|
+
### Anti-Patterns Verdict
|
|
88
|
+
**Start here.** Pass/fail: Does this look AI-generated? List specific tells. Be brutally honest.
|
|
89
|
+
|
|
90
|
+
### Executive Summary
|
|
91
|
+
- Audit Health Score: **??/20** ([rating band])
|
|
92
|
+
- Total issues found (count by severity: P0/P1/P2/P3)
|
|
93
|
+
- Top 3-5 critical issues
|
|
94
|
+
- Recommended next steps
|
|
95
|
+
|
|
96
|
+
### Detailed Findings by Severity
|
|
97
|
+
|
|
98
|
+
Tag every issue with **P0-P3 severity**:
|
|
99
|
+
- **P0 Blocking**: Prevents task completion — fix immediately
|
|
100
|
+
- **P1 Major**: Significant difficulty or WCAG AA violation — fix before release
|
|
101
|
+
- **P2 Minor**: Annoyance, workaround exists — fix in next pass
|
|
102
|
+
- **P3 Polish**: Nice-to-fix, no real user impact — fix if time permits
|
|
103
|
+
|
|
104
|
+
For each issue, document:
|
|
105
|
+
- **[P?] Issue name**
|
|
106
|
+
- **Location**: Component, file, line
|
|
107
|
+
- **Category**: Accessibility / Performance / Theming / Responsive / Anti-Pattern
|
|
108
|
+
- **Impact**: How it affects users
|
|
109
|
+
- **WCAG/Standard**: Which standard it violates (if applicable)
|
|
110
|
+
- **Recommendation**: How to fix it
|
|
111
|
+
- **Suggested command**: Which command to use (prefer: /audit, /critique, /normalize, /polish, /distill, /clarify, /optimize, /harden, /animate, /colorize, /bolder, /quieter, /delight, /extract, /adapt, /onboard, /typeset, /arrange, /overdrive, /teach-impeccable)
|
|
112
|
+
|
|
113
|
+
### Patterns & Systemic Issues
|
|
114
|
+
|
|
115
|
+
Identify recurring problems that indicate systemic gaps rather than one-off mistakes:
|
|
116
|
+
- "Hard-coded colors appear in 15+ components, should use design tokens"
|
|
117
|
+
- "Touch targets consistently too small (<44px) throughout mobile experience"
|
|
118
|
+
|
|
119
|
+
### Positive Findings
|
|
120
|
+
|
|
121
|
+
Note what's working well — good practices to maintain and replicate.
|
|
122
|
+
|
|
123
|
+
## Recommended Actions
|
|
124
|
+
|
|
125
|
+
List recommended commands in priority order (P0 first, then P1, then P2):
|
|
126
|
+
|
|
127
|
+
1. **[P?] `/command-name`** — Brief description (specific context from audit findings)
|
|
128
|
+
2. **[P?] `/command-name`** — Brief description (specific context)
|
|
129
|
+
|
|
130
|
+
**Rules**: Only recommend commands from: /audit, /critique, /normalize, /polish, /distill, /clarify, /optimize, /harden, /animate, /colorize, /bolder, /quieter, /delight, /extract, /adapt, /onboard, /typeset, /arrange, /overdrive, /teach-impeccable. Map findings to the most appropriate command. End with `/polish` as the final step if any fixes were recommended.
|
|
131
|
+
|
|
132
|
+
After presenting the summary, tell the user:
|
|
133
|
+
|
|
134
|
+
> You can ask me to run these one at a time, all at once, or in any order you prefer.
|
|
135
|
+
>
|
|
136
|
+
> Re-run `/audit` after fixes to see your score improve.
|
|
137
|
+
|
|
138
|
+
**IMPORTANT**: Be thorough but actionable. Too many P3 issues creates noise. Focus on what actually matters.
|
|
139
|
+
|
|
140
|
+
**NEVER**:
|
|
141
|
+
- Report issues without explaining impact (why does this matter?)
|
|
142
|
+
- Provide generic recommendations (be specific and actionable)
|
|
143
|
+
- Skip positive findings (celebrate what works)
|
|
144
|
+
- Forget to prioritize (everything can't be P0)
|
|
145
|
+
- Report false positives without verification
|
|
146
|
+
|
|
147
|
+
Remember: You're a technical quality auditor. Document systematically, prioritize ruthlessly, cite specific code locations, and provide clear paths to improvement.
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: bolder
|
|
3
|
+
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."
|
|
4
|
+
argument-hint: "[target]"
|
|
5
|
+
user-invocable: true
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
Increase visual impact and personality in designs that are too safe, generic, or visually underwhelming, creating more engaging and memorable experiences.
|
|
9
|
+
|
|
10
|
+
## MANDATORY PREPARATION
|
|
11
|
+
|
|
12
|
+
Invoke /frontend-design — it contains design principles, anti-patterns, and the **Context Gathering Protocol**. Follow the protocol before proceeding — if no design context exists yet, you MUST run /teach-impeccable first.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Assess Current State
|
|
17
|
+
|
|
18
|
+
Analyze what makes the design feel too safe or boring:
|
|
19
|
+
|
|
20
|
+
1. **Identify weakness sources**:
|
|
21
|
+
- **Generic choices**: System fonts, basic colors, standard layouts
|
|
22
|
+
- **Timid scale**: Everything is medium-sized with no drama
|
|
23
|
+
- **Low contrast**: Everything has similar visual weight
|
|
24
|
+
- **Static**: No motion, no energy, no life
|
|
25
|
+
- **Predictable**: Standard patterns with no surprises
|
|
26
|
+
- **Flat hierarchy**: Nothing stands out or commands attention
|
|
27
|
+
|
|
28
|
+
2. **Understand the context**:
|
|
29
|
+
- What's the brand personality? (How far can we push?)
|
|
30
|
+
- What's the purpose? (Marketing can be bolder than financial dashboards)
|
|
31
|
+
- Who's the audience? (What will resonate?)
|
|
32
|
+
- What are the constraints? (Brand guidelines, accessibility, performance)
|
|
33
|
+
|
|
34
|
+
If any of these are unclear from the codebase, Ask the user using AskUserQuestion.
|
|
35
|
+
|
|
36
|
+
**CRITICAL**: "Bolder" doesn't mean chaotic or garish. It means distinctive, memorable, and confident. Think intentional drama, not random chaos.
|
|
37
|
+
|
|
38
|
+
**WARNING - AI SLOP TRAP**: When making things "bolder," AI defaults to the same tired tricks: cyan/purple gradients, glassmorphism, neon accents on dark backgrounds, gradient text on metrics. These are the OPPOSITE of bold—they're generic. Review ALL the DON'T guidelines in the frontend-design skill before proceeding. Bold means distinctive, not "more effects."
|
|
39
|
+
|
|
40
|
+
## Plan Amplification
|
|
41
|
+
|
|
42
|
+
Create a strategy to increase impact while maintaining coherence:
|
|
43
|
+
|
|
44
|
+
- **Focal point**: What should be the hero moment? (Pick ONE, make it amazing)
|
|
45
|
+
- **Personality direction**: Maximalist chaos? Elegant drama? Playful energy? Dark moody? Choose a lane.
|
|
46
|
+
- **Risk budget**: How experimental can we be? Push boundaries within constraints.
|
|
47
|
+
- **Hierarchy amplification**: Make big things BIGGER, small things smaller (increase contrast)
|
|
48
|
+
|
|
49
|
+
**IMPORTANT**: Bold design must still be usable. Impact without function is just decoration.
|
|
50
|
+
|
|
51
|
+
## Amplify the Design
|
|
52
|
+
|
|
53
|
+
Systematically increase impact across these dimensions:
|
|
54
|
+
|
|
55
|
+
### Typography Amplification
|
|
56
|
+
- **Replace generic fonts**: Swap system fonts for distinctive choices (see frontend-design skill for inspiration)
|
|
57
|
+
- **Extreme scale**: Create dramatic size jumps (3x-5x differences, not 1.5x)
|
|
58
|
+
- **Weight contrast**: Pair 900 weights with 200 weights, not 600 with 400
|
|
59
|
+
- **Unexpected choices**: Variable fonts, display fonts for headlines, condensed/extended widths, monospace as intentional accent (not as lazy "dev tool" default)
|
|
60
|
+
|
|
61
|
+
### Color Intensification
|
|
62
|
+
- **Increase saturation**: Shift to more vibrant, energetic colors (but not neon)
|
|
63
|
+
- **Bold palette**: Introduce unexpected color combinations—avoid the purple-blue gradient AI slop
|
|
64
|
+
- **Dominant color strategy**: Let one bold color own 60% of the design
|
|
65
|
+
- **Sharp accents**: High-contrast accent colors that pop
|
|
66
|
+
- **Tinted neutrals**: Replace pure grays with tinted grays that harmonize with your palette
|
|
67
|
+
- **Rich gradients**: Intentional multi-stop gradients (not generic purple-to-blue)
|
|
68
|
+
|
|
69
|
+
### Spatial Drama
|
|
70
|
+
- **Extreme scale jumps**: Make important elements 3-5x larger than surroundings
|
|
71
|
+
- **Break the grid**: Let hero elements escape containers and cross boundaries
|
|
72
|
+
- **Asymmetric layouts**: Replace centered, balanced layouts with tension-filled asymmetry
|
|
73
|
+
- **Generous space**: Use white space dramatically (100-200px gaps, not 20-40px)
|
|
74
|
+
- **Overlap**: Layer elements intentionally for depth
|
|
75
|
+
|
|
76
|
+
### Visual Effects
|
|
77
|
+
- **Dramatic shadows**: Large, soft shadows for elevation (but not generic drop shadows on rounded rectangles)
|
|
78
|
+
- **Background treatments**: Mesh patterns, noise textures, geometric patterns, intentional gradients (not purple-to-blue)
|
|
79
|
+
- **Texture & depth**: Grain, halftone, duotone, layered elements—NOT glassmorphism (it's overused AI slop)
|
|
80
|
+
- **Borders & frames**: Thick borders, decorative frames, custom shapes (not rounded rectangles with colored border on one side)
|
|
81
|
+
- **Custom elements**: Illustrative elements, custom icons, decorative details that reinforce brand
|
|
82
|
+
|
|
83
|
+
### Motion & Animation
|
|
84
|
+
- **Entrance choreography**: Staggered, dramatic page load animations with 50-100ms delays
|
|
85
|
+
- **Scroll effects**: Parallax, reveal animations, scroll-triggered sequences
|
|
86
|
+
- **Micro-interactions**: Satisfying hover effects, click feedback, state changes
|
|
87
|
+
- **Transitions**: Smooth, noticeable transitions using ease-out-quart/quint/expo (not bounce or elastic—they cheapen the effect)
|
|
88
|
+
|
|
89
|
+
### Composition Boldness
|
|
90
|
+
- **Hero moments**: Create clear focal points with dramatic treatment
|
|
91
|
+
- **Diagonal flows**: Escape horizontal/vertical rigidity with diagonal arrangements
|
|
92
|
+
- **Full-bleed elements**: Use full viewport width/height for impact
|
|
93
|
+
- **Unexpected proportions**: Golden ratio? Throw it out. Try 70/30, 80/20 splits
|
|
94
|
+
|
|
95
|
+
**NEVER**:
|
|
96
|
+
- Add effects randomly without purpose (chaos ≠ bold)
|
|
97
|
+
- Sacrifice readability for aesthetics (body text must be readable)
|
|
98
|
+
- Make everything bold (then nothing is bold - need contrast)
|
|
99
|
+
- Ignore accessibility (bold design must still meet WCAG standards)
|
|
100
|
+
- Overwhelm with motion (animation fatigue is real)
|
|
101
|
+
- Copy trendy aesthetics blindly (bold means distinctive, not derivative)
|
|
102
|
+
|
|
103
|
+
## Verify Quality
|
|
104
|
+
|
|
105
|
+
Ensure amplification maintains usability and coherence:
|
|
106
|
+
|
|
107
|
+
- **NOT AI slop**: Does this look like every other AI-generated "bold" design? If yes, start over.
|
|
108
|
+
- **Still functional**: Can users accomplish tasks without distraction?
|
|
109
|
+
- **Coherent**: Does everything feel intentional and unified?
|
|
110
|
+
- **Memorable**: Will users remember this experience?
|
|
111
|
+
- **Performant**: Do all these effects run smoothly?
|
|
112
|
+
- **Accessible**: Does it still meet accessibility standards?
|
|
113
|
+
|
|
114
|
+
**The test**: If you showed this to someone and said "AI made this bolder," would they believe you immediately? If yes, you've failed. Bold means distinctive, not "more AI effects."
|
|
115
|
+
|
|
116
|
+
Remember: Bold design is confident design. It takes risks, makes statements, and creates memorable experiences. But bold without strategy is just loud. Be intentional, be dramatic, be unforgettable.
|