Communitygithub.com

Lev-it/lev-skills

Sesión interactiva de QA donde el usuario informa errores o problemas de forma conversacional y el agente crea issues en GitHub. Explora el código base en segundo plano para obtener contexto y lenguaje del dominio. Úsalo cuando el usuario quiera reportar errores, hacer QA, crear issues de forma conversacional o mencionar 'sesión de QA'.

¿Qué es lev-skills?

Esta habilidad convierte al agente en un interlocutor de QA interactivo, permitiendo que los usuarios reporten problemas de forma conversacional mientras el agente explora el código base en segundo plano para comprender el lenguaje del dominio y el contexto. El agente escucha, formula preguntas mínimas para aclarar, evalúa si el problema es único o debe dividirse en varios issues independientes, y luego los crea en GitHub usando `gh issue create` sin necesidad de revisión previa del usuario. Los issues se redactan desde la perspectiva del usuario, son duraderos (resistentes a refactorizaciones), incluyen pasos de reproducción obligatorios y evitan referencias a archivos o números de línea. La habilidad maximiza la paralelización al dividir problemas complejos en issues pequeños que pueden ser abordados por diferentes desarrolladores o agentes simultáneamente, y soporta dependencias entre issues. Es útil para equipos de desarrollo que desean una forma natural de reportar bugs y agilizar el proceso de QA directamente desde una conversación.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Lev-it/lev-skills/tree/HEAD/.claude/skills/qa

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Sesión de QA

Ejecuta una sesión interactiva de QA. El usuario describe los problemas que está encontrando. Tú aclaras, exploras el código base para obtener contexto y creas issues en GitHub que sean duraderos, centrados en el usuario y que utilicen el lenguaje de dominio del proyecto.

Por cada issue que el usuario plantea

1. Escucha y aclara ligeramente

Deja que el usuario describa el problema con sus propias palabras. Haz como máximo 2-3 preguntas cortas de aclaración centradas en:

  • Qué esperaba vs qué ocurrió realmente
  • Pasos para reproducir (si no son obvios)
  • Si es consistente o intermitente

No entrevistes en exceso. Si la descripción es lo suficientemente clara para crear el issue, continúa.

2. Explora el código base en segundo plano

Mientras hablas con el usuario, inicia un Agente (subagent_type=Explore) en segundo plano para comprender el área relevante. El objetivo NO es encontrar una solución, sino:

  • Aprender el lenguaje de dominio utilizado en esa área (revisa UBIQUITOUS_LANGUAGE.md)
  • Entender qué se supone que hace la funcionalidad
  • Identificar el límite del comportamiento visible para el usuario

Este contexto te ayuda a escribir un mejor issue, pero el issue en sí NO debe hacer referencia a archivos específicos, números de línea o detalles internos de implementación.

3. Evalúa el alcance: ¿issue único o desglose?

Antes de crear el issue, decide si se trata de un issue único o si es necesario desglosarlo en varios issues.

Desglosa cuando:

  • La solución abarca múltiples áreas independientes (por ejemplo, "la validación del formulario está mal, Y falta el mensaje de éxito, Y la redirección está rota")
  • Hay preocupaciones claramente separables en las que diferentes personas podrían trabajar en paralelo
  • El usuario describe algo que tiene múltiples modos o síntomas de fallo distintos

Mantén como un solo issue cuando:

  • Es un comportamiento incorrecto en un solo lugar
  • Todos los síntomas son causados por el mismo comportamiento raíz

4. Crea el/los issue(s) de GitHub

Crea los issues con gh issue create. NO le pidas al usuario que revise primero — simplemente crea y comparte las URLs.

Los issues deben ser duraderos — deben tener sentido incluso después de refactorizaciones importantes. Escribe desde la perspectiva del usuario.

Para un issue único

Usa esta plantilla:

## Qué ocurrió

[Describe el comportamiento real que experimentó el usuario, en lenguaje sencillo]

## Qué esperaba

[Describe el comportamiento esperado]

## Pasos para reproducir

1. [Pasos concretos y numerados que un desarrollador pueda seguir]
2. [Usa términos de dominio del código base, no nombres de módulos internos]
3. [Incluye entradas relevantes, banderas o configuración]

## Contexto adicional

[Cualquier observación adicional del usuario o de la exploración del código base que ayude a enmarcar el issue — por ejemplo, "esto solo ocurre al usar la capa Docker, no la capa de sistema de archivos" — usa lenguaje de dominio pero no cites archivos]

Para un desglose (varios issues)

Crea los issues en orden de dependencia (los bloqueantes primero) para que puedas hacer referencia a números de issue reales.

Usa esta plantilla para cada sub-issue:

## Issue padre

#<número-del-issue-padre> (si creaste un issue de seguimiento) o "Reportado durante sesión de QA"

## Qué está mal

[Describe este problema de comportamiento específico — solo esta parte, no todo el informe]

## Qué esperaba

[Comportamiento esperado para esta parte específica]

## Pasos para reproducir

1. [Pasos específicos para ESTE issue]

## Bloqueado por

- #<número-de-issue> (si este issue no se puede solucionar hasta que se resuelva otro)

O "Ninguno — se puede empezar de inmediato" si no hay bloqueantes.

## Contexto adicional

[Cualquier observación adicional relevante para esta parte]

Al crear un desglose:

  • Prefiere muchos issues delgados sobre pocos gruesos — cada uno debe ser independientemente solucionable y verificable
  • Marca las relaciones de bloqueo honestamente — si el issue B realmente no se puede probar hasta que el issue A esté solucionado, dilo. Si son independientes, marca ambos como "Ninguno — se puede empezar de inmediato"
  • Crea issues en orden de dependencia para que puedas hacer referencia a números de issue reales en "Bloqueado por"
  • Maximiza el paralelismo — el objetivo es que varias personas (o agentes) puedan tomar diferentes issues simultáneamente

Reglas para todos los cuerpos de issue

  • Sin rutas de archivo ni números de línea — estos quedan obsoletos
  • Usa el lenguaje de dominio del proyecto (revisa UBIQUITOUS_LANGUAGE.md si existe)
  • Describe comportamientos, no código — "el servicio de sincronización falla al aplicar el parche" no "applyPatch() lanza excepción en la línea 42"
  • Los pasos de reproducción son obligatorios — si no puedes determinarlos, pregúntale al usuario
  • Sé conciso — un desarrollador debería poder leer el issue en 30 segundos

Después de crear, imprime todas las URLs de los issues (con las relaciones de bloqueo resumidas) y pregunta: "¿Siguiente issue o hemos terminado?"

5. Continúa la sesión

Sigue hasta que el usuario diga que ha terminado. Cada issue es independiente — no los agrupes.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Lev-it/lev-skills

Ask which skill or flow fits your situation. A router over the user-invoked skills in this repo.

Lev-it/lev-skills

Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. Trained for minimalist, cinematic, editorial, dark-tech, luxury, cultural, security, gaming, developer-tool, and consumer-app brand systems. Optimized for intentional logo concepting, refined composition, sparse typography, strong symbolic meaning, premium mockups, art-directed imagery, and flexible grid layouts.

Lev-it/lev-skills

Compact the current conversation into a handoff document for another agent to pick up.

Lev-it/lev-skills

Ink terminal renderer for json-render that turns JSON specs into interactive terminal UIs. Use when working with @json-render/ink, building terminal UIs from JSON, creating terminal component catalogs, or rendering AI-generated specs in the terminal.

Lev-it/lev-skills

Facilitate a structured sprint retrospective — what went well, what didn't, and prioritized action items with owners and deadlines. Use when running a retrospective, reflecting on a sprint, creating action items from team feedback, or learning how to run effective retros.

Lev-it/lev-skills

Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/PRD asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".

Lev-it/lev-skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Lev-it/lev-skills

Teach the user a new skill or concept, within this workspace.

Lev-it/lev-skills

Turn the current conversation into a PRD and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

Lev-it/lev-skills

Move issues through a state machine of triage roles — categorise, reproduce, grill if needed, and write agent-ready briefs.

Lev-it/lev-skills

Create product backlog items in Why-What-Acceptance format — independent, valuable, testable items with strategic context. Use when writing structured backlog items, breaking features into work items, or using the WWA format.

Skills relacionados