# Guía 4.5 — Habilidades de Agente y Comunidad (Skills) ## El ecosistema de automatización cognitiva y gobernanza de código > **Propósito:** Esta guía documenta cómo los agentes de IA resuelven y ejecutan tareas críticas basándose en los skills congelados localmente en el directorio `.agents/skills/`. --- ## 1. ¿Qué son los Skills Congelados? Los **Skills** son directrices operacionales estructuradas en archivos `SKILL.md` que le indican al agente de IA exactamente cómo ejecutar ciertas disciplinas técnicas (como escribir pruebas, auditar seguridad o revisar código) bajo las reglas específicas de Banesco. Al estar ubicadas localmente dentro del repositorio en `.agents/skills/`, garantizan que cualquier agente que trabaje en este proyecto las cargue automáticamente, previniendo la degradación y el olvido de convenciones. --- ## 2. Los 5 Skills Comunitarios Instalados En el proyecto `frontend-ai` contamos con 5 skills core: ### 2.1 Test-Driven Development (`.agents/skills/test-driven-development/SKILL.md`) - **Objetivo:** Escribir pruebas unitarias robustas en frontend (Vitest / Testing Library) antes de dar por completado un componente. - **Enfoque:** Pruebas de renderizado, testing de interactividad (userEvent), mockeo de peticiones fetch y Zustand stores. ### 2.2 Systematic Debugging (`.agents/skills/systematic-debugging/SKILL.md`) - **Objetivo:** Resolver problemas de estado, hidratación ("hydration mismatch") y dependencias rotas de daisyUI. - **Enfoque:** Proceso analítico de 4 fases para aislar el error, reproducir localmente y corregir la causa raíz. ### 2.3 Code Review Excellence (`.agents/skills/code-review-excellence/SKILL.md`) - **Objetivo:** Auditar la calidad del código antes de enviar a PR. - **Enfoque:** Validaciones estrictas contra el checklist de `AGENT.md`, detección de fugas de secretos y estándares de rendimiento. ### 2.4 Documentation Writer (`.agents/skills/documentation-writer/SKILL.md`) - **Objetivo:** Mantener la documentación técnica auto-generada actualizada. - **Enfoque:** Documentación clara de Props TypeScript, estados globales en Zustand y esquemas de API Routes. ### 2.5 Security Best Practices (`.agents/skills/security-best-practices/SKILL.md`) - **Objetivo:** Asegurar el frontend contra vulnerabilidades bancarias comunes. - **Enfoque:** Sanitización de HTML, prevención de XSS, gestión de cookies con flags seguras y encriptación de datos sensibles. --- ## 3. Cómo Activar los Skills en tu Sesión de IA Cuando interactúes con tu agente, puedes pedirle explícitamente que aplique un skill particular: ``` "Agente, implementa el formulario de transferencia y luego activa el skill 'security-best-practices' para validar que no haya fugas de datos y que las cookies se gestionen según los estándares de seguridad." ``` El agente leerá el archivo `.agents/skills/security-best-practices/SKILL.md` y aplicará las directrices precisas durante el desarrollo.