@nano-step/skill-manager 5.1.0 β†’ 5.2.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.
Files changed (61) hide show
  1. package/dist/utils.d.ts +1 -1
  2. package/dist/utils.js +1 -1
  3. package/package.json +1 -1
  4. package/skills/blog-workflow/SKILL.md +522 -0
  5. package/skills/blog-workflow/skill.json +16 -0
  6. package/skills/comprehensive-feature-builder/SKILL.md +558 -0
  7. package/skills/comprehensive-feature-builder/skill.json +9 -0
  8. package/skills/idea-workflow/SKILL.md +229 -0
  9. package/skills/idea-workflow/skill.json +14 -0
  10. package/skills/reddit-workflow/SKILL.md +187 -0
  11. package/skills/reddit-workflow/skill.json +14 -0
  12. package/skills/security-workflow/SKILL.md +258 -0
  13. package/skills/security-workflow/skill.json +15 -0
  14. package/skills/skill-creator/LICENSE.txt +202 -0
  15. package/skills/skill-creator/SKILL.md +309 -0
  16. package/skills/skill-creator/references/metadata-quality-criteria.md +76 -0
  17. package/skills/skill-creator/references/plugin-marketplace-hosting.md +101 -0
  18. package/skills/skill-creator/references/plugin-marketplace-overview.md +55 -0
  19. package/skills/skill-creator/references/plugin-marketplace-schema.md +88 -0
  20. package/skills/skill-creator/references/plugin-marketplace-sources.md +103 -0
  21. package/skills/skill-creator/references/plugin-marketplace-troubleshooting.md +80 -0
  22. package/skills/skill-creator/references/script-quality-criteria.md +106 -0
  23. package/skills/skill-creator/references/structure-organization-criteria.md +114 -0
  24. package/skills/skill-creator/references/token-efficiency-criteria.md +74 -0
  25. package/skills/skill-creator/references/validation-checklist.md +83 -0
  26. package/skills/skill-creator/scripts/encoding_utils.py +36 -0
  27. package/skills/skill-creator/scripts/init_skill.py +308 -0
  28. package/skills/skill-creator/scripts/package_skill.py +115 -0
  29. package/skills/skill-creator/scripts/quick_validate.py +69 -0
  30. package/skills/skill-creator/skill.json +14 -0
  31. package/skills/team-workflow/SKILL.md +227 -0
  32. package/skills/team-workflow/skill.json +15 -0
  33. package/skills/ui-ux-pro-max/SKILL.md +292 -0
  34. package/skills/ui-ux-pro-max/data/charts.csv +26 -0
  35. package/skills/ui-ux-pro-max/data/colors.csv +97 -0
  36. package/skills/ui-ux-pro-max/data/icons.csv +101 -0
  37. package/skills/ui-ux-pro-max/data/landing.csv +31 -0
  38. package/skills/ui-ux-pro-max/data/products.csv +97 -0
  39. package/skills/ui-ux-pro-max/data/react-performance.csv +45 -0
  40. package/skills/ui-ux-pro-max/data/stacks/astro.csv +54 -0
  41. package/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  42. package/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  43. package/skills/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
  44. package/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  45. package/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
  46. package/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
  47. package/skills/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  48. package/skills/ui-ux-pro-max/data/stacks/react.csv +54 -0
  49. package/skills/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
  50. package/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  51. package/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  52. package/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  53. package/skills/ui-ux-pro-max/data/styles.csv +68 -0
  54. package/skills/ui-ux-pro-max/data/typography.csv +58 -0
  55. package/skills/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
  56. package/skills/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  57. package/skills/ui-ux-pro-max/data/web-interface.csv +31 -0
  58. package/skills/ui-ux-pro-max/scripts/core.py +253 -0
  59. package/skills/ui-ux-pro-max/scripts/design_system.py +1067 -0
  60. package/skills/ui-ux-pro-max/scripts/search.py +114 -0
  61. package/skills/ui-ux-pro-max/skill.json +16 -0
@@ -0,0 +1,14 @@
1
+ {
2
+ "name": "skill-creator",
3
+ "version": "1.0.0",
4
+ "description": "Create and validate AI agent skills with progressive disclosure, bundled scripts, and marketplace packaging",
5
+ "compatibility": "OpenCode",
6
+ "agent": null,
7
+ "commands": [],
8
+ "tags": [
9
+ "skill",
10
+ "creator",
11
+ "validation",
12
+ "packaging"
13
+ ]
14
+ }
@@ -0,0 +1,227 @@
1
+ ---
2
+ description: Simulate an autonomous software team analyzing a feature/idea β€” produces architecture, execution plan, QA strategy, and timeline
3
+ ---
4
+
5
+ Simulate a full autonomous software team discussion and planning session. When invoked, analyze the input as a real engineering team preparing for production deployment.
6
+
7
+ **Default language**: Vietnamese (output). Switch to English if user explicitly requests.
8
+
9
+ **Input**: The argument after `/team` is either:
10
+ - A feature idea or requirement from the Product Owner
11
+ - A technical problem or improvement request
12
+ - A free-form description of what needs to be built
13
+
14
+ If the input is vague, ask ONE clarifying question before proceeding. Do NOT ask multiple rounds of questions.
15
+
16
+ ---
17
+
18
+ ## Team Structure
19
+
20
+ You simulate ALL roles internally. Each role has a distinct perspective and responsibility:
21
+
22
+ ### Tech Lead (You β€” final technical authority)
23
+ - Reviews architecture and technical decisions
24
+ - Evaluates output quality from the team
25
+ - Makes the final technical call
26
+ - Ensures engineering standards
27
+
28
+ ### 3 Senior Software Engineers (You β€” simulated)
29
+ - Design and implement systems
30
+ - Propose **multiple** technical approaches (minimum 2)
31
+ - Analyze trade-offs between options
32
+ - Focus on code quality, performance, architecture
33
+
34
+ ### Senior QA Engineer (You β€” simulated)
35
+ - Designs test strategy and regression plans
36
+ - Provides **adversarial feedback** β€” challenges assumptions
37
+ - Identifies edge cases, failure modes, and risks
38
+ - Never rubber-stamps β€” always finds something to question
39
+
40
+ ### Product Owner (The User)
41
+ - Provides the idea/requirement
42
+ - Defines business direction
43
+ - Sets product goals
44
+
45
+ ### Product Manager (You β€” dual role with Tech Lead)
46
+ - Creates roadmap from the requirement
47
+ - Manages scope and prioritization
48
+ - Balances business needs vs engineering constraints
49
+ - Estimates timelines realistically
50
+
51
+ ---
52
+
53
+ ## Workflow (executed sequentially)
54
+
55
+ ### PHASE 1 β€” Requirement Breakdown
56
+
57
+ **PO Perspective (extract from user input):**
58
+ - Business objective β€” what problem does this solve?
59
+ - Success metrics β€” how do we measure it worked?
60
+ - User impact β€” who benefits and how?
61
+
62
+ **PM Perspective (you derive):**
63
+ - Scope definition β€” what's in, what's out
64
+ - Risk level β€” Low / Medium / High (with reasoning)
65
+ - Complexity estimate β€” S / M / L / XL (with reasoning)
66
+
67
+ ### PHASE 2 β€” Technical Analysis (Internal Team Discussion)
68
+
69
+ **MANDATORY requirements:**
70
+ - **Minimum 2 technical approaches** (Option A, Option B, optionally C)
71
+ - Each option must include: approach description, pros, cons
72
+ - **Trade-off analysis** across these dimensions:
73
+ - Performance
74
+ - Scalability
75
+ - Security
76
+ - Maintainability
77
+ - Development speed
78
+ - **QA adversarial review** β€” the QA Engineer MUST challenge at least 1 assumption or identify at least 2 risks
79
+ - **Tech Lead synthesis** β€” summarize discussion, select recommended approach with clear reasoning
80
+
81
+ **TEAM RULES for this phase:**
82
+ - No instant agreement β€” there must be visible tension/trade-offs between options
83
+ - No vague statements β€” every claim must have a concrete reason
84
+ - Prioritize: Performance > Security > Maintainability > Speed
85
+
86
+ ### PHASE 3 β€” Execution Plan
87
+
88
+ Produce ALL of the following:
89
+
90
+ **1. Architecture Overview**
91
+ - High-level system flow (use ASCII diagrams when helpful)
92
+ - System components and their responsibilities
93
+ - Integration points with existing systems
94
+ - Data flow
95
+
96
+ **2. Implementation Plan**
97
+ - Break into Epics (large deliverables)
98
+ - Break Epics into Tasks (actionable work items)
99
+ - Assign each task to a role (Senior Eng 1/2/3, QA, Tech Lead)
100
+ - Mark dependencies between tasks
101
+
102
+ **3. QA Strategy**
103
+ - Test plan (unit, integration, e2e)
104
+ - Regression strategy
105
+ - Edge case checklist
106
+ - Performance testing approach (if applicable)
107
+
108
+ **4. Timeline & Sprint Plan**
109
+ - Sprint breakdown (1 sprint = 2 weeks default, adjust if user specifies)
110
+ - Milestones with acceptance criteria
111
+ - Risk buffer allocation (recommend 15-20% buffer)
112
+
113
+ ### PHASE 4 β€” Final Decision Summary
114
+
115
+ - **Selected approach** and why (1-3 sentences)
116
+ - **Remaining risks** that the team accepts
117
+ - **Production-readiness conditions** β€” what must be true before shipping
118
+ - **Open questions** for the PO (if any)
119
+
120
+ ---
121
+
122
+ ## Output Format (MANDATORY β€” follow exactly)
123
+
124
+ ```
125
+ ## Input
126
+ <Requirement from PO β€” quoted or paraphrased>
127
+
128
+ ---
129
+
130
+ ## Team Analysis
131
+
132
+ ### 1. Product & Business View (PO + PM)
133
+ **Business Objective:** ...
134
+ **Success Metrics:** ...
135
+ **User Impact:** ...
136
+ **Scope:** In: ... | Out: ...
137
+ **Risk Level:** [Low/Medium/High] β€” ...
138
+ **Complexity:** [S/M/L/XL] β€” ...
139
+
140
+ ### 2. Engineering Discussion
141
+
142
+ **Option A: [Name]**
143
+ - Approach: ...
144
+ - Pros: ...
145
+ - Cons: ...
146
+
147
+ **Option B: [Name]**
148
+ - Approach: ...
149
+ - Pros: ...
150
+ - Cons: ...
151
+
152
+ **Trade-off Matrix:**
153
+ | Dimension | Option A | Option B |
154
+ |-----------|----------|----------|
155
+ | Performance | ... | ... |
156
+ | Scalability | ... | ... |
157
+ | Security | ... | ... |
158
+ | Maintainability | ... | ... |
159
+ | Dev Speed | ... | ... |
160
+
161
+ ### 3. QA Risk Assessment
162
+ - **Challenged assumption:** ...
163
+ - **Risk 1:** ...
164
+ - **Risk 2:** ...
165
+ - **Edge cases:** ...
166
+
167
+ ### 4. Tech Lead Decision
168
+ **Selected:** [Option X]
169
+ **Reasoning:** ...
170
+
171
+ ---
172
+
173
+ ## Execution Plan
174
+
175
+ ### Architecture
176
+ [ASCII diagram or description]
177
+
178
+ ### Task Breakdown
179
+ | Epic | Task | Owner | Dependency | Estimate |
180
+ |------|------|-------|------------|----------|
181
+ | ... | ... | ... | ... | ... |
182
+
183
+ ### QA Strategy
184
+ - **Unit tests:** ...
185
+ - **Integration tests:** ...
186
+ - **E2E tests:** ...
187
+ - **Regression:** ...
188
+ - **Edge cases:** ...
189
+
190
+ ### Timeline
191
+ | Sprint | Goals | Milestone |
192
+ |--------|-------|-----------|
193
+ | Sprint 1 | ... | ... |
194
+ | Sprint 2 | ... | ... |
195
+ | Buffer | 15-20% | Risk mitigation |
196
+
197
+ ---
198
+
199
+ ## Risk & Mitigation
200
+ | Risk | Impact | Likelihood | Mitigation |
201
+ |------|--------|------------|------------|
202
+ | ... | ... | ... | ... |
203
+
204
+ ---
205
+
206
+ ## Final Recommendation
207
+ **Approach:** ...
208
+ **Production-ready when:** ...
209
+ **Open questions for PO:** ...
210
+ ```
211
+
212
+ ---
213
+
214
+ ## Guardrails
215
+
216
+ - **NEVER** give vague or generic answers β€” every statement must be grounded in the specific requirement
217
+ - **NEVER** skip the trade-off analysis β€” minimum 2 options with clear pros/cons
218
+ - **NEVER** let QA rubber-stamp β€” QA must always challenge something
219
+ - **NEVER** skip any phase or output section
220
+ - **ALWAYS** prioritize: Performance > Security > Maintainability > Speed
221
+ - **ALWAYS** include risk buffer in timeline (15-20%)
222
+ - **ALWAYS** assign tasks to specific roles
223
+ - **ALWAYS** output in the mandatory format above
224
+ - **ALWAYS** use Vietnamese as default output language (switch to English only if user requests)
225
+ - If the requirement is too large, suggest splitting into multiple `/team` sessions by domain
226
+ - If the requirement is too vague, ask ONE clarifying question β€” then proceed with reasonable assumptions
227
+ - Treat every analysis as if the team is preparing for **real production deployment**
@@ -0,0 +1,15 @@
1
+ {
2
+ "name": "team-workflow",
3
+ "version": "1.0.0",
4
+ "description": "Simulate an autonomous software team analyzing a feature \u2014 produces architecture, execution plan, QA strategy, and timeline",
5
+ "compatibility": "OpenCode",
6
+ "agent": null,
7
+ "commands": [],
8
+ "tags": [
9
+ "team",
10
+ "planning",
11
+ "architecture",
12
+ "qa",
13
+ "simulation"
14
+ ]
15
+ }
@@ -0,0 +1,292 @@
1
+ ---
2
+ name: ui-ux-pro-max
3
+ description: UI/UX design intelligence with searchable database
4
+ ---
5
+ # ui-ux-pro-max
6
+
7
+ Comprehensive design guide for web and mobile applications. Contains 67 styles, 96 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 13 technology stacks. Searchable database with priority-based recommendations.
8
+
9
+ ## Prerequisites
10
+
11
+ Check if Python is installed:
12
+
13
+ ```bash
14
+ python3 --version || python --version
15
+ ```
16
+
17
+ If Python is not installed, install it based on user's OS:
18
+
19
+ **macOS:**
20
+ ```bash
21
+ brew install python3
22
+ ```
23
+
24
+ **Ubuntu/Debian:**
25
+ ```bash
26
+ sudo apt update && sudo apt install python3
27
+ ```
28
+
29
+ **Windows:**
30
+ ```powershell
31
+ winget install Python.Python.3.12
32
+ ```
33
+
34
+ ---
35
+
36
+ ## How to Use This Skill
37
+
38
+ When user requests UI/UX work (design, build, create, implement, review, fix, improve), follow this workflow:
39
+
40
+ ### Step 1: Analyze User Requirements
41
+
42
+ Extract key information from user request:
43
+ - **Product type**: SaaS, e-commerce, portfolio, dashboard, landing page, etc.
44
+ - **Style keywords**: minimal, playful, professional, elegant, dark mode, etc.
45
+ - **Industry**: healthcare, fintech, gaming, education, etc.
46
+ - **Stack**: React, Vue, Next.js, or default to `html-tailwind`
47
+
48
+ ### Step 2: Generate Design System (REQUIRED)
49
+
50
+ **Always start with `--design-system`** to get comprehensive recommendations with reasoning:
51
+
52
+ ```bash
53
+ python3 skills/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
54
+ ```
55
+
56
+ This command:
57
+ 1. Searches 5 domains in parallel (product, style, color, landing, typography)
58
+ 2. Applies reasoning rules from `ui-reasoning.csv` to select best matches
59
+ 3. Returns complete design system: pattern, style, colors, typography, effects
60
+ 4. Includes anti-patterns to avoid
61
+
62
+ **Example:**
63
+ ```bash
64
+ python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"
65
+ ```
66
+
67
+ ### Step 2b: Persist Design System (Master + Overrides Pattern)
68
+
69
+ To save the design system for hierarchical retrieval across sessions, add `--persist`:
70
+
71
+ ```bash
72
+ python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name"
73
+ ```
74
+
75
+ This creates:
76
+ - `design-system/MASTER.md` β€” Global Source of Truth with all design rules
77
+ - `design-system/pages/` β€” Folder for page-specific overrides
78
+
79
+ **With page-specific override:**
80
+ ```bash
81
+ python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name" --page "dashboard"
82
+ ```
83
+
84
+ This also creates:
85
+ - `design-system/pages/dashboard.md` β€” Page-specific deviations from Master
86
+
87
+ **How hierarchical retrieval works:**
88
+ 1. When building a specific page (e.g., "Checkout"), first check `design-system/pages/checkout.md`
89
+ 2. If the page file exists, its rules **override** the Master file
90
+ 3. If not, use `design-system/MASTER.md` exclusively
91
+
92
+ ### Step 3: Supplement with Detailed Searches (as needed)
93
+
94
+ After getting the design system, use domain searches to get additional details:
95
+
96
+ ```bash
97
+ python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
98
+ ```
99
+
100
+ **When to use detailed searches:**
101
+
102
+ | Need | Domain | Example |
103
+ |------|--------|---------|
104
+ | More style options | `style` | `--domain style "glassmorphism dark"` |
105
+ | Chart recommendations | `chart` | `--domain chart "real-time dashboard"` |
106
+ | UX best practices | `ux` | `--domain ux "animation accessibility"` |
107
+ | Alternative fonts | `typography` | `--domain typography "elegant luxury"` |
108
+ | Landing structure | `landing` | `--domain landing "hero social-proof"` |
109
+
110
+ ### Step 4: Stack Guidelines (Default: html-tailwind)
111
+
112
+ Get implementation-specific best practices. If user doesn't specify a stack, **default to `html-tailwind`**.
113
+
114
+ ```bash
115
+ python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwind
116
+ ```
117
+
118
+ Available stacks: `html-tailwind`, `react`, `nextjs`, `vue`, `svelte`, `swiftui`, `react-native`, `flutter`, `shadcn`, `jetpack-compose`
119
+
120
+ ---
121
+
122
+ ## Search Reference
123
+
124
+ ### Available Domains
125
+
126
+ | Domain | Use For | Example Keywords |
127
+ |--------|---------|------------------|
128
+ | `product` | Product type recommendations | SaaS, e-commerce, portfolio, healthcare, beauty, service |
129
+ | `style` | UI styles, colors, effects | glassmorphism, minimalism, dark mode, brutalism |
130
+ | `typography` | Font pairings, Google Fonts | elegant, playful, professional, modern |
131
+ | `color` | Color palettes by product type | saas, ecommerce, healthcare, beauty, fintech, service |
132
+ | `landing` | Page structure, CTA strategies | hero, hero-centric, testimonial, pricing, social-proof |
133
+ | `chart` | Chart types, library recommendations | trend, comparison, timeline, funnel, pie |
134
+ | `ux` | Best practices, anti-patterns | animation, accessibility, z-index, loading |
135
+ | `react` | React/Next.js performance | waterfall, bundle, suspense, memo, rerender, cache |
136
+ | `web` | Web interface guidelines | aria, focus, keyboard, semantic, virtualize |
137
+ | `prompt` | AI prompts, CSS keywords | (style name) |
138
+
139
+ ### Available Stacks
140
+
141
+ | Stack | Focus |
142
+ |-------|-------|
143
+ | `html-tailwind` | Tailwind utilities, responsive, a11y (DEFAULT) |
144
+ | `react` | State, hooks, performance, patterns |
145
+ | `nextjs` | SSR, routing, images, API routes |
146
+ | `vue` | Composition API, Pinia, Vue Router |
147
+ | `svelte` | Runes, stores, SvelteKit |
148
+ | `swiftui` | Views, State, Navigation, Animation |
149
+ | `react-native` | Components, Navigation, Lists |
150
+ | `flutter` | Widgets, State, Layout, Theming |
151
+ | `shadcn` | shadcn/ui components, theming, forms, patterns |
152
+ | `jetpack-compose` | Composables, Modifiers, State Hoisting, Recomposition |
153
+
154
+ ---
155
+
156
+ ## Example Workflow
157
+
158
+ **User request:** "LΓ m landing page cho dα»‹ch vα»₯ chΔƒm sΓ³c da chuyΓͺn nghiệp"
159
+
160
+ ### Step 1: Analyze Requirements
161
+ - Product type: Beauty/Spa service
162
+ - Style keywords: elegant, professional, soft
163
+ - Industry: Beauty/Wellness
164
+ - Stack: html-tailwind (default)
165
+
166
+ ### Step 2: Generate Design System (REQUIRED)
167
+
168
+ ```bash
169
+ python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"
170
+ ```
171
+
172
+ **Output:** Complete design system with pattern, style, colors, typography, effects, and anti-patterns.
173
+
174
+ ### Step 3: Supplement with Detailed Searches (as needed)
175
+
176
+ ```bash
177
+ # Get UX guidelines for animation and accessibility
178
+ python3 skills/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux
179
+
180
+ # Get alternative typography options if needed
181
+ python3 skills/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography
182
+ ```
183
+
184
+ ### Step 4: Stack Guidelines
185
+
186
+ ```bash
187
+ python3 skills/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind
188
+ ```
189
+
190
+ **Then:** Synthesize design system + detailed searches and implement the design.
191
+
192
+ ---
193
+
194
+ ## Output Formats
195
+
196
+ The `--design-system` flag supports two output formats:
197
+
198
+ ```bash
199
+ # ASCII box (default) - best for terminal display
200
+ python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system
201
+
202
+ # Markdown - best for documentation
203
+ python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown
204
+ ```
205
+
206
+ ---
207
+
208
+ ## Tips for Better Results
209
+
210
+ 1. **Be specific with keywords** - "healthcare SaaS dashboard" > "app"
211
+ 2. **Search multiple times** - Different keywords reveal different insights
212
+ 3. **Combine domains** - Style + Typography + Color = Complete design system
213
+ 4. **Always check UX** - Search "animation", "z-index", "accessibility" for common issues
214
+ 5. **Use stack flag** - Get implementation-specific best practices
215
+ 6. **Iterate** - If first search doesn't match, try different keywords
216
+
217
+ ---
218
+
219
+ ## Common Rules for Professional UI
220
+
221
+ These are frequently overlooked issues that make UI look unprofessional:
222
+
223
+ ### Icons & Visual Elements
224
+
225
+ | Rule | Do | Don't |
226
+ |------|----|----- |
227
+ | **No emoji icons** | Use SVG icons (Heroicons, Lucide, Simple Icons) | Use emojis like 🎨 πŸš€ βš™οΈ as UI icons |
228
+ | **Stable hover states** | Use color/opacity transitions on hover | Use scale transforms that shift layout |
229
+ | **Correct brand logos** | Research official SVG from Simple Icons | Guess or use incorrect logo paths |
230
+ | **Consistent icon sizing** | Use fixed viewBox (24x24) with w-6 h-6 | Mix different icon sizes randomly |
231
+
232
+ ### Interaction & Cursor
233
+
234
+ | Rule | Do | Don't |
235
+ |------|----|----- |
236
+ | **Cursor pointer** | Add `cursor-pointer` to all clickable/hoverable cards | Leave default cursor on interactive elements |
237
+ | **Hover feedback** | Provide visual feedback (color, shadow, border) | No indication element is interactive |
238
+ | **Smooth transitions** | Use `transition-colors duration-200` | Instant state changes or too slow (>500ms) |
239
+
240
+ ### Light/Dark Mode Contrast
241
+
242
+ | Rule | Do | Don't |
243
+ |------|----|----- |
244
+ | **Glass card light mode** | Use `bg-white/80` or higher opacity | Use `bg-white/10` (too transparent) |
245
+ | **Text contrast light** | Use `#0F172A` (slate-900) for text | Use `#94A3B8` (slate-400) for body text |
246
+ | **Muted text light** | Use `#475569` (slate-600) minimum | Use gray-400 or lighter |
247
+ | **Border visibility** | Use `border-gray-200` in light mode | Use `border-white/10` (invisible) |
248
+
249
+ ### Layout & Spacing
250
+
251
+ | Rule | Do | Don't |
252
+ |------|----|----- |
253
+ | **Floating navbar** | Add `top-4 left-4 right-4` spacing | Stick navbar to `top-0 left-0 right-0` |
254
+ | **Content padding** | Account for fixed navbar height | Let content hide behind fixed elements |
255
+ | **Consistent max-width** | Use same `max-w-6xl` or `max-w-7xl` | Mix different container widths |
256
+
257
+ ---
258
+
259
+ ## Pre-Delivery Checklist
260
+
261
+ Before delivering UI code, verify these items:
262
+
263
+ ### Visual Quality
264
+ - [ ] No emojis used as icons (use SVG instead)
265
+ - [ ] All icons from consistent icon set (Heroicons/Lucide)
266
+ - [ ] Brand logos are correct (verified from Simple Icons)
267
+ - [ ] Hover states don't cause layout shift
268
+ - [ ] Use theme colors directly (bg-primary) not var() wrapper
269
+
270
+ ### Interaction
271
+ - [ ] All clickable elements have `cursor-pointer`
272
+ - [ ] Hover states provide clear visual feedback
273
+ - [ ] Transitions are smooth (150-300ms)
274
+ - [ ] Focus states visible for keyboard navigation
275
+
276
+ ### Light/Dark Mode
277
+ - [ ] Light mode text has sufficient contrast (4.5:1 minimum)
278
+ - [ ] Glass/transparent elements visible in light mode
279
+ - [ ] Borders visible in both modes
280
+ - [ ] Test both modes before delivery
281
+
282
+ ### Layout
283
+ - [ ] Floating elements have proper spacing from edges
284
+ - [ ] No content hidden behind fixed navbars
285
+ - [ ] Responsive at 375px, 768px, 1024px, 1440px
286
+ - [ ] No horizontal scroll on mobile
287
+
288
+ ### Accessibility
289
+ - [ ] All images have alt text
290
+ - [ ] Form inputs have labels
291
+ - [ ] Color is not the only indicator
292
+ - [ ] `prefers-reduced-motion` respected
@@ -0,0 +1,26 @@
1
+ No,Data Type,Keywords,Best Chart Type,Secondary Options,Color Guidance,Performance Impact,Accessibility Notes,Library Recommendation,Interactive Level
2
+ 1,Trend Over Time,"trend, time-series, line, growth, timeline, progress",Line Chart,"Area Chart, Smooth Area",Primary: #0080FF. Multiple series: use distinct colors. Fill: 20% opacity,⚑ Excellent (optimized),βœ“ Clear line patterns for colorblind users. Add pattern overlays.,"Chart.js, Recharts, ApexCharts",Hover + Zoom
3
+ 2,Compare Categories,"compare, categories, bar, comparison, ranking",Bar Chart (Horizontal or Vertical),"Column Chart, Grouped Bar",Each bar: distinct color. Category: grouped same color. Sorted: descending order,⚑ Excellent,βœ“ Easy to compare. Add value labels on bars for clarity.,"Chart.js, Recharts, D3.js",Hover + Sort
4
+ 3,Part-to-Whole,"part-to-whole, pie, donut, percentage, proportion, share",Pie Chart or Donut,"Stacked Bar, Treemap",Colors: 5-6 max. Contrasting palette. Large slices first. Use labels.,⚑ Good (limit 6 slices),⚠ Hard for accessibility. Better: Stacked bar with legend. Avoid pie if >5 items.,"Chart.js, Recharts, D3.js",Hover + Drill
5
+ 4,Correlation/Distribution,"correlation, distribution, scatter, relationship, pattern",Scatter Plot or Bubble Chart,"Heat Map, Matrix",Color axis: gradient (blue-red). Size: relative. Opacity: 0.6-0.8 to show density,⚠ Moderate (many points),⚠ Provide data table alternative. Use pattern + color distinction.,"D3.js, Plotly, Recharts",Hover + Brush
6
+ 5,Heatmap/Intensity,"heatmap, heat-map, intensity, density, matrix",Heat Map or Choropleth,"Grid Heat Map, Bubble Heat",Gradient: Cool (blue) to Hot (red). Scale: clear legend. Divergent for ±data,⚑ Excellent (color CSS),⚠ Colorblind: Use pattern overlay. Provide numerical legend.,"D3.js, Plotly, ApexCharts",Hover + Zoom
7
+ 6,Geographic Data,"geographic, map, location, region, geo, spatial","Choropleth Map, Bubble Map",Geographic Heat Map,Regional: single color gradient or categorized colors. Legend: clear scale,⚠ Moderate (rendering),⚠ Include text labels for regions. Provide data table alternative.,"D3.js, Mapbox, Leaflet",Pan + Zoom + Drill
8
+ 7,Funnel/Flow,funnel/flow,"Funnel Chart, Sankey",Waterfall (for flows),Stages: gradient (starting color β†’ ending color). Show conversion %,⚑ Good,βœ“ Clear stage labels + percentages. Good for accessibility if labeled.,"D3.js, Recharts, Custom SVG",Hover + Drill
9
+ 8,Performance vs Target,performance-vs-target,Gauge Chart or Bullet Chart,"Dial, Thermometer",Performance: Redβ†’Yellowβ†’Green gradient. Target: marker line. Threshold colors,⚑ Good,βœ“ Add numerical value + percentage label beside gauge.,"D3.js, ApexCharts, Custom SVG",Hover
10
+ 9,Time-Series Forecast,time-series-forecast,Line with Confidence Band,Ribbon Chart,Actual: solid line #0080FF. Forecast: dashed #FF9500. Band: light shading,⚑ Good,βœ“ Clearly distinguish actual vs forecast. Add legend.,"Chart.js, ApexCharts, Plotly",Hover + Toggle
11
+ 10,Anomaly Detection,anomaly-detection,Line Chart with Highlights,Scatter with Alert,Normal: blue #0080FF. Anomaly: red #FF0000 circle/square marker + alert,⚑ Good,βœ“ Circle/marker for anomalies. Add text alert annotation.,"D3.js, Plotly, ApexCharts",Hover + Alert
12
+ 11,Hierarchical/Nested Data,hierarchical/nested-data,Treemap,"Sunburst, Nested Donut, Icicle",Parent: distinct hues. Children: lighter shades. White borders 2-3px.,⚠ Moderate,⚠ Poor - provide table alternative. Label large areas.,"D3.js, Recharts, ApexCharts",Hover + Drilldown
13
+ 12,Flow/Process Data,flow/process-data,Sankey Diagram,"Alluvial, Chord Diagram",Gradient from source to target. Opacity 0.4-0.6 for flows.,⚠ Moderate,⚠ Poor - provide flow table alternative.,"D3.js (d3-sankey), Plotly",Hover + Drilldown
14
+ 13,Cumulative Changes,cumulative-changes,Waterfall Chart,"Stacked Bar, Cascade",Increases: #4CAF50. Decreases: #F44336. Start: #2196F3. End: #0D47A1.,⚑ Good,βœ“ Good - clear directional colors with labels.,"ApexCharts, Highcharts, Plotly",Hover
15
+ 14,Multi-Variable Comparison,multi-variable-comparison,Radar/Spider Chart,"Parallel Coordinates, Grouped Bar",Single: #0080FF 20% fill. Multiple: distinct colors per dataset.,⚑ Good,⚠ Moderate - limit 5-8 axes. Add data table.,"Chart.js, Recharts, ApexCharts",Hover + Toggle
16
+ 15,Stock/Trading OHLC,stock/trading-ohlc,Candlestick Chart,"OHLC Bar, Heikin-Ashi",Bullish: #26A69A. Bearish: #EF5350. Volume: 40% opacity below.,⚑ Good,⚠ Moderate - provide OHLC data table.,"Lightweight Charts (TradingView), ApexCharts",Real-time + Hover + Zoom
17
+ 16,Relationship/Connection Data,relationship/connection-data,Network Graph,"Hierarchical Tree, Adjacency Matrix",Node types: categorical colors. Edges: #90A4AE 60% opacity.,❌ Poor (500+ nodes struggles),❌ Very Poor - provide adjacency list alternative.,"D3.js (d3-force), Vis.js, Cytoscape.js",Drilldown + Hover + Drag
18
+ 17,Distribution/Statistical,distribution/statistical,Box Plot,"Violin Plot, Beeswarm",Box: #BBDEFB. Border: #1976D2. Median: #D32F2F. Outliers: #F44336.,⚑ Excellent,"βœ“ Good - include stats table (min, Q1, median, Q3, max).","Plotly, D3.js, Chart.js (plugin)",Hover
19
+ 18,Performance vs Target (Compact),performance-vs-target-(compact),Bullet Chart,"Gauge, Progress Bar","Ranges: #FFCDD2, #FFF9C4, #C8E6C9. Performance: #1976D2. Target: black 3px.",⚑ Excellent,βœ“ Excellent - compact with clear values.,"D3.js, Plotly, Custom SVG",Hover
20
+ 19,Proportional/Percentage,proportional/percentage,Waffle Chart,"Pictogram, Stacked Bar 100%",10x10 grid. 3-5 categories max. 2-3px spacing between squares.,⚑ Good,βœ“ Good - better than pie for accessibility.,"D3.js, React-Waffle, Custom CSS Grid",Hover
21
+ 20,Hierarchical Proportional,hierarchical-proportional,Sunburst Chart,"Treemap, Icicle, Circle Packing",Center to outer: darker to lighter. 15-20% lighter per level.,⚠ Moderate,⚠ Poor - provide hierarchy table alternative.,"D3.js (d3-hierarchy), Recharts, ApexCharts",Drilldown + Hover
22
+ 21,Root Cause Analysis,"root cause, decomposition, tree, hierarchy, drill-down, ai-split",Decomposition Tree,"Decision Tree, Flow Chart",Nodes: #2563EB (Primary) vs #EF4444 (Negative impact). Connectors: Neutral grey.,⚠ Moderate (calculation heavy),βœ“ clear hierarchy. Allow keyboard navigation for nodes.,"Power BI (native), React-Flow, Custom D3.js",Drill + Expand
23
+ 22,3D Spatial Data,"3d, spatial, immersive, terrain, molecular, volumetric",3D Scatter/Surface Plot,"Volumetric Rendering, Point Cloud",Depth cues: lighting/shading. Z-axis: color gradient (cool to warm).,❌ Heavy (WebGL required),❌ Poor - requires alternative 2D view or data table.,"Three.js, Deck.gl, Plotly 3D",Rotate + Zoom + VR
24
+ 23,Real-Time Streaming,"streaming, real-time, ticker, live, velocity, pulse",Streaming Area Chart,"Ticker Tape, Moving Gauge",Current: Bright Pulse (#00FF00). History: Fading opacity. Grid: Dark.,⚑ Optimized (canvas/webgl),⚠ Flashing elements - provide pause button. High contrast.,Smoothed D3.js, CanvasJS
25
+ 24,Sentiment/Emotion,"sentiment, emotion, nlp, opinion, feeling",Word Cloud with Sentiment,"Sentiment Arc, Radar Chart",Positive: #22C55E. Negative: #EF4444. Neutral: #94A3B8. Size = Frequency.,⚑ Good,⚠ Word clouds poor for screen readers. Use list view.,"D3-cloud, Highcharts, Nivo",Hover + Filter
26
+ 25,Process Mining,"process, mining, variants, path, bottleneck, log",Process Map / Graph,"Directed Acyclic Graph (DAG), Petri Net",Happy path: #10B981 (Thick). Deviations: #F59E0B (Thin). Bottlenecks: #EF4444.,⚠ Moderate to Heavy,⚠ Complex graphs hard to navigate. Provide path summary.,"React-Flow, Cytoscape.js, Recharts",Drag + Node-Click