🤖 Rules y Skills

NK Next Starter incluye Rules y Skills para que los asistentes de IA trabajen respetando la arquitectura, las decisiones técnicas y los estándares de /nk.studio.

Cursor Rules

Las Rules se encuentran en .cursor/rules y definen criterios que deben aplicarse durante el desarrollo.

Rules disponibles

• Figma to Code: implementación de diseños de Figma en React, TypeScript y Tailwind.
• No Magic Values: centralización de valores técnicos en constantes, tokens o configuraciones.
• Design System: uso de colores, tipografías, breakpoints, espaciados y componentes compartidos.
• Motion Skills: criterios para animaciones, interacciones, GSAP, Lenis y ScrollTrigger.
• Web Quality Skills: selección de skills para performance, accesibilidad, SEO y buenas prácticas.

Algunas Rules se aplican siempre y otras se cargan únicamente cuando la tarea corresponde con su alcance.

Skills

Las Skills se encuentran en .agents/skills y contienen instrucciones, referencias y ejemplos para realizar tareas específicas.

Diseño

• Design System

Animaciones

• Animations
• GSAP
• Loader
• Page Transition

Interacciones

• Marquee
• Magnet

Calidad web

• Accessibility
• Best Practices
• Performance
• Core Web Vitals
• SEO
• Web Quality Audit

Experiencias 3D

• R3F/WebGL

Uso general

Antes de implementar una tarea con IA se debe:

1. Revisar las Rules aplicables.
2. Utilizar la Skill correspondiente a la tarea.
3. Analizar la arquitectura existente.
4. Reutilizar componentes y configuraciones del starter.
5. Implementar únicamente lo solicitado.
6. Verificar el resultado antes de finalizar.

Criterios principales

Las Rules y Skills ayudan a mantener:

• Fidelidad con los diseños de Figma.
• Uso de React, TypeScript y Tailwind.
• Consistencia con el sistema de diseño.
• Organización correcta de componentes.
• Animaciones integradas con la infraestructura existente.
• Uso de assets originales.
• Valores y configuraciones centralizados.
• Accesibilidad.
• Rendimiento.
• SEO.
• Calidad de código.

Las Rules y Skills forman parte del repositorio, por lo que se comparten automáticamente con cualquier desarrollador que clone el proyecto.