Crear y usar skills

Una skill es una instrucción reutilizable para ejecutar un procedimiento concreto. Dentro del arnés, las skills convierten conocimiento operativo en práctica versionada.

Cuándo crear una skill

Crea una skill cuando se repite un flujo con suficiente frecuencia y detalle como para estandarizarlo.

Buenos candidatos:

• Sincronizar foundations de un Design System.
• Extraer componentes desde diseño.
• Redactar specs siguiendo una estructura común.
• Implementar tareas con validación y actualización de estado.
• Revisar layouts o evidencias con una rutina definida.

Skill, prompt o contexto

No todo debe ser skill.

| Pieza | Uso recomendado | | --- | --- | | Contexto de proyecto | Reglas estables, arquitectura, convenciones y validaciones. | | Prompt puntual | Petición única o exploratoria. | | Skill | Procedimiento repetible con pasos, entradas y salidas claras. | | Agente | Responsabilidad especializada dentro del arnés. |

Qué debe contener una buena skill

• Cuándo se debe usar.
• Qué entradas necesita.
• Qué fuentes debe consultar.
• Qué pasos debe seguir.
• Qué archivos puede modificar.
• Qué validaciones debe ejecutar.
• Qué salida debe producir.
• Qué hacer si encuentra un bloqueo.

Relación con calidad

Una skill no existe para ahorrar escritura. Existe para hacer más consistente un procedimiento que impacta en calidad: specs, guardarraíles, revisión, evidencias o aprendizaje.

Errores habituales

• Crear skills demasiado genéricas.
• Meter en la skill reglas que pertenecen al proyecto.
• No definir criterios de salida.
• No incluir validación.
• No versionar cambios.

Default recomendado

Empieza sin skills si el flujo aún no está claro. Cuando el equipo repita el mismo procedimiento varias veces y detecte variabilidad, conviértelo en skill.