@jini-ai/agent-plugins 0.6.15-rc.2 → 0.6.15
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/CHANGELOG.md +18 -0
- package/README.md +21 -50
- package/dist/admin-surfaces/action-tools.js +1 -1
- package/dist/admin-surfaces/action-tools.js.map +1 -1
- package/dist/admin-surfaces/external-links.d.ts.map +1 -1
- package/dist/admin-surfaces/external-links.js +2 -1
- package/dist/admin-surfaces/external-links.js.map +1 -1
- package/dist/admin-surfaces/host-validator.js +2 -2
- package/dist/admin-surfaces/host-validator.js.map +1 -1
- package/dist/admin-surfaces/settings-value.d.ts.map +1 -1
- package/dist/admin-surfaces/settings-value.js +3 -1
- package/dist/admin-surfaces/settings-value.js.map +1 -1
- package/dist/admin-surfaces/surface-client.d.ts.map +1 -1
- package/dist/admin-surfaces/surface-client.js +13 -5
- package/dist/admin-surfaces/surface-client.js.map +1 -1
- package/dist/admin-surfaces/surface-handlers.d.ts.map +1 -1
- package/dist/admin-surfaces/surface-handlers.js.map +1 -1
- package/dist/folder-zip-node.d.ts.map +1 -1
- package/dist/folder-zip-node.js +9 -2
- package/dist/folder-zip-node.js.map +1 -1
- package/dist/lifecycle/activation.js +2 -2
- package/dist/lifecycle/activation.js.map +1 -1
- package/dist/lifecycle/automatic-use.d.ts.map +1 -1
- package/dist/lifecycle/automatic-use.js +12 -7
- package/dist/lifecycle/automatic-use.js.map +1 -1
- package/dist/lifecycle/bundled-digests.d.ts.map +1 -1
- package/dist/lifecycle/bundled-digests.js +3 -8
- package/dist/lifecycle/bundled-digests.js.map +1 -1
- package/dist/lifecycle/bundled-source-archive.d.ts +8 -2
- package/dist/lifecycle/bundled-source-archive.d.ts.map +1 -1
- package/dist/lifecycle/bundled-source-archive.js +17 -8
- package/dist/lifecycle/bundled-source-archive.js.map +1 -1
- package/dist/lifecycle/contribution-loader.d.ts.map +1 -1
- package/dist/lifecycle/contribution-loader.js +4 -5
- package/dist/lifecycle/contribution-loader.js.map +1 -1
- package/dist/lifecycle/index.d.ts +1 -2
- package/dist/lifecycle/index.d.ts.map +1 -1
- package/dist/lifecycle/index.js.map +1 -1
- package/dist/lifecycle/install.d.ts.map +1 -1
- package/dist/lifecycle/install.js +59 -53
- package/dist/lifecycle/install.js.map +1 -1
- package/dist/lifecycle/installed-package-index.d.ts.map +1 -1
- package/dist/lifecycle/installed-package-index.js +4 -2
- package/dist/lifecycle/installed-package-index.js.map +1 -1
- package/dist/lifecycle/installed-package-roots.d.ts.map +1 -1
- package/dist/lifecycle/installed-package-roots.js.map +1 -1
- package/dist/lifecycle/manifest.d.ts.map +1 -1
- package/dist/lifecycle/manifest.js +3 -2
- package/dist/lifecycle/manifest.js.map +1 -1
- package/dist/lifecycle/node.d.ts.map +1 -1
- package/dist/lifecycle/node.js +4 -2
- package/dist/lifecycle/node.js.map +1 -1
- package/dist/lifecycle/resolve-agent-plugin-refs.d.ts.map +1 -1
- package/dist/lifecycle/resolve-agent-plugin-refs.js +1 -3
- package/dist/lifecycle/resolve-agent-plugin-refs.js.map +1 -1
- package/dist/lifecycle/search-projection.d.ts.map +1 -1
- package/dist/lifecycle/search-projection.js +7 -6
- package/dist/lifecycle/search-projection.js.map +1 -1
- package/dist/lifecycle/seed-bundled.d.ts.map +1 -1
- package/dist/lifecycle/seed-bundled.js +1 -3
- package/dist/lifecycle/seed-bundled.js.map +1 -1
- package/dist/lifecycle/skill-file-reader.d.ts.map +1 -1
- package/dist/lifecycle/skill-file-reader.js +15 -5
- package/dist/lifecycle/skill-file-reader.js.map +1 -1
- package/dist/lifecycle/tools/capabilities.d.ts.map +1 -1
- package/dist/lifecycle/tools/capabilities.js +5 -3
- package/dist/lifecycle/tools/capabilities.js.map +1 -1
- package/dist/lifecycle/tools/projection.js +3 -4
- package/dist/lifecycle/tools/projection.js.map +1 -1
- package/dist/lifecycle/update-store.d.ts.map +1 -1
- package/dist/lifecycle/update-store.js.map +1 -1
- package/dist/lifecycle/update.d.ts.map +1 -1
- package/dist/lifecycle/update.js +4 -2
- package/dist/lifecycle/update.js.map +1 -1
- package/dist/lifecycle/yauzl-archive-reader.d.ts.map +1 -1
- package/dist/lifecycle/yauzl-archive-reader.js +21 -23
- package/dist/lifecycle/yauzl-archive-reader.js.map +1 -1
- package/package.json +5 -8
- package/ui-ux-design/com.anthropic.claude-code/hooks/hooks.json +0 -4
- package/ui-ux-design/mcp.json +0 -4
- package/ui-ux-design/plugin.json +0 -25
- package/ui-ux-design/skills/frontend-accessibility/SKILL.md +0 -60
- package/ui-ux-design/skills/gstack-design/SKILL.md +0 -53
- package/ui-ux-design/skills/gstack-design/references/consultation.md +0 -30
- package/ui-ux-design/skills/gstack-design/references/html.md +0 -29
- package/ui-ux-design/skills/gstack-design/references/review.md +0 -28
- package/ui-ux-design/skills/gstack-design/references/shotgun.md +0 -33
- package/ui-ux-design/skills/gstack-design/references/upstream-notes.md +0 -23
- package/ui-ux-design/skills/interface-design/ORIGINAL.md +0 -16
- package/ui-ux-design/skills/interface-design/SKILL.md +0 -41
- package/ui-ux-design/skills/interface-design/references/commands/audit.md +0 -40
- package/ui-ux-design/skills/interface-design/references/commands/critique.md +0 -21
- package/ui-ux-design/skills/interface-design/references/commands/extract.md +0 -34
- package/ui-ux-design/skills/interface-design/references/commands/init.md +0 -31
- package/ui-ux-design/skills/interface-design/references/commands/status.md +0 -22
- package/ui-ux-design/skills/interface-design/references/examples/system-precision.md +0 -29
- package/ui-ux-design/skills/interface-design/references/examples/system-warmth.md +0 -29
- package/ui-ux-design/skills/interface-design/references/system-template.md +0 -57
- package/ui-ux-design/skills/shadcn-ui/README.md +0 -244
- package/ui-ux-design/skills/shadcn-ui/SKILL.md +0 -326
- package/ui-ux-design/skills/shadcn-ui/examples/auth-layout.tsx +0 -177
- package/ui-ux-design/skills/shadcn-ui/examples/data-table.tsx +0 -313
- package/ui-ux-design/skills/shadcn-ui/examples/form-pattern.tsx +0 -177
- package/ui-ux-design/skills/shadcn-ui/resources/component-catalog.md +0 -481
- package/ui-ux-design/skills/shadcn-ui/resources/customization-guide.md +0 -516
- package/ui-ux-design/skills/shadcn-ui/resources/migration-guide.md +0 -463
- package/ui-ux-design/skills/shadcn-ui/resources/setup-guide.md +0 -412
- package/ui-ux-design/skills/shadcn-ui/scripts/verify-setup.sh +0 -134
- package/ui-ux-design/skills/ui-ux-design/SKILL.md +0 -77
- package/ui-ux-design/skills/ui-ux-design/references/brand-and-voice.md +0 -72
- package/ui-ux-design/skills/ui-ux-design/references/components-and-states.md +0 -107
- package/ui-ux-design/skills/ui-ux-design/references/delight-and-motion.md +0 -65
- package/ui-ux-design/skills/ui-ux-design/references/foundations.md +0 -144
- package/ui-ux-design/skills/ui-ux-design/references/inclusive-ai-imagery.md +0 -57
- package/ui-ux-design/skills/ui-ux-design/references/kole-jain-uiux-concepts.md +0 -102
- package/ui-ux-design/skills/ui-ux-design/references/openai-frontend-skill.md +0 -139
- package/ui-ux-design/skills/ui-ux-design/references/premium-ui.md +0 -63
- package/ui-ux-design/skills/ui-ux-design/references/research-and-validation.md +0 -78
- package/ui-ux-design/skills/ui-ux-design/references/sam-crawford-premium-websites.md +0 -93
- package/ui-ux-design/skills/ui-ux-design/references/self-made-web-designer-core-skills.md +0 -123
- package/ui-ux-design/skills/ui-ux-design/references/visual-storytelling.md +0 -57
- package/ui-ux-design/skills/vercel-web-design-guidelines/SKILL.md +0 -39
- package/ui-ux-design/skills/web-compliance/SKILL.md +0 -129
- package/ui-ux-design/skills/web-compliance/references/audit-evidence.md +0 -59
|
@@ -1,78 +0,0 @@
|
|
|
1
|
-
# Research and Validation
|
|
2
|
-
|
|
3
|
-
Use this reference when the design needs a validation plan, clearer user framing, or a way to separate assumptions from evidence.
|
|
4
|
-
|
|
5
|
-
## Important Constraint
|
|
6
|
-
|
|
7
|
-
Do not present invented research as completed research. Use this reference to structure:
|
|
8
|
-
|
|
9
|
-
- proposed research plans
|
|
10
|
-
- user hypotheses
|
|
11
|
-
- validation criteria
|
|
12
|
-
- usability-test plans
|
|
13
|
-
|
|
14
|
-
## Useful Artifacts
|
|
15
|
-
|
|
16
|
-
### Proto-Persona
|
|
17
|
-
|
|
18
|
-
Use when real research does not yet exist.
|
|
19
|
-
|
|
20
|
-
Include:
|
|
21
|
-
|
|
22
|
-
- user type
|
|
23
|
-
- main goals
|
|
24
|
-
- main frustrations
|
|
25
|
-
- environment/context of use
|
|
26
|
-
- skill level
|
|
27
|
-
- critical accessibility considerations
|
|
28
|
-
|
|
29
|
-
Label it explicitly as a working assumption.
|
|
30
|
-
|
|
31
|
-
### Journey Snapshot
|
|
32
|
-
|
|
33
|
-
Map:
|
|
34
|
-
|
|
35
|
-
- trigger
|
|
36
|
-
- entry point
|
|
37
|
-
- main steps
|
|
38
|
-
- friction points
|
|
39
|
-
- moments of uncertainty
|
|
40
|
-
- completion state
|
|
41
|
-
- follow-up state
|
|
42
|
-
|
|
43
|
-
### Usability-Test Plan
|
|
44
|
-
|
|
45
|
-
Define:
|
|
46
|
-
|
|
47
|
-
- research questions
|
|
48
|
-
- participant criteria
|
|
49
|
-
- tasks to complete
|
|
50
|
-
- success criteria
|
|
51
|
-
- metrics to watch
|
|
52
|
-
- qualitative prompts
|
|
53
|
-
|
|
54
|
-
### Validation Checklist
|
|
55
|
-
|
|
56
|
-
Use before handoff:
|
|
57
|
-
|
|
58
|
-
- does the layout support the primary user goal quickly
|
|
59
|
-
- are key decisions reversible
|
|
60
|
-
- do labels match user language
|
|
61
|
-
- are errors recoverable
|
|
62
|
-
- is the empty state actionable
|
|
63
|
-
- is keyboard/mobile usage still workable
|
|
64
|
-
|
|
65
|
-
## When This Reference Is Worth Loading
|
|
66
|
-
|
|
67
|
-
- dashboard or workflow-heavy UI
|
|
68
|
-
- ambiguous user roles
|
|
69
|
-
- onboarding flows
|
|
70
|
-
- high-risk UX with multiple steps
|
|
71
|
-
- claims about "user needs" that need structure
|
|
72
|
-
|
|
73
|
-
## Anti-Patterns
|
|
74
|
-
|
|
75
|
-
- pretending empathy maps are evidence
|
|
76
|
-
- writing personas with no behavioral relevance
|
|
77
|
-
- validation plans with no measurable success criteria
|
|
78
|
-
- feature flows optimized for internal assumptions only
|
|
@@ -1,93 +0,0 @@
|
|
|
1
|
-
# Sam Crawford Premium Website Notes
|
|
2
|
-
|
|
3
|
-
Source context: extracted from user-provided transcript files attributed to Sam Crawford / bycrawford, including:
|
|
4
|
-
|
|
5
|
-
- `Brutally Honest Advice About Web Design in 9 mins.txt`
|
|
6
|
-
- `How To Build a Website SO Premium They Beg You To Buy.txt`
|
|
7
|
-
- `The Psychology of Premium Websites.txt`
|
|
8
|
-
|
|
9
|
-
The duplicate file `Brutally Honest Advice About Web Design in 9 mins (1).txt` was ignored because it matched the non-suffixed file byte-for-byte.
|
|
10
|
-
|
|
11
|
-
The later pasted checklist `How to Build a Website So Premium People Trust You Instantly` was reviewed and treated as redundant with this reference. It restates the same system around intentional first impression, bespoke assets, brand foundations, subtle animation, strategic structure, client autonomy, and handover/post-launch care.
|
|
12
|
-
|
|
13
|
-
## Core Thesis
|
|
14
|
-
|
|
15
|
-
Premium websites create a fast feeling of quality, trust, and authority through intentional first impressions, clarity, bespoke visual systems, and restrained details. The goal is not just to look impressive; the site must help the right visitor understand the offer, trust the business, and take the next action.
|
|
16
|
-
|
|
17
|
-
## Psychological Principles
|
|
18
|
-
|
|
19
|
-
- **Halo effect:** visitors form an initial judgment extremely quickly, and that judgment colors how they interpret the rest of the site. Treat the hero and first viewport as the highest-value real estate.
|
|
20
|
-
- **Cognitive fluency:** people trust experiences that are easy to process. Reduce confusion with simple navigation, strong hierarchy, predictable layouts, clear copy, and generous spacing.
|
|
21
|
-
- **Peak-end rule:** users remember standout moments and the ending more than the average of the whole experience. Use micro-interactions, confirmation states, polished transitions, and good completion moments to create small positive peaks.
|
|
22
|
-
|
|
23
|
-
## Premium Signals
|
|
24
|
-
|
|
25
|
-
- Use bespoke assets instead of generic icons, default templates, and disconnected stock imagery.
|
|
26
|
-
- Make graphics serve a purpose: break up content, guide the eye, clarify the message, or reinforce the brand.
|
|
27
|
-
- Use a professional logo, cohesive color palette, and thoughtfully chosen fonts as the foundation.
|
|
28
|
-
- Prefer real imagery, even imperfect real imagery, when it proves that the business is genuine.
|
|
29
|
-
- Use metrics, case studies, real faces, and specific proof where they build trust faster than paragraphs.
|
|
30
|
-
- Give the design a point of view so the business does not look interchangeable with competitors.
|
|
31
|
-
|
|
32
|
-
## Copy And Content
|
|
33
|
-
|
|
34
|
-
- Write for scanners. Use short sections, obvious headings, bolded essentials, and copy that can be understood at a glance.
|
|
35
|
-
- Cut weak copy aggressively. If removing a sentence does not make the page worse, remove it.
|
|
36
|
-
- Sell the result or transformation, not the internal feature list.
|
|
37
|
-
- Make the about page reassure the visitor: credibility, understanding of their problem, proof of having solved it before, and the transformation created.
|
|
38
|
-
- Be explicit about who the offer is for and who it is not for.
|
|
39
|
-
- Where commercially appropriate, show pricing or at least a starting point to filter the wrong leads and attract qualified buyers.
|
|
40
|
-
|
|
41
|
-
## Structure And Conversion
|
|
42
|
-
|
|
43
|
-
- Give each page a purpose and a next step.
|
|
44
|
-
- Make the CTA obvious, easy to find, and easy to take.
|
|
45
|
-
- Use fewer, stronger pages instead of many mediocre pages.
|
|
46
|
-
- Ensure the site map, page hierarchy, internal linking, and content organization make sense for both people and search engines.
|
|
47
|
-
- Do not bury the main action in the footer or force visitors to guess the next logical step.
|
|
48
|
-
- Treat confusion as a conversion leak.
|
|
49
|
-
|
|
50
|
-
## Animation And Interaction
|
|
51
|
-
|
|
52
|
-
- Use subtle motion for feedback, orientation, and attention guidance.
|
|
53
|
-
- Good examples: button hover response, natural content fade-in, smooth transitions, useful form validation feedback.
|
|
54
|
-
- Avoid animation that becomes the thing people notice instead of the offer.
|
|
55
|
-
- Avoid heavy 3D, parallax, or scroll effects when they slow the site, overwhelm the visitor, or distract from the message.
|
|
56
|
-
- Respect reduced-motion preferences and performance budgets.
|
|
57
|
-
|
|
58
|
-
## Performance And Practicality
|
|
59
|
-
|
|
60
|
-
- A premium site must feel fast, especially on mobile and weak connections.
|
|
61
|
-
- Compress images, avoid bloated plugins, and question every unnecessary animation or asset.
|
|
62
|
-
- Test outside the designer's ideal setup: mobile viewport, slower network, and realistic user paths.
|
|
63
|
-
- Avoid black-box builds when client ownership matters. A premium site should be practical to update, not a trap that requires a developer for every content change.
|
|
64
|
-
- Treat launch as the start: collect data, test, optimize, add fresh proof, and keep the site current.
|
|
65
|
-
|
|
66
|
-
## Audit Checklist
|
|
67
|
-
|
|
68
|
-
- Does the first viewport create the intended feeling within a blink?
|
|
69
|
-
- Can a scanner understand what the business does, who it helps, and what to do next?
|
|
70
|
-
- Is the hero visually premium without being vague?
|
|
71
|
-
- Are images real, bespoke, or clearly product-relevant rather than generic filler?
|
|
72
|
-
- Are typography, logo, and colors cohesive?
|
|
73
|
-
- Is there enough whitespace for calm and hierarchy?
|
|
74
|
-
- Does each section have one primary job?
|
|
75
|
-
- Are CTAs clear, repeated at logical points, and easy to act on?
|
|
76
|
-
- Is proof specific: numbers, clients, outcomes, faces, stories, case studies?
|
|
77
|
-
- Does the site repel poor-fit visitors as well as attract good-fit visitors?
|
|
78
|
-
- Are animations subtle, purposeful, and performant?
|
|
79
|
-
- Is the page fast on mobile?
|
|
80
|
-
- Is the site maintainable after launch?
|
|
81
|
-
- Are there obvious next optimization steps after launch?
|
|
82
|
-
|
|
83
|
-
## Conflict Handling For Future References
|
|
84
|
-
|
|
85
|
-
If another reference recommends a different direction, resolve the conflict by asking:
|
|
86
|
-
|
|
87
|
-
1. What audience is this for?
|
|
88
|
-
2. What feeling should the first impression create?
|
|
89
|
-
3. What business action should the page drive?
|
|
90
|
-
4. Which advice improves clarity, trust, and conversion for this context?
|
|
91
|
-
5. Which advice introduces avoidable risk in performance, accessibility, or maintainability?
|
|
92
|
-
|
|
93
|
-
Document the chosen direction briefly instead of silently merging incompatible advice.
|
|
@@ -1,123 +0,0 @@
|
|
|
1
|
-
# Self-Made Web Designer Core Skills Notes
|
|
2
|
-
|
|
3
|
-
Source context: extracted from user-provided transcript files attributed to Self-Made Web Designer:
|
|
4
|
-
|
|
5
|
-
- `The Only 5 Web Design Skills That Actually Matter (2025).txt`
|
|
6
|
-
- `6 Tips to 10x ANY Site's Design.txt`
|
|
7
|
-
|
|
8
|
-
## Core Thesis
|
|
9
|
-
|
|
10
|
-
Strong web design comes from a small set of repeatable fundamentals: typography, layout, color, code literacy, and conversion thinking. Premium polish is not just taste; it comes from systems, deliberate focal ideas, and enough iteration to avoid settling for the first workable version.
|
|
11
|
-
|
|
12
|
-
## The Five Skills
|
|
13
|
-
|
|
14
|
-
### Typography
|
|
15
|
-
|
|
16
|
-
- Treat typography as the largest visual surface on most websites.
|
|
17
|
-
- Pick fonts that match the project's personality instead of defaulting to the same overused free fonts.
|
|
18
|
-
- Consider less common free or affordable sources such as Fontshare and Uncut when a project needs more personality.
|
|
19
|
-
- Build a type scale instead of eyeballing sizes. Start with a base body size, often around 16px, then scale headings consistently.
|
|
20
|
-
- Use `rem` values where practical so type scales remain systematic.
|
|
21
|
-
- Keep body text letter spacing at the default for legibility.
|
|
22
|
-
- Tighten heading letter spacing and line height only where the larger type benefits from more impact.
|
|
23
|
-
- Use about 150% line height for paragraph text as a starting point.
|
|
24
|
-
|
|
25
|
-
### Layout
|
|
26
|
-
|
|
27
|
-
- Use systems rather than dragging elements until they feel right.
|
|
28
|
-
- Start from a responsive column grid: 12 columns on desktop, 8 on tablet, and 4 on mobile is a useful default.
|
|
29
|
-
- Use an 8-point spacing system for rhythm: 8, 16, 24, 32, and so on.
|
|
30
|
-
- Build visual hierarchy with proximity, size, contrast, and alignment.
|
|
31
|
-
- Keep related items close together and unrelated items clearly separated.
|
|
32
|
-
- Use clean alignment to make the structure feel intentional.
|
|
33
|
-
|
|
34
|
-
### Color
|
|
35
|
-
|
|
36
|
-
- Use fewer colors more intentionally. A small palette usually beats many unrelated colors.
|
|
37
|
-
- Use the 60/30/10 rule as a starting point: neutral/background/text colors, supporting colors, and accent colors for CTAs or emphasis.
|
|
38
|
-
- Prefer opacity and tints from a core color before adding more unrelated colors.
|
|
39
|
-
- Check contrast: roughly 4.5:1 for smaller text and 3:1 for larger text are useful accessibility thresholds.
|
|
40
|
-
- Borrow and refine proven palettes rather than inventing every palette from scratch.
|
|
41
|
-
- Use browser tooling such as Chrome DevTools CSS Overview to inspect real sites' color and type systems.
|
|
42
|
-
|
|
43
|
-
### Code Literacy
|
|
44
|
-
|
|
45
|
-
- Learn enough HTML, CSS, JavaScript, and platform-specific basics to understand what the design requires and how to adapt it.
|
|
46
|
-
- A designer does not need to become a full-stack developer, but code literacy separates practical designers from purely visual ones.
|
|
47
|
-
- Start from examples, snippets, CodePen, or generated code that gets most of the way there, then adjust the final behavior and polish.
|
|
48
|
-
- Design with implementation constraints in mind.
|
|
49
|
-
|
|
50
|
-
### Conversion
|
|
51
|
-
|
|
52
|
-
- Design for action, not just looks.
|
|
53
|
-
- Give every page one primary goal: buy, book, sign up, download, or another clear action.
|
|
54
|
-
- Put a clear CTA in the hero, navigation, and at logical intervals down the page.
|
|
55
|
-
- Build trust with clarity, emotion, testimonials, reviews, and social proof.
|
|
56
|
-
- Make users know, like, trust, and feel something from the brand.
|
|
57
|
-
- Do not improve visual style at the cost of the user journey.
|
|
58
|
-
|
|
59
|
-
## Six Fast Upgrade Techniques
|
|
60
|
-
|
|
61
|
-
### 1. Upgrade Typography With Font Pairing
|
|
62
|
-
|
|
63
|
-
- One-font sites can work, but stronger visual character often comes from a better pairing system.
|
|
64
|
-
- Use superfamilies when you want cohesion with low risk.
|
|
65
|
-
- Use separate font families when you need more personality, but ensure they feel from the same world.
|
|
66
|
-
- Choose an anchor font first. For many web pages, the headline font is the best anchor because it sets the personality.
|
|
67
|
-
- Pick supporting fonts that contrast enough to add interest without feeling accidental.
|
|
68
|
-
- Avoid pairings that are almost the same but slightly different; they often look unintentional.
|
|
69
|
-
- Use references such as Fonts In Use to see proven pairings for a chosen anchor font.
|
|
70
|
-
|
|
71
|
-
### 2. Create A Star Of The Show
|
|
72
|
-
|
|
73
|
-
- A website is often the first meeting with a brand, so it should make the visitor feel something.
|
|
74
|
-
- Pick one visual idea that anchors attention long enough for the visitor to understand and act.
|
|
75
|
-
- The star can be a font, image, object, illustration, product visual, gradient, chart motif, or interactive element.
|
|
76
|
-
- Connect the star to the story of the site rather than choosing it only because it looks cool.
|
|
77
|
-
- Let surrounding design decisions grow from that focal idea.
|
|
78
|
-
|
|
79
|
-
### 3. Use Visual Rhyming
|
|
80
|
-
|
|
81
|
-
- Repeat details from the core visual idea across the page so everything feels from the same universe.
|
|
82
|
-
- Rhyming can happen through shapes, colors, textures, gradients, masks, icons, card treatments, buttons, or link details.
|
|
83
|
-
- Pull pieces from the strongest visual element and reuse them in secondary elements.
|
|
84
|
-
- Use repetition to create cohesion, not clutter.
|
|
85
|
-
|
|
86
|
-
### 4. Add Subtle Depth
|
|
87
|
-
|
|
88
|
-
- Use depth to make digital interfaces feel more tangible.
|
|
89
|
-
- Examples include light texture, noise, glass effects, layered cards, shadows, dimensional product elements, or 3D details.
|
|
90
|
-
- Keep depth subordinate to the star of the show.
|
|
91
|
-
- Avoid depth that competes with copy, harms readability, or looks like decoration pasted on top.
|
|
92
|
-
|
|
93
|
-
### 5. Use Opacity For Hierarchy
|
|
94
|
-
|
|
95
|
-
- Do not make every text element equally loud.
|
|
96
|
-
- Keep the most important headline or action at full emphasis.
|
|
97
|
-
- Lower opacity for supporting text, metadata, captions, muted navigation, or less important labels.
|
|
98
|
-
- Use opacity deliberately to help the eye know what to read first, skim second, and ignore unless needed.
|
|
99
|
-
- Maintain sufficient contrast for accessibility.
|
|
100
|
-
|
|
101
|
-
### 6. Explore Strong Variants
|
|
102
|
-
|
|
103
|
-
- Do not keep polishing only the first idea.
|
|
104
|
-
- Create intentionally different versions: light and dark modes, different layout structures, different focal visuals, different font anchors, or different image concepts.
|
|
105
|
-
- Push far enough away from the first version to reveal better possibilities.
|
|
106
|
-
- Compare variants against the page goal, first-impression target, readability, and conversion path.
|
|
107
|
-
|
|
108
|
-
## Practical Audit Checklist
|
|
109
|
-
|
|
110
|
-
- Is the type system deliberate, readable, and distinctive enough for the brand?
|
|
111
|
-
- Are heading, body, line-height, and spacing choices systematic?
|
|
112
|
-
- Does the layout use a clear responsive grid?
|
|
113
|
-
- Is spacing rhythmic and based on repeatable increments?
|
|
114
|
-
- Is the page hierarchy obvious to a scanner?
|
|
115
|
-
- Does the palette have a restrained structure and clear roles?
|
|
116
|
-
- Does every important color pairing pass contrast expectations?
|
|
117
|
-
- Is there one primary page goal?
|
|
118
|
-
- Are CTAs visible early and repeated where the user naturally needs them?
|
|
119
|
-
- Does the page have a memorable focal idea connected to the offer?
|
|
120
|
-
- Are visual details repeated enough to feel cohesive?
|
|
121
|
-
- Is depth subtle and supportive?
|
|
122
|
-
- Are less important elements visually quieter?
|
|
123
|
-
- Were multiple meaningfully different variants explored before settling?
|
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
# Visual Storytelling
|
|
2
|
-
|
|
3
|
-
Use this reference for marketing pages, explainers, campaign surfaces, infographics, and interfaces where narrative sequence materially affects comprehension.
|
|
4
|
-
|
|
5
|
-
## Core Rule
|
|
6
|
-
|
|
7
|
-
A narrative surface needs an intentional sequence, not just stacked sections.
|
|
8
|
-
|
|
9
|
-
## Narrative Frame
|
|
10
|
-
|
|
11
|
-
Define:
|
|
12
|
-
|
|
13
|
-
1. setup: what the user understands first
|
|
14
|
-
2. tension/problem: what is difficult, costly, or unclear
|
|
15
|
-
3. resolution: how the product or feature resolves it
|
|
16
|
-
4. proof: why the claim is credible
|
|
17
|
-
5. action: what the user should do next
|
|
18
|
-
|
|
19
|
-
## Suitable Use Cases
|
|
20
|
-
|
|
21
|
-
- landing pages
|
|
22
|
-
- product launches
|
|
23
|
-
- case-study pages
|
|
24
|
-
- data storytelling
|
|
25
|
-
- onboarding sequences
|
|
26
|
-
- scroll-based explainers
|
|
27
|
-
|
|
28
|
-
## Information Design Rules
|
|
29
|
-
|
|
30
|
-
- one primary message per section
|
|
31
|
-
- strong heading hierarchy
|
|
32
|
-
- visual proof close to the claim it supports
|
|
33
|
-
- charts selected for comparison clarity, not decoration
|
|
34
|
-
- progressive disclosure where density is high
|
|
35
|
-
|
|
36
|
-
## Visual Proof Options
|
|
37
|
-
|
|
38
|
-
- screenshots
|
|
39
|
-
- before/after comparisons
|
|
40
|
-
- metrics callouts
|
|
41
|
-
- testimonials
|
|
42
|
-
- diagrams
|
|
43
|
-
- annotated flows
|
|
44
|
-
|
|
45
|
-
## Data Visualization Rules
|
|
46
|
-
|
|
47
|
-
- choose the simplest chart that answers the question
|
|
48
|
-
- label directly when possible
|
|
49
|
-
- do not rely on color alone
|
|
50
|
-
- use narrative annotations sparingly and intentionally
|
|
51
|
-
|
|
52
|
-
## Anti-Patterns
|
|
53
|
-
|
|
54
|
-
- motion-heavy storytelling with no information gain
|
|
55
|
-
- hero sections that hide the actual value proposition
|
|
56
|
-
- decorative diagrams with no explanatory role
|
|
57
|
-
- multi-section pages where every section competes equally
|
|
@@ -1,39 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: vercel-web-design-guidelines
|
|
3
|
-
description: Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".
|
|
4
|
-
metadata:
|
|
5
|
-
author: vercel
|
|
6
|
-
version: "1.0.0"
|
|
7
|
-
argument-hint: <file-or-pattern>
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
# Web Interface Guidelines
|
|
11
|
-
|
|
12
|
-
Review files for compliance with Web Interface Guidelines.
|
|
13
|
-
|
|
14
|
-
## How It Works
|
|
15
|
-
|
|
16
|
-
1. Fetch the latest guidelines from the source URL below
|
|
17
|
-
2. Read the specified files (or prompt user for files/pattern)
|
|
18
|
-
3. Check against all rules in the fetched guidelines
|
|
19
|
-
4. Output findings in the terse `file:line` format
|
|
20
|
-
|
|
21
|
-
## Guidelines Source
|
|
22
|
-
|
|
23
|
-
Fetch fresh guidelines before each review:
|
|
24
|
-
|
|
25
|
-
```
|
|
26
|
-
https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
Use WebFetch to retrieve the latest rules. The fetched content contains all the rules and output format instructions.
|
|
30
|
-
|
|
31
|
-
## Usage
|
|
32
|
-
|
|
33
|
-
When a user provides a file or pattern argument:
|
|
34
|
-
1. Fetch guidelines from the source URL above
|
|
35
|
-
2. Read the specified files
|
|
36
|
-
3. Apply all rules from the fetched guidelines
|
|
37
|
-
4. Output findings using the format specified in the guidelines
|
|
38
|
-
|
|
39
|
-
If no files specified, ask the user which files to review.
|
|
@@ -1,129 +0,0 @@
|
|
|
1
|
-
# Web Compliance
|
|
2
|
-
|
|
3
|
-
## Purpose
|
|
4
|
-
Provide a practical compliance checklist for website-facing features so review agents can consistently catch legal and policy risks before release.
|
|
5
|
-
|
|
6
|
-
## Scope
|
|
7
|
-
This skill is a risk-screening layer for product and engineering workflows, not legal advice. It helps teams surface issues early and escalate to legal/privacy/security reviewers when needed.
|
|
8
|
-
|
|
9
|
-
## Jurisdiction Baseline
|
|
10
|
-
Apply checks based on the strictest applicable region for the release scope.
|
|
11
|
-
|
|
12
|
-
- EU/EEA: GDPR + ePrivacy (opt-in consent for non-essential cookies/tracking)
|
|
13
|
-
- UK: UK GDPR + PECR (similar consent posture to EU)
|
|
14
|
-
- California: CCPA/CPRA (notice + opt-out model for "sale/share" contexts)
|
|
15
|
-
- Canada: PIPEDA/CASL (privacy + strong marketing consent requirements)
|
|
16
|
-
- US (SMS): TCPA constraints for promotional SMS consent and disclosures
|
|
17
|
-
|
|
18
|
-
If target regions are unknown, mark as `high` uncertainty and escalate for legal confirmation before launch.
|
|
19
|
-
|
|
20
|
-
## Use When
|
|
21
|
-
- Feature introduces forms, tracking, cookies, analytics, personalization, ads, or user-generated content
|
|
22
|
-
- Feature changes terms, pricing, claims, consent text, email/SMS capture, account creation, or account deletion flows
|
|
23
|
-
- Feature impacts regional availability or age-restricted experiences
|
|
24
|
-
|
|
25
|
-
## Core Checklist
|
|
26
|
-
|
|
27
|
-
### Privacy and Data Handling
|
|
28
|
-
- Personal data collection points are explicit and minimal for the feature goal
|
|
29
|
-
- Sensitive/special-category data is identified and handled with elevated controls where required (for example: health data, racial/ethnic origin, religious beliefs, political opinions, genetic data, biometric data, sexual orientation, trade union membership, precise geolocation where regulated)
|
|
30
|
-
- Privacy notice and just-in-time disclosures are present where data is collected
|
|
31
|
-
- Consent and preference choices are explicit where required (no hidden defaults)
|
|
32
|
-
- Data retention/deletion expectations are reflected in UX copy and flow behavior
|
|
33
|
-
- Data subject request (DSR) mechanisms exist and are usable for access/export/deletion/portability where required
|
|
34
|
-
- DSR identity verification and response-path UX are defined (do not rely on policy copy alone)
|
|
35
|
-
- DSR flow communicates expected response timing/status updates where required (for example: GDPR typically 1 month with permitted extension; CCPA typically 45 days with permitted extension)
|
|
36
|
-
- Frontend collection fields and backend validation contract align (no unexpected extra data accepted)
|
|
37
|
-
- Cross-border data transfer implications are identified for relevant vendors/services and escalated when transfer mechanism evidence is unclear
|
|
38
|
-
- Sensitive fields use safe defaults for storage/autofill behavior appropriate to risk
|
|
39
|
-
|
|
40
|
-
### Tracking and Consent
|
|
41
|
-
- Non-essential tracking is gated behind consent where required
|
|
42
|
-
- Consent state is honored across page loads and third-party tags
|
|
43
|
-
- "Reject" and "Manage preferences" paths are as visible as "Accept"
|
|
44
|
-
- Consent withdrawal/revocation is as easy and discoverable as consent grant where required
|
|
45
|
-
- Consent actions are auditable (timestamp, policy/version context, and scope) where required
|
|
46
|
-
- No non-essential cookies/tags/pixels fire before valid consent in opt-in regions
|
|
47
|
-
- Consent categories are explicit (for example: necessary, functional, analytics, marketing)
|
|
48
|
-
- Consent UI has no pre-checked boxes and no coercive "cookie wall" patterns where prohibited
|
|
49
|
-
- Region-based consent behavior is enforced server/edge-side, not only via frontend display toggles
|
|
50
|
-
- Push notification permissions are requested with clear purpose/context and respect prior denial/dismissal patterns
|
|
51
|
-
|
|
52
|
-
### Claims and Marketing Content
|
|
53
|
-
- Product/marketing claims are specific and supportable (avoid unverifiable absolutes)
|
|
54
|
-
- Pricing, trial, and renewal details are clear in the same flow where commitment happens
|
|
55
|
-
- Required disclosures are placed near relevant calls to action
|
|
56
|
-
- Subscription cancellation path is at least as discoverable and easy as sign-up
|
|
57
|
-
- Cancellation is available through the same primary medium as sign-up where required (for example, online sign-up implies online cancellation path)
|
|
58
|
-
- Negative option billing/auto-renew enrollment uses explicit affirmative consent separate from bundled legal text where required
|
|
59
|
-
- Free-trial to paid conversion terms are explicit before commitment
|
|
60
|
-
- Material ToS/pricing/renewal-term changes trigger proactive user notice and re-consent/acknowledgment checks where required
|
|
61
|
-
|
|
62
|
-
### Email/SMS Capture and Messaging
|
|
63
|
-
- Email capture flow includes clear sender identity and functional unsubscribe path
|
|
64
|
-
- SMS capture includes explicit consent language, program identity, and opt-out instructions where required
|
|
65
|
-
- Messaging consent scope matches actual campaign behavior (no silent purpose expansion)
|
|
66
|
-
|
|
67
|
-
### Third-Party Scripts and Vendors
|
|
68
|
-
- New third-party scripts/SDKs/pixels/iframes are inventoried in the change review
|
|
69
|
-
- Data-sharing impact is assessed as a potential new vendor/subprocessor risk
|
|
70
|
-
- Vendor data flows are reflected in disclosures/policies where required
|
|
71
|
-
- Non-essential third-party scripts are technically blocked until consent state permits execution
|
|
72
|
-
|
|
73
|
-
### User Rights and Account Controls
|
|
74
|
-
- Account creation, sign-in, and recovery flows avoid dark patterns (confirm-shaming, roach motel, hidden costs, forced continuity)
|
|
75
|
-
- Account deletion/deactivation flow is discoverable and not materially harder than sign-up
|
|
76
|
-
- Contact and complaint/reporting channels are visible for regulated or trust-sensitive features
|
|
77
|
-
- If automated decisioning materially affects users (for example eligibility, ranking, moderation outcomes), disclosure and human-review escalation path are present where required
|
|
78
|
-
- For personalization/targeting profiles, objection and opt-out controls are discoverable and honored where required
|
|
79
|
-
|
|
80
|
-
### Age-Restricted Experiences
|
|
81
|
-
- Age gate behavior is neutral and non-deceptive
|
|
82
|
-
- Child-directed and "actual knowledge of minor user" risk cases are flagged for legal review before release
|
|
83
|
-
- Data handling and consent flows for minors are not inferred; require explicit policy/legal alignment
|
|
84
|
-
|
|
85
|
-
### Accessibility and Fairness
|
|
86
|
-
- Compliance-related controls are usable with keyboard and assistive technologies
|
|
87
|
-
- Critical disclosures are not conveyed by color alone
|
|
88
|
-
- Consent and policy controls are understandable at normal reading level
|
|
89
|
-
- For EU-market digital products, include European Accessibility Act (EAA) applicability check in addition to WCAG baseline validation
|
|
90
|
-
|
|
91
|
-
### UGC and Platform Governance
|
|
92
|
-
- If user-generated content is in scope, reporting, enforcement notice, and appeal pathways are defined where required
|
|
93
|
-
- Recommender/ranking controls avoid manipulative defaults and are communicated in clear user-facing terms
|
|
94
|
-
|
|
95
|
-
## Output Contract
|
|
96
|
-
When this skill is applied, output should include:
|
|
97
|
-
- Findings list with `risk_level` (`high`, `medium`, `low`)
|
|
98
|
-
- Exact file/flow references
|
|
99
|
-
- User-facing and regulatory impact
|
|
100
|
-
- Recommended remediation or escalation target (legal/privacy/security/product)
|
|
101
|
-
- Jurisdiction assumptions used for each finding
|
|
102
|
-
- Verification evidence type (`code`, `config`, `network`, `ui-copy`, `flow-path`)
|
|
103
|
-
- Explicit uncertainty notes when legal interpretation is required
|
|
104
|
-
- For `high` and `medium` findings, add audit-style gap framing:
|
|
105
|
-
- `control_area`
|
|
106
|
-
- `current_state`
|
|
107
|
-
- `target_state`
|
|
108
|
-
- `remediation_steps`
|
|
109
|
-
- `estimated_effort`
|
|
110
|
-
- `evidence_needed`
|
|
111
|
-
|
|
112
|
-
## Audit-Style Evidence Layer
|
|
113
|
-
- Use audit-style gap framing when the feature touches consent logging, DSR flows, retention/deletion behavior, vendor/script controls, cancellation parity, or age-gating.
|
|
114
|
-
- If multiple findings share the same root cause, group them into one remediation cluster and list shared evidence needed.
|
|
115
|
-
- If evidence cannot be verified from code or config, mark it as `missing evidence` rather than assuming compliance.
|
|
116
|
-
- When useful, load `<AI_DEV_SHOP_ROOT>/skills/web-compliance/references/audit-evidence.md` for gap templates and evidence-matrix structure.
|
|
117
|
-
|
|
118
|
-
## Escalation Routing Heuristics
|
|
119
|
-
- Route to `legal` for jurisdiction interpretation, cross-border transfer mechanism questions, ToS/pricing term changes, marketing claims substantiation, and minor/age-gating edge cases.
|
|
120
|
-
- Route to `privacy` for consent model mismatches, DSR/portability flow gaps, profiling objection controls, retention/deletion mismatches, and disclosure scope misalignment.
|
|
121
|
-
- Route to `security` for backend/edge enforcement failures (for example pre-consent tag firing), identity-verification weaknesses in DSR flows, and third-party data exfiltration risk.
|
|
122
|
-
- Route to `product` for UX dark patterns, cancellation discoverability parity, disclosure placement/copy clarity, and funnel-level remediation sequencing.
|
|
123
|
-
- If a finding spans multiple domains, assign primary owner by root cause and list secondary owners explicitly.
|
|
124
|
-
|
|
125
|
-
## Guardrails
|
|
126
|
-
- Do not present this skill as legal advice
|
|
127
|
-
- Do not block release on low-confidence assumptions; escalate with explicit uncertainty
|
|
128
|
-
- Prefer concrete evidence (copy text, UI path, config behavior) over generic warnings
|
|
129
|
-
- Do not claim certification or framework readiness from website-surface checks alone
|
|
@@ -1,59 +0,0 @@
|
|
|
1
|
-
# Audit Evidence
|
|
2
|
-
|
|
3
|
-
Use this reference when `web-compliance` findings need stronger remediation framing or evidence collection structure.
|
|
4
|
-
|
|
5
|
-
## When to Use
|
|
6
|
-
|
|
7
|
-
- medium or high risk findings
|
|
8
|
-
- consent and tracking controls
|
|
9
|
-
- DSR/export/delete/account-control flows
|
|
10
|
-
- subscription or cancellation parity
|
|
11
|
-
- vendor/script introductions
|
|
12
|
-
- age-gating and regulated onboarding flows
|
|
13
|
-
|
|
14
|
-
## Gap Record Template
|
|
15
|
-
|
|
16
|
-
For each medium/high finding, capture:
|
|
17
|
-
|
|
18
|
-
- `control_area`: short label for the compliance concern
|
|
19
|
-
- `current_state`: what the product does today
|
|
20
|
-
- `target_state`: what must be true for launch
|
|
21
|
-
- `remediation_steps`: concrete next actions
|
|
22
|
-
- `estimated_effort`: small, medium, large or time estimate
|
|
23
|
-
- `evidence_needed`: what must be shown to verify the fix
|
|
24
|
-
|
|
25
|
-
Example:
|
|
26
|
-
|
|
27
|
-
```yaml
|
|
28
|
-
control_area: consent-logging
|
|
29
|
-
current_state: Analytics consent banner is shown, but no evidence of consent timestamp or policy-version capture exists.
|
|
30
|
-
target_state: Consent grant, rejection, and withdrawal are recorded with timestamp, policy version, and scope.
|
|
31
|
-
remediation_steps:
|
|
32
|
-
- Add server-side consent event persistence
|
|
33
|
-
- Include policy/version identifier in stored consent records
|
|
34
|
-
- Add withdrawal path and verify revocation updates persisted state
|
|
35
|
-
estimated_effort: medium
|
|
36
|
-
evidence_needed:
|
|
37
|
-
- code path for persistence
|
|
38
|
-
- database schema or event payload
|
|
39
|
-
- UI flow showing withdrawal path
|
|
40
|
-
- test or network proof that records are written
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
## Evidence Matrix
|
|
44
|
-
|
|
45
|
-
When multiple findings exist, summarize expected evidence with:
|
|
46
|
-
|
|
47
|
-
| Control Area | Evidence Type | Source | Collection Method | Verification Step |
|
|
48
|
-
|---|---|---|---|---|
|
|
49
|
-
| Consent logging | `code`, `network`, `config` | backend endpoint + client flow | inspect code and capture browser network | verify grant/reject/withdraw all persist |
|
|
50
|
-
| Pre-consent blocking | `network`, `config` | tag manager or edge config | browser/network trace before consent | confirm no non-essential tags fire |
|
|
51
|
-
| Cancellation parity | `ui-copy`, `flow-path` | account settings flow | walkthrough + screenshots | compare sign-up vs cancel discoverability |
|
|
52
|
-
|
|
53
|
-
## Evidence Rules
|
|
54
|
-
|
|
55
|
-
- Prefer direct evidence over policy promises.
|
|
56
|
-
- Mark missing proof as `missing evidence`.
|
|
57
|
-
- Group related findings when one remediation fixes several symptoms.
|
|
58
|
-
- Do not infer backend controls from frontend copy alone.
|
|
59
|
-
- Do not mark a control complete unless the operating behavior can be shown.
|