@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.
Files changed (124) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +21 -50
  3. package/dist/admin-surfaces/action-tools.js +1 -1
  4. package/dist/admin-surfaces/action-tools.js.map +1 -1
  5. package/dist/admin-surfaces/external-links.d.ts.map +1 -1
  6. package/dist/admin-surfaces/external-links.js +2 -1
  7. package/dist/admin-surfaces/external-links.js.map +1 -1
  8. package/dist/admin-surfaces/host-validator.js +2 -2
  9. package/dist/admin-surfaces/host-validator.js.map +1 -1
  10. package/dist/admin-surfaces/settings-value.d.ts.map +1 -1
  11. package/dist/admin-surfaces/settings-value.js +3 -1
  12. package/dist/admin-surfaces/settings-value.js.map +1 -1
  13. package/dist/admin-surfaces/surface-client.d.ts.map +1 -1
  14. package/dist/admin-surfaces/surface-client.js +13 -5
  15. package/dist/admin-surfaces/surface-client.js.map +1 -1
  16. package/dist/admin-surfaces/surface-handlers.d.ts.map +1 -1
  17. package/dist/admin-surfaces/surface-handlers.js.map +1 -1
  18. package/dist/folder-zip-node.d.ts.map +1 -1
  19. package/dist/folder-zip-node.js +9 -2
  20. package/dist/folder-zip-node.js.map +1 -1
  21. package/dist/lifecycle/activation.js +2 -2
  22. package/dist/lifecycle/activation.js.map +1 -1
  23. package/dist/lifecycle/automatic-use.d.ts.map +1 -1
  24. package/dist/lifecycle/automatic-use.js +12 -7
  25. package/dist/lifecycle/automatic-use.js.map +1 -1
  26. package/dist/lifecycle/bundled-digests.d.ts.map +1 -1
  27. package/dist/lifecycle/bundled-digests.js +3 -8
  28. package/dist/lifecycle/bundled-digests.js.map +1 -1
  29. package/dist/lifecycle/bundled-source-archive.d.ts +8 -2
  30. package/dist/lifecycle/bundled-source-archive.d.ts.map +1 -1
  31. package/dist/lifecycle/bundled-source-archive.js +17 -8
  32. package/dist/lifecycle/bundled-source-archive.js.map +1 -1
  33. package/dist/lifecycle/contribution-loader.d.ts.map +1 -1
  34. package/dist/lifecycle/contribution-loader.js +4 -5
  35. package/dist/lifecycle/contribution-loader.js.map +1 -1
  36. package/dist/lifecycle/index.d.ts +1 -2
  37. package/dist/lifecycle/index.d.ts.map +1 -1
  38. package/dist/lifecycle/index.js.map +1 -1
  39. package/dist/lifecycle/install.d.ts.map +1 -1
  40. package/dist/lifecycle/install.js +59 -53
  41. package/dist/lifecycle/install.js.map +1 -1
  42. package/dist/lifecycle/installed-package-index.d.ts.map +1 -1
  43. package/dist/lifecycle/installed-package-index.js +4 -2
  44. package/dist/lifecycle/installed-package-index.js.map +1 -1
  45. package/dist/lifecycle/installed-package-roots.d.ts.map +1 -1
  46. package/dist/lifecycle/installed-package-roots.js.map +1 -1
  47. package/dist/lifecycle/manifest.d.ts.map +1 -1
  48. package/dist/lifecycle/manifest.js +3 -2
  49. package/dist/lifecycle/manifest.js.map +1 -1
  50. package/dist/lifecycle/node.d.ts.map +1 -1
  51. package/dist/lifecycle/node.js +4 -2
  52. package/dist/lifecycle/node.js.map +1 -1
  53. package/dist/lifecycle/resolve-agent-plugin-refs.d.ts.map +1 -1
  54. package/dist/lifecycle/resolve-agent-plugin-refs.js +1 -3
  55. package/dist/lifecycle/resolve-agent-plugin-refs.js.map +1 -1
  56. package/dist/lifecycle/search-projection.d.ts.map +1 -1
  57. package/dist/lifecycle/search-projection.js +7 -6
  58. package/dist/lifecycle/search-projection.js.map +1 -1
  59. package/dist/lifecycle/seed-bundled.d.ts.map +1 -1
  60. package/dist/lifecycle/seed-bundled.js +1 -3
  61. package/dist/lifecycle/seed-bundled.js.map +1 -1
  62. package/dist/lifecycle/skill-file-reader.d.ts.map +1 -1
  63. package/dist/lifecycle/skill-file-reader.js +15 -5
  64. package/dist/lifecycle/skill-file-reader.js.map +1 -1
  65. package/dist/lifecycle/tools/capabilities.d.ts.map +1 -1
  66. package/dist/lifecycle/tools/capabilities.js +5 -3
  67. package/dist/lifecycle/tools/capabilities.js.map +1 -1
  68. package/dist/lifecycle/tools/projection.js +3 -4
  69. package/dist/lifecycle/tools/projection.js.map +1 -1
  70. package/dist/lifecycle/update-store.d.ts.map +1 -1
  71. package/dist/lifecycle/update-store.js.map +1 -1
  72. package/dist/lifecycle/update.d.ts.map +1 -1
  73. package/dist/lifecycle/update.js +4 -2
  74. package/dist/lifecycle/update.js.map +1 -1
  75. package/dist/lifecycle/yauzl-archive-reader.d.ts.map +1 -1
  76. package/dist/lifecycle/yauzl-archive-reader.js +21 -23
  77. package/dist/lifecycle/yauzl-archive-reader.js.map +1 -1
  78. package/package.json +5 -8
  79. package/ui-ux-design/com.anthropic.claude-code/hooks/hooks.json +0 -4
  80. package/ui-ux-design/mcp.json +0 -4
  81. package/ui-ux-design/plugin.json +0 -25
  82. package/ui-ux-design/skills/frontend-accessibility/SKILL.md +0 -60
  83. package/ui-ux-design/skills/gstack-design/SKILL.md +0 -53
  84. package/ui-ux-design/skills/gstack-design/references/consultation.md +0 -30
  85. package/ui-ux-design/skills/gstack-design/references/html.md +0 -29
  86. package/ui-ux-design/skills/gstack-design/references/review.md +0 -28
  87. package/ui-ux-design/skills/gstack-design/references/shotgun.md +0 -33
  88. package/ui-ux-design/skills/gstack-design/references/upstream-notes.md +0 -23
  89. package/ui-ux-design/skills/interface-design/ORIGINAL.md +0 -16
  90. package/ui-ux-design/skills/interface-design/SKILL.md +0 -41
  91. package/ui-ux-design/skills/interface-design/references/commands/audit.md +0 -40
  92. package/ui-ux-design/skills/interface-design/references/commands/critique.md +0 -21
  93. package/ui-ux-design/skills/interface-design/references/commands/extract.md +0 -34
  94. package/ui-ux-design/skills/interface-design/references/commands/init.md +0 -31
  95. package/ui-ux-design/skills/interface-design/references/commands/status.md +0 -22
  96. package/ui-ux-design/skills/interface-design/references/examples/system-precision.md +0 -29
  97. package/ui-ux-design/skills/interface-design/references/examples/system-warmth.md +0 -29
  98. package/ui-ux-design/skills/interface-design/references/system-template.md +0 -57
  99. package/ui-ux-design/skills/shadcn-ui/README.md +0 -244
  100. package/ui-ux-design/skills/shadcn-ui/SKILL.md +0 -326
  101. package/ui-ux-design/skills/shadcn-ui/examples/auth-layout.tsx +0 -177
  102. package/ui-ux-design/skills/shadcn-ui/examples/data-table.tsx +0 -313
  103. package/ui-ux-design/skills/shadcn-ui/examples/form-pattern.tsx +0 -177
  104. package/ui-ux-design/skills/shadcn-ui/resources/component-catalog.md +0 -481
  105. package/ui-ux-design/skills/shadcn-ui/resources/customization-guide.md +0 -516
  106. package/ui-ux-design/skills/shadcn-ui/resources/migration-guide.md +0 -463
  107. package/ui-ux-design/skills/shadcn-ui/resources/setup-guide.md +0 -412
  108. package/ui-ux-design/skills/shadcn-ui/scripts/verify-setup.sh +0 -134
  109. package/ui-ux-design/skills/ui-ux-design/SKILL.md +0 -77
  110. package/ui-ux-design/skills/ui-ux-design/references/brand-and-voice.md +0 -72
  111. package/ui-ux-design/skills/ui-ux-design/references/components-and-states.md +0 -107
  112. package/ui-ux-design/skills/ui-ux-design/references/delight-and-motion.md +0 -65
  113. package/ui-ux-design/skills/ui-ux-design/references/foundations.md +0 -144
  114. package/ui-ux-design/skills/ui-ux-design/references/inclusive-ai-imagery.md +0 -57
  115. package/ui-ux-design/skills/ui-ux-design/references/kole-jain-uiux-concepts.md +0 -102
  116. package/ui-ux-design/skills/ui-ux-design/references/openai-frontend-skill.md +0 -139
  117. package/ui-ux-design/skills/ui-ux-design/references/premium-ui.md +0 -63
  118. package/ui-ux-design/skills/ui-ux-design/references/research-and-validation.md +0 -78
  119. package/ui-ux-design/skills/ui-ux-design/references/sam-crawford-premium-websites.md +0 -93
  120. package/ui-ux-design/skills/ui-ux-design/references/self-made-web-designer-core-skills.md +0 -123
  121. package/ui-ux-design/skills/ui-ux-design/references/visual-storytelling.md +0 -57
  122. package/ui-ux-design/skills/vercel-web-design-guidelines/SKILL.md +0 -39
  123. package/ui-ux-design/skills/web-compliance/SKILL.md +0 -129
  124. 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.