front-activation
- Group: Routing
- When it activates: Starting a UI, animation or 3D task: detects the front-end profile and the minimum reading per task; specific effects from the catalog (modern CSS, shapes and SVG, kinetic typography, microinteractions, advanced WebGL, physics and impact: falling objects, broken screen, intros and loaders)
- Requires:
ui-ux-pro-max - Installed: In projects with a frontend profile.
This skill is the entry point when the project does NOT have the “Front y diseño” (front-end and design) block generated by
sync.ps1 (that is, when Senzu was installed as a plugin or as global skills). Do this in order:
Front-end tree (start here)
Section titled “Front-end tree (start here)”- UI task (page, component, layout, theme)? → 1st
ui-ux-pro-max(design system + pattern + components). - Specific effect (marquee, parallax, WebGL hover, blob, gooey, view transitions, microinteraction…)? →
references/effects-catalog.md(Senzu’s own recipes inreferences/recipes/: modern CSS, shapes and SVG, kinetic typography, microinteractions, advanced WebGL, physics and impact: falling object, broken screen, intro or loader that shatters, with working demos inrecipes/demos/); if it is not there:references/effect-sources.md(Codrops/CodePen + protocol to turn it into a recipe). - Animation? → tree F2 of
skill-router/references/decision-trees.md. - 3D? → tree F3 of the same file. Before implementing any effect, validate its cost with F4.
1. Detect the front-end stack (never assume it)
Section titled “1. Detect the front-end stack (never assume it)”| Evidence | Profile | Search tool --stack (in order) |
|---|---|---|
senzu/senzu.json with frontProfile |
the one it indicates | frontProfile.stacks |
composer.json with inertiajs/inertia-laravel (+ vue in package.json) |
Laravel + Inertia + Vue 3 | laravel, vue, html-tailwind, shadcn |
package.json with next |
Next.js (App Router) + React | nextjs, react, shadcn, html-tailwind |
package.json with astro |
Astro + React islands | astro, react, shadcn, html-tailwind |
package.json with vue (without Inertia) |
Vue 3 SPA | vue, html-tailwind, shadcn |
svelte / nuxt / angular / react-native / flutter |
others | the upstream stack with that name |
| Nothing conclusive | ask the user | — |
2. Read the matching skill BEFORE writing code
Section titled “2. Read the matching skill BEFORE writing code”| If the task involves… | Skill | Group |
|---|---|---|
| Creating, laying out or redesigning pages, views, layouts, components, forms, dashboards, themes, colors, typography, icons, responsive, accessibility; .vue .tsx .jsx .astro .blade.php .html .css files | ui-ux-pro-max (default: start here) |
Front-end and design |
| Server state (fetch, cache, invalidation, infinite), tables with sorting/filtering/pagination (client or server), virtualization of large lists; dashboards and data tables (React, Vue, Svelte, Solid) | tanstack (if installed) |
Front-end and design |
| Design tokens (primitive → semantic → component), CSS variables, token validation | design-system (if installed) |
Front-end and design |
| shadcn/ui components (React or Vue) and Tailwind utilities/theme | ui-styling (if installed) |
Front-end and design |
| Generating AI images that match the website: floating product, heroes, backgrounds, 3D, mockups, textures (gpt-image in Codex, Nano Banana in Antigravity, multi-provider script) | image-gen |
Front-end and design |
| Verifying a finished UI in a real browser: responsive 375/768/1440, dark mode, console and accessibility (axe); mandatory before considering a view done | ui-verify |
Front-end and design |
| Modern web design trends and principles | modern-web-design (if installed) |
Front-end and design |
| Declarative animation in React/Next with Motion (variants, gestures, layout animations) | motion-framer (if installed) |
Animation |
| Physics-based animation in React (react-spring) | react-spring-physics (if installed) |
Animation |
| Prebuilt animated components (Magic UI, React Bits) | animated-component-libraries (if installed) |
Animation |
| Smooth scroll with Locomotive Scroll | locomotive-scroll (if installed) |
Animation |
| Page transitions with Barba.js (multi-page sites) | barba-js (if installed) |
Animation |
| Lottie animations (After Effects JSON) | lottie-animations (if installed) |
Animation |
| Simple scroll reveals (AOS) on landing pages | scroll-reveal-libraries (if installed) |
Animation |
| Lightweight JS animations (anime.js) of DOM/SVG | animejs (if installed) |
Animation |
| Animation, scroll-driven, parallax, pin/scrub, timelines, page transitions, smooth scroll (Lenis) | gsap-scrolltrigger (if installed) |
Animation |
| Declarative 3D in React/Next (R3F + drei) | react-three-fiber (if installed) |
3D / WebGL |
| 2D graphics/particles on canvas with PixiJS | pixijs-2d (if installed) |
3D / WebGL |
| Lightweight decorative 3D effects (Zdog, Vanta, tilt) | lightweight-3d-effects (if installed) |
3D / WebGL |
| Exporting/optimizing Blender models to glTF for the web | blender-web-pipeline (if installed) |
3D / WebGL |
| Scenes made in Spline and web integration | spline-interactive (if installed) |
3D / WebGL |
| PBR texturing with Substance 3D for the web | substance-3d-texturing (if installed) |
3D / WebGL |
| Interactive Rive animations (state machines) | rive-interactive (if installed) |
3D / WebGL |
| Games/experiences with PlayCanvas | playcanvas-engine (if installed) |
3D / WebGL |
| Combining Three.js + GSAP + R3F + Motion in complex 3D experiences | web3d-integration-patterns (if installed) |
3D / WebGL |
| 3D with Babylon.js (games, complex scenes) | babylonjs-engine (if installed) |
3D / WebGL |
| VR/AR in the browser (A-Frame, WebXR) | aframe-webxr (if installed) |
3D / WebGL |
| 3D, WebGL/WebGPU, GLB/GLTF models, shaders, particles, configurators, 3D heroes | threejs-webgl (if installed) |
3D / WebGL |
| HTML presentations | slides (if installed) |
Graphic design and brand |
| Banners for social media, ads and heroes | banner-design (if installed) |
Graphic design and brand |
| Logos, icons, corporate identity, mockups (AI generation) | graphic-design (if installed) |
Graphic design and brand |
| Brand voice, visual identity, brand guidelines | brand (if installed) |
Graphic design and brand |
If a needed skill is not installed, say so and propose installing it (/plugin install bundle-core-3d-animation@senzu
or tools/install-skills.ps1 -Bundle …); do not improvise those libraries without their skill.
2b. Minimum reading per task (do not load more)
Section titled “2b. Minimum reading per task (do not load more)”| Task | Read only |
|---|---|
| Landing / marketing page | ui-ux-pro-max/SKILL.md §2 flow + ui-ux-pro-max/references/es/page-patterns.md (pattern) + search.py --design-system |
| Dashboard / admin / table | ui-ux-pro-max/references/es/components-spec.md §Table, §Empty state, §Skeleton + --stack guides |
| Form | components-spec.md §Input, §Form (your stack) + ui-ux-pro-max/references/es/accessibility.md §Formularios |
| Single component | components-spec.md (only that component) + tokens from senzu/design-system/*/MASTER.md |
| Theme / tokens / dark mode | ui-ux-pro-max/references/es/tokens-tailwind.md (your stack’s section) |
| Audit of an existing UI | ui-ux-pro-max/references/es/review-rubric.md |
| Animation | gsap-scrolltrigger/SKILL.md §1 (your stack) + one pattern from gsap-scrolltrigger/references/es/scrolltrigger-patterns.md |
| 3D | threejs-webgl/SKILL.md §1 (your stack) + the ES reference for that integration |
Protocol: one skill per task; SKILL.upstream.md and references by sections (Read offset/limit or Grep), never whole.
3. The project’s design system
Section titled “3. The project’s design system”If senzu/design-system/*/MASTER.md exists, it is the source of truth (and pages/<page>.md takes precedence for that page).
If it does not exist, generate it with ui-ux-pro-max:
python3 ${CLAUDE_SKILL_DIR}/../ui-ux-pro-max/scripts/search.py "<producto industria keywords>" --design-system -p "<Proyecto>" --persist -o senzu# Windows: py -3 ...(As a plugin, the skill lives in ${CLAUDE_PLUGIN_ROOT}/skills/ui-ux-pro-max/.)
4. Hard rules that always apply
Section titled “4. Hard rules that always apply”Contrast 4.5:1 · hover/focus/active/disabled/loading/empty/error states · 375–1440 px without horizontal scroll ·
prefers-reduced-motion · SVG icons (never emojis) · semantic tokens, not loose values · forms with a visible label
and the error next to the field · one H1 per view · images with dimensions and alt · real copy.
Delivery checklist: ui-ux-pro-max/references/pro-rules.md.