Skills — Índice y referencia técnica
Esta sección es la referencia técnica de todas las skills disponibles en el proyecto NEO. Si
todavía no tenés claro qué es una skill (a diferencia de un playbook), empezá por
Playbooks vs. Skills — esta página asume que ya conocés esa
diferencia y va directo al detalle de cada skill: cuándo se dispara, qué información necesita
para ejecutarse y qué te devuelve.
1. Cómo leer cada ficha
Cada skill tiene su propia ficha, con siempre la misma estructura:
| Campo | Qué significa |
|---|---|
| Cuándo usarla | La situación concreta que dispara esta skill — cuándo tiene sentido invocarla vos directamente, o cuándo un playbook/plan la va a invocar por vos. |
| Inputs requeridos | Los datos sin los cuales la skill no puede arrancar. Si falta alguno, la skill se detiene y lo informa — nunca "inventa" un valor. |
| Inputs opcionales | Datos que cambian o enriquecen el comportamiento, pero que tienen un valor por defecto o un camino alternativo si no vienen. |
| Salida | Lo que la skill entrega al terminar — el resultado concreto que otra skill (o vos) va a usar después. |
| Se encadena con | Qué skill típicamente se ejecuta antes y cuál se ejecuta después, cuando eso está definido. |
Los nombres de campo (
input.algo,config.algo) son técnicos — están pensados para quien arma planes o playbooks. Si le hablás a la skill en lenguaje natural, no necesitás nombrarlos: el asistente los completa por vos a partir de lo que le contás.
2. Las skills agrupadas por uso
Las 39 skills del proyecto se agrupan en 13 categorías, según el tipo de trabajo que resuelven dentro del flujo de QA. Siguen aproximadamente el orden en que actúan dentro de un flujo típico: primero se lee la fuente, después se clasifica/planifica, después se explora o ejecuta, y por último se reporta.
Algunas skills existen específicamente para los modelos de orquestación M2
(Híbrido adaptativo: el asistente clasifica el pedido y elige entre planes ya escritos) y M4
(Declarativo puro: una regla fija, por ejemplo un job de CI, dispara un plan sin que nadie decida en el
momento). A esas las invoca el motor (engine) de NEO dentro de un plan, no una persona, así que
normalmente no vas a necesitar llamarlas a mano.
Skills anidadas = subskills
Las skills que aparecen anidadas debajo de otra en la tabla son subskills: las usa la skill
de la cual dependen para resolver una parte específica de su trabajo — por ejemplo, exportar a una
herramienta concreta (Xray…) o traer la historia desde un sistema concreto. No hace
falta invocarlas directamente: invocás la skill de la que dependen y esa skill elige la subskill
que corresponde según la configuración de qa-stack.yaml o el origen del dato.
Algunas skills resuelven las variantes por herramienta sin subskills: guardan lo propio de
cada herramienta en archivos de referencia dentro de su carpeta (references/) y leen solo el
que corresponde. Es el caso de lippia-neo-report-bug, que publica en Jira, Azure DevOps,
GitHub o GitLab desde una sola skill.
| Categoría | Para qué sirve |
|---|---|
| 📥 Lectura e ingesta | Traer y normalizar la historia de usuario o el bug con el que va a trabajar todo el resto del flujo, sin importar si vive en un archivo local, en Jira o en Azure DevOps. También leer un plan de pruebas ya escrito como datos estructurados.
|
| 🧭 Clasificación y enrutamiento | Decidir, sin intervención humana, qué plan ejecutar frente a un pedido en texto libre (modelo de orquestación M2), y armar el input que ese plan necesita.
|
| ⚙️ Configuración e infraestructura | Dejar un proyecto nuevo listo para trabajar con NEO: detectar su stack técnico y generar el pipeline de CI que ejecuta las pruebas automáticamente. Es lo primero que hay que ejecutar si todavía no se hizo la configuración inicial de NEO en el proyecto (no existe qa-stack.yaml), empezando por lippia-neo-bootstrap-stack.
|
| 🗺️ Planificación de pruebas | Convertir una historia (o un pedido de exploración amplio) en un plan concreto de qué probar: escenarios paso a paso, o un portfolio acotado de charters exploratorios seleccionados según el contexto disponible.
|
| 📤 Exportación de casos de prueba | Normalizar los escenarios de un plan a un formato agnóstico de test case y exportarlos a la herramienta de gestión de tests configurada en test_management (hoy Xray Cloud).
|
| 🔎 Exploración | Navegar la aplicación real (con Playwright MCP) para validar un plan, confirmar si un bug reproduce, o ejecutar una sesión de exploración libre tipo charter, documentando hallazgos con evidencia.
|
| 🧩 Cobertura existente | Antes de generar nada nuevo, averiguar qué ya está cubierto por tests existentes — por historia/bug o por el diff de un PR — y qué escenarios quedan sin cubrir.
|
| ⚡ Ejecución automatizada | Generar la suite de tests ejecutable, ejecutarla, y reparar automáticamente lo que falla por motivos menores (selectores rotos, timeouts, etc.). También reestructurar una suite Gherkin existente para que sea data-driven.
|
| 🚀 Pruebas de performance | Pasar de una colección de API a pruebas de carga: leer la colección, generar scripts k6 o JMeter (smoke, load, stress, spike), ejecutarlos perfil por perfil y redactar el reporte final.
|
| 📊 Reportes | Consolidar los resultados de exploración, generación y ejecución en un documento final, con marca de tiempo y sin pisar reportes anteriores.
|
| 🐞 Gestión de bugs | Convertir los hallazgos de una exploración, reproducción o ejecución en archivos BUG-NNN.json y publicarlos, sin duplicados, en la herramienta configurada (Jira, Azure DevOps, GitHub o GitLab).
|
| 🎬 Orquestación de flujo completo | Meta-skills que encadenan varias de las skills anteriores, en orden fijo, para resolver un flujo de punta a punta en una sola invocación.
|
| ✅ Gobernanza y aprobación humana | Dejar una pausa explícita para que una persona apruebe o rechace un artefacto antes de que el flujo continúe.
|
3. ¿Busco una skill puntual o un playbook?
Ya sé qué paso puntual necesito
Por ejemplo: "solo quiero leer esta historia" o "solo quiero ejecutar y reparar los tests". Buscá la skill en la categoría correspondiente de la tabla de arriba.
Tengo una situación completa que resolver
Un PR, un bug, un deploy, una historia nueva. Probablemente te convenga un playbook, que ya encadena las skills correctas en el orden correcto — con pausas de control humano donde corresponde.
4. Repositorio de las skills
El código fuente de estas skills (los archivos SKILL.md de los que sale esta referencia) vive en
el repositorio NEO-releases:
https://gitlab.crowdaronline.com/lippia/products/neo/neo-releases.git
Si una skill cambia de comportamiento, esta referencia puede quedar desactualizada hasta la próxima
revisión — ante cualquier duda, el SKILL.md original es la fuente de verdad.