---

description: "Crear o evolucionar skills, agentes y prompts del ecosistema agéntico con stack y seguridad obligatorios (sin código de aplicación)" argument-hint: "objetivo, alcance y restricciones de la skill"

Nombre de archivo: crear-skill.md

Ubicación de archivo: .claude/commands/crear-skill.md

Descripción: Comando Claude Code para crear skills y tríadas de customizations en LAS-FOCAS

Crea una skill nueva o una tríada de customizations (agent + prompt + skill). Argumento requerido: $ARGUMENTS (objetivo, alcance y restricciones; por ejemplo: "skill para módulo web con reglas XSS/CORS/Pydantic y anti-legacy").

Restricción principal

Este comando no escribe código de aplicación. Su salida son reglas, prompts, guardrails y criterios para que otros agentes implementen código.

Objetivo

• estructurar el pedido antes de escribir archivos
• inspeccionar customizations existentes para evitar duplicaciones
• definir responsabilidades claras entre agente, prompt y skill
• inyectar stack, seguridad y calidad de forma obligatoria
• generar criterios de aceptación verificables

Flujo de trabajo

1. Determinar si el pedido requiere:
   • solo SKILL.md
   • prompt + skill
   • agent + prompt + skill
2. Revisar archivos existentes en .github/agents/, .github/prompts/, .github/skills/, .claude/commands/ y AGENTS.md.
3. Proponer arquitectura mínima y explícita: nombre de carpeta, naming final, archivos a crear o actualizar, responsabilidad de cada archivo.
4. Inyectar el bloque tecnológico obligatorio, reglas de seguridad y criterios universales.
5. Crear o actualizar los archivos necesarios en .github/ (fuente de verdad) y propagar a .claude/commands/ si corresponde.
6. Validar frontmatter, coherencia de descripciones, enlaces y prohibiciones legacy.
7. Actualizar AGENTS.md y CLAUDE.md si el ecosistema agéntico cambia.

Contexto Tecnológico Obligatorio (inyectar en toda skill de desarrollo)

- Frontend obligatorio: Vue 3 (Composition API) + Vite + TypeScript + CSS modular con tokens.
- Backend obligatorio: FastAPI + Pydantic + SQLAlchemy + Alembic + PostgreSQL.
- Arquitectura obligatoria: SPA pura; comunicación exclusivamente por API REST (JSON) y WebSocket.
- Prohibido para nuevas implementaciones: UI en Vanilla JS, manipulación directa del DOM como patrón principal, templates Jinja para render de frontend.

Reglas de Seguridad Obligatorias (inyectar en toda skill de desarrollo)

1. XSS en Vue 3: evitar v-html con contenido no confiable; si se usa HTML dinámico, exigir sanitización documentada.
2. CORS en FastAPI: allowlist estricta; prohibido comodín en producción.
3. Validación Pydantic: modelos tipados para entrada/salida; rechazo de payloads inválidos.
4. API y sesión: controles de autenticación/autorización consistentes con el módulo.
5. Manejo de secretos: uso de variables de entorno, sin hardcodeo ni exposición en logs.

Criterios Universales de Aceptación (inyectar en toda skill)

• [ ] Arquitectura alineada al stack vigente y sin prácticas legacy
• [ ] Seguridad aplicada y verificable (XSS, CORS, validación de datos)
• [ ] Plan de pruebas mínimo y cobertura esperada para módulos nuevos
• [ ] Logging, observabilidad y manejo de errores definidos
• [ ] Documentación relacionada actualizada
• [ ] Dependencias e imágenes versionadas sin comodines ni latest

Separación de responsabilidades

• Agente (.github/agents/*.agent.md): análisis, diseño, edición y validación.
• Prompt (.github/prompts/*.prompt.md + .claude/commands/*.md): contrato de entrada, pasos y criterios.
• Skill (.github/skills/*/SKILL.md + .codex-skills/skills/*/SKILL.md): workflow invocable y reutilizable.

Plantilla mínima de salida

## Contexto
- [hecho relevante]

## Arquitectura propuesta
- [archivo]: [responsabilidad]

## Pasos de implementación
1. [paso]

## Criterios de aceptación
- [ ] [criterio verificable]

## Riesgos o notas
- [riesgo real o no aplica]

Reglas obligatorias

1. No inventar requisitos ni validaciones no pedidas.
2. Priorizar referencias y enlaces sobre bloques duplicados.
3. Mantener nombres consistentes con rutas y convención del repo.
4. Prohibir explícitamente directivas legacy en toda skill de desarrollo nueva.
5. Todas las salidas deben quedar en .md y en español.
6. Propagar cambios a los tres entornos: .github/, .gemini/, .codex-skills/ y .claude/commands/.

Salida esperada

1. Arquitectura propuesta.
2. Archivos creados o actualizados con ubicación explícita.
3. Contexto tecnológico obligatorio inyectado.
4. Criterios universales de aceptación cubiertos.
5. Documentación relacionada actualizada o pendiente explicitada.