Sistema de Skills

Las Skills son paquetes de conocimiento modular que permiten a la IA ejecutar tareas complejas con alta precisión.

Skills Disponibles

🏗️ Arquitectura y DevOps (Root)

Skill	Descripción
docker-floutic	Comandos esenciales, debugging de contenedores y gestión de volúmenes.
git-flow-floutic	Convenciones de commits, ramas y pull requests.
docs-sync	Herramientas para sincronizar código y documentación.
skill-creator	Guía para crear nuevas skills estandarizadas.
skill-sync	Sincronización de metadatos de skills.
delta-specs-floutic	Sistema de especificaciones incrementales (ADDED/MODIFIED/REMOVED) para cambios arquitectónicos.

🎨 Frontend (UI/UX)

Skill	Descripción
astro-floutic	Componentes Astro, layouts, SSR vs Prerender.
design-system-floutic	Sistema visual de Floutic: colores por rol, iconografía, patrones de componentes y reglas UI/UX.
tailwind-3-floutic	Implementación técnica en Tailwind v3: utilidades, cn(), responsive, dark mode y acoplamiento con design system.
playwright-floutic	Tests E2E, Page Objects, ejecución con Docker, selectores.
vitest-floutic	Tests unitarios para componentes React.
zod-3-floutic	Validación de esquemas y formularios.
typescript-floutic	Patrones estrictos y mejores prácticas TypeScript.
forms-floutic	Catálogo centralizado de formularios y campos compartidos (estimated_duration, urgency, etc.).

⚙️ Backend (API/DB)

Skill	Descripción
fastapi-floutic	Creación de endpoints, dependencias y manejo de errores.
sqlalchemy-async-floutic	Consultas asíncronas a base de datos.
alembic-floutic	Migraciones de base de datos y resolución de conflictos.
pytest-floutic	Tests backend con fixtures, mocking, parametrize y async.
pydantic-floutic	Modelado de datos y serialización.
backend-performance-floutic	Optimización de rendimiento: evitar bloqueos en event loop, N+1 queries, bulk inserts.

🚀 Performance y SEO

Skill	Descripción
react-performance-floutic	Optimización de renderizado React, memoización, prevención de re-renders innecesarios.
web-vitals-floutic	Core Web Vitals (LCP, CLS, INP), carga inicial, optimización de imágenes y fuentes en Astro.
seo-floutic	Auditoría SEO, meta tags, schema markup, validación con Playwright.

✅ Calidad y Verificación

Skill	Descripción
refactor-verification-floutic	Checklist obligatorio antes de commits de refactorización (TypeScript check, referencias, tests).
error-contract-floutic	Estándar de gestión de errores de dominio (código + mensaje) para backend y frontend.
error-display-floutic	Patrones de display de errores en formularios: componentes, hooks y estilos.

Autoinvocación

El sistema utiliza un mecanismo de "Autoinvocación" configurado en los archivos AGENTS.md. Cuando la IA detecta una intención específica (ej. "crear tabla"), automáticamente consulta la skill relevante (alembic-floutic) antes de generar código.

Reglas Prácticas por Dominio

UI Frontend:

• Decisión visual (roles, estados, componentes, iconografía) → design-system-floutic
• Implementación CSS utilitaria (clases, responsive, cn(), dark mode) → tailwind-3-floutic

Performance:

• Renderizado React (memoización, re-renders) → react-performance-floutic
• Carga inicial/Web Vitals (LCP, CLS, imágenes) → web-vitals-floutic

Calidad:

• Antes de commit de refactorización → refactor-verification-floutic
• Modificar formularios o campos compartidos → forms-floutic

Documentación:

• Cambios arquitectónicos → delta-specs-floutic

Esto asegura que siempre se sigan las mejores prácticas, incluso si el usuario no las especifica explícitamente.

Relación con comandos

Algunos comandos de alto nivel exigen skills específicas antes de ejecutarse:

• /commit → git-flow-floutic
• /context → reglas de MVI y estructura de contexto
• /test → estándares de testing del proyecto
• /tdd → flujo Red→Green→Refactor

Esto mantiene consistencia y evita saltarse pasos críticos.

Aprendizaje Continuo

El sistema incluye un mecanismo de aprendizaje en ai/skills/learned/continuous-learning.json que:

• Captura patrones descubiertos durante sesiones
• Registra soluciones a errores recurrentes
• Documenta decisiones arquitectónicas
• Se integra con hooks de sesión

Creación de Nuevas Skills

Para añadir nuevas capacidades al equipo de IA:

1. Crear carpeta en /ai/skills/nombre-skill.
2. Crear archivo SKILL.md usando el template de skill-creator.
3. Ejecutar ai/skills/skill-sync/assets/sync.sh para registrarla en el sistema.

Responsable recomendado: OpenRepoManager (mantiene la infraestructura de skills y su sincronización).