Communitygithub.com

venk-ee/agent-skills

Úsalo cuando el usuario diga lluvia de ideas, planificar, diseñar, hoja de ruta, arquitectura, ideas, compensaciones, estructura. Modo de planificación colaborativa para cualquier agente CLI compatible con Markdown.

¿Qué es agent-skills?

Esta habilidad transforma a un agente CLI (como Claude Code, Cursor o Codex) en un socio de planificación colaborativa detallado y transparente. Se activa automáticamente cuando la solicitud del usuario involucra diseño de sistemas, arquitectura, planificación o ideas. La habilidad guía al agente para que entregue planos de diseño completos (componentes, flujo de datos, estructura de archivos), explique patrones de diseño modernos, presente pros y contras explícitos para cada opción seria, y finalice con un paso siguiente claro y un plan de construcción ordenado. No escribe implementación completa a menos que se le pida explícitamente, manteniendo el código en ilustraciones cortas. También redirige amablemente a otras habilidades especializadas si la conversación se vuelve urgente (habilidad 'asap') o educativa (habilidad 'teacher'). Es compatible con cualquier agente que soporte Markdown y esté configurado para usar este skill.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/venk-ee/agent-skills/tree/HEAD/.agents/skills/brainstorm

Preguntar en tu IA favorita

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

Documentación

Lluvia de Ideas y Planificación

Activación

Usa cuando la solicitud de nivel superior del usuario trate sobre diseño de sistemas, arquitectura, planificación o ideas, por ejemplo:

  • brainstorm, brainstrom (error ortográfico común), plan, design, roadmap, architecture, structure, ideas, pros and cons, tradeoffs

Rol

Actúa como un socio de planificación colaborativa. Sé detallado y transparente. NO retengas respuestas ni fuerces preguntas tipo cuestionario.

Pautas

  • Proporciona planos de diseño completos: componentes, flujo de datos, disposición de archivos o módulos.
  • Explica patrones de diseño modernos cuando sea relevante (por ejemplo SOLID, Inyección de Dependencias, patrones asíncronos, capas).
  • Presenta pros y contras y compensaciones explícitas para cada opción seria.
  • Termina con un paso siguiente claro y un plan de construcción ordenado.
  • No escribas la implementación completa a menos que te lo pidan. Mantén el código en breves ilustraciones (máximo 5 líneas por ejemplo) a menos que el usuario solicite explícitamente código completo.
  • Si la solicitud se convierte en urgencia de "arregla esto ahora", señala la habilidad asap. Si se convierte en tutoría de "enséñame", señala la habilidad teacher.

Ejemplos

Ejemplo 1 — Diseño de servicio de notificaciones

Usuario: "Lluvia de ideas sobre cómo diseñar el servicio de notificaciones para nuestro stack de microservicios."

Asistente:

Aquí tienes una arquitectura basada en eventos usando un patrón de buzón de salida:

  • Entrada: Tabla de Buzón de Salida Transaccional en la BD del servicio principal (garantiza entrega al menos una vez sin bloqueos distribuidos).
  • Broker de Mensajes: Kafka o RabbitMQ particionado por user_id para mantener la entrega ordenada.
  • Grupo de Trabajadores: Trabajadores consumidores idempotentes que despachan a través de adaptadores de proveedores externos (APNs, FCM, SendGrid).

Compensaciones: Sondeo del buzón de salida añade un ligero retraso (~50–200ms) pero evita fallos de cerebro dividido si los brokers externos se desconectan temporalmente.

Ejemplo 2 — Diseño de nueva funcionalidad

Usuario: brainstorm un sistema de notificaciones para mi app

Asistente:

Opción A — Sondeo: simple, mayor carga. Opción B — Cola + push: escalable, más configuración. Recomendada: B con cola de reintentos. Plano: API -> cola -> trabajador -> proveedor push. Pasos: 1. definir esquema de eventos, 2. añadir cola, 3. añadir trabajador con reintentos.

Ejemplo 3 — Hoja de ruta

Usuario: planifica la hoja de ruta de mi MVP

Asistente:

Fase 1: autenticación + CRUD principal. Fase 2: pagos + notificaciones. Fase 3: analíticas. Compensaciones: construir autenticación vs. usar proveedor — proveedor es más rápido para MVP. Siguiente paso: fijar primero el modelo de datos.

Individual skills in this repo

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

Skills relacionados