Venom — Tu Experto en Desarrollo de Software

Venom convierte a Claude Code en un equipo completo de desarrollo de software. En lugar de darte respuestas genéricas, Venom investiga, planifica y construye tus proyectos paso a paso con la calidad de un equipo profesional.

¿Qué es Venom?

Imagina que quieres construir una casa. No empezarías poniendo ladrillos al azar: primero buscarías un arquitecto, luego un ingeniero, después los constructores, y finalmente alguien que revise que todo quedó bien.

Venom funciona exactamente igual, pero para crear software. Es como tener un equipo de 6 expertos que te guían paso a paso para crear cualquier proyecto, desde una página web sencilla hasta una aplicación completa. Tú solo describes lo que quieres, y Venom se encarga de investigar cómo hacerlo, crear un plan detallado y construirlo con buenas prácticas.

No necesitas saber programar. Solo necesitas tener una idea.

Requisitos Previos

Antes de instalar Venom, necesitas tener dos cosas en tu computadora:

1. Claude Code

Claude Code es la herramienta de inteligencia artificial donde Venom funciona. Es como el "cerebro" al que Venom le añade superpoderes.

• Instálalo siguiendo las instrucciones oficiales: Instalar Claude Code

2. Node.js (versión 18 o superior)

Node.js es un programa que permite ejecutar herramientas de desarrollo en tu computadora. Venom lo necesita para instalarse.

• Descárgalo gratis desde: nodejs.org
• Recomendación: descarga la versión LTS (la que dice "Recommended For Most Users")

Para usuarios de Windows

Si usas Windows, necesitas una de estas opciones para ejecutar los comandos:

• Git Bash (se instala automáticamente con Git para Windows)
• WSL (Windows Subsystem for Linux, un sistema que permite ejecutar herramientas de Linux dentro de Windows)

Instalación Paso a Paso

Sigue estos pasos en orden. No te saltes ninguno.

Paso 1: Abre tu terminal

• En Mac: busca "Terminal" en Spotlight (presiona Cmd + Espacio y escribe "Terminal")
• En Windows: abre Git Bash o WSL
• En Linux: busca "Terminal" en tus aplicaciones

Paso 2: Ejecuta el comando de instalación

Copia y pega este comando en tu terminal y presiona Enter:

npx @cubait/venom-cc install

¿Qué hace este comando? Descarga Venom y lo configura de forma global para que funcione en todos tus proyectos automáticamente.

Verás mensajes en la pantalla indicando el progreso. Espera a que termine.

Paso 3: Reinicia Claude Code

Cierra Claude Code completamente y vuelve a abrirlo. Esto es necesario para que reconozca a Venom.

Paso 4: Verifica la instalación

Abre Claude Code y escribe:

Hola, ¿tienes las habilidades de Venom disponibles?

Si Venom está instalado correctamente, Claude mencionará las habilidades disponibles como "brainstorming", "writing-plans" o "subagent-driven-development".

Instalación por Proyecto (Local)

Si prefieres que Venom solo esté disponible en un proyecto específico (en lugar de todos tus proyectos), usa el flag --local:

cd ~/mi-proyecto
npx @cubait/venom-cc install --local

Esto instala Venom dentro del directorio .claude/ de tu proyecto. Solo estará activo cuando Claude Code se ejecute desde ese directorio.

¿Cuándo usar --local? Cuando trabajas con equipos y quieres que Venom sea parte de la configuración del proyecto, o cuando quieres probar Venom en un proyecto específico sin afectar los demás.

Verificar que Todo Funciona

Para confirmar que Venom está listo:

1. Abre Claude Code
2. Escribe: /brainstorm seguido de una idea simple, por ejemplo: "quiero crear una lista de tareas"
3. Si Venom funciona, Claude empezará a hacerte preguntas para entender mejor tu idea en lugar de empezar a programar directamente

Señal de que funciona: Claude te hace preguntas antes de escribir código. Eso es Venom trabajando.

Señal de que NO funciona: Claude empieza a escribir código inmediatamente sin preguntar nada. En ese caso, revisa la sección de "Solución de Problemas" más abajo.

Tu Primer Proyecto con Venom

Vamos a crear un proyecto juntos. Supongamos que quieres una página web personal.

Paso 1: Cuéntale tu idea

Abre Claude Code y escribe:

/brainstorm Quiero crear una página web personal con mi nombre, una foto y enlaces a mis redes sociales

Venom te hará preguntas como: "¿Qué colores prefieres?", "¿Quieres que sea responsive (que se vea bien en celulares)?", "¿Qué redes sociales quieres incluir?"

Paso 2: Deja que Venom cree un plan

Una vez que Venom entienda tu idea, escribe:

/write-plan

Venom creará un documento detallado con todos los pasos necesarios para construir tu página, como una receta de cocina paso a paso.

Paso 3: Construye tu proyecto

Cuando el plan esté listo, escribe:

/build

Venom empezará a construir tu proyecto siguiendo el plan. Trabajará por bloques, revisando la calidad de cada parte antes de avanzar a la siguiente.

Los 3 Comandos que Necesitas

Estos son los únicos comandos que necesitas recordar. Funcionan en orden, como los pasos para cocinar una receta:

| Comando | ¿Qué hace? | Analogía | |---------|-------------|----------| | /brainstorm | Cuéntale tu idea a Venom. Él te hará preguntas para entenderla mejor y diseñar una solución. | Es como la primera reunión con un arquitecto: le cuentas qué quieres y él te hace preguntas. | | /write-plan | Venom crea un plan detallado de construcción con todos los pasos necesarios. | Es como el plano de una casa: describe qué se va a construir y en qué orden. | | /build | Venom construye tu proyecto siguiendo el plan, revisando la calidad en cada paso. | Es como el equipo de construcción que sigue el plano y revisa cada etapa. |

Flujo completo:

Tu idea → /brainstorm → /write-plan → /build → Proyecto terminado

¿Qué Incluye Venom?

6 Agentes Especializados

Piensa en los agentes como miembros de un equipo de trabajo. Cada uno tiene una especialidad diferente:

| Agente | ¿Qué hace? | |--------|-------------| | Investigador | Busca información actualizada sobre tecnologías antes de empezar a construir, como un asistente que lee los manuales por ti. | | Implementador | Escribe el código de tu proyecto siguiendo buenas prácticas, como un programador que siempre prueba su trabajo antes de entregarlo. | | Tester | Intenta encontrar errores y problemas en lo que se construyó, como un inspector de calidad que revisa cada detalle. | | Arquitecto | Analiza cómo debe organizarse tu proyecto antes de empezar a construir, como un ingeniero que diseña la estructura. | | Debugger | Investiga y soluciona problemas de manera sistemática, como un detective que busca la causa raíz de un error. | | Revisor de Código | Revisa el trabajo terminado para asegurar que cumple con los estándares de calidad, como un supervisor de obra. |

Venom elige automáticamente qué agente usar en cada momento. No necesitas seleccionarlos manualmente.

22 Habilidades Incluidas

Las habilidades son técnicas especializadas que Venom usa automáticamente. Están organizadas por categoría:

Crear y Planificar

• Brainstorming — Refina tus ideas con preguntas inteligentes antes de empezar
• Escribir planes — Crea planes de construcción detallados paso a paso
• Ejecutar planes — Construye siguiendo el plan con puntos de revisión
• Idea Translator — Transforma ideas vagas en especificaciones técnicas claras
• Prompt Engineering — Diseña, testea y optimiza prompts para features de IA, skills internos o cualquier tarea con LLMs

Investigar

• Integración MCP — Busca documentación actualizada de cualquier tecnología
• Web Scraping — Extrae contenido completo de sitios web y documentación con FireCrawl
• Usando Venom — Guía de inicio que asegura que se investigue antes de programar
• Getting Started — Onboarding para principiantes: guía paso a paso para tu primer proyecto

Construir

• Desarrollo por sub-agentes — Asigna tareas específicas a agentes frescos para mayor calidad
• Desarrollo en equipo — Coordina múltiples agentes trabajando en paralelo
• Agentes paralelos — Ejecuta varias tareas independientes al mismo tiempo
• Monitoreo en vivo — Supervisa el servidor de desarrollo y verifica la interfaz visual en tiempo real

Probar y Verificar

• Desarrollo guiado por pruebas — Escribe las pruebas antes del código para garantizar calidad
• Depuración sistemática — Encuentra la causa raíz de los errores con un proceso de 4 fases
• Verificación antes de completar — Confirma con evidencia que todo funciona antes de dar por terminado

Revisar y Entregar

• Solicitar revisión de código — Envía el trabajo a revisión antes de entregarlo
• Recibir revisión de código — Evalúa las sugerencias de revisión con criterio técnico
• Git Worktrees — Crea espacios de trabajo aislados para desarrollar sin afectar el proyecto principal
• Finalizar rama — Guía la decisión de cómo integrar el trabajo terminado
• Escribir habilidades — Permite crear nuevas habilidades personalizadas para Venom
• Recuperación de contexto — Restaura automáticamente el progreso cuando Claude pierde contexto por compactación

Persistencia de Contexto

Venom incluye un sistema automático de checkpoints que guarda el progreso de tu sesión. Si Claude Code pierde el contexto (por compactación de memoria o reinicio), Venom puede recuperar:

• La fase actual y progreso del proyecto
• Tareas completadas y pendientes
• Decisiones clave tomadas durante la sesión
• Archivos modificados y errores encontrados

Esto funciona automáticamente — no necesitas hacer nada. Si alguna vez necesitas recuperar el contexto manualmente, simplemente dile a Claude: "recupera el contexto de la sesión anterior".

Comandos CLI

| Comando | Descripción | |---------|-------------| | npx @cubait/venom-cc install | Instalar globalmente (todos los proyectos) | | npx @cubait/venom-cc install --local | Instalar en el proyecto actual | | npx @cubait/venom-cc uninstall | Desinstalar instalación global | | npx @cubait/venom-cc uninstall --local | Desinstalar del proyecto actual | | npx @cubait/venom-cc doctor | Diagnóstico de la instalación | | npx @cubait/venom-cc setup-firecrawl | Configurar FireCrawl MCP para web scraping |

Comandos dentro de Claude Code

Además de los 3 comandos principales (/brainstorm, /write-plan, /build), Venom incluye:

| Comando | Descripción | |---------|-------------| | /venom:prompt | Diseña, testea y optimiza prompts para IA | | /venom:scrape | Extrae contenido completo de URLs con FireCrawl |

Solución de Problemas

"npx: command not found"

Esto significa que Node.js no está instalado o no se configuró correctamente.

Solución:

1. Descarga e instala Node.js desde nodejs.org (versión LTS)
2. Cierra y vuelve a abrir tu terminal
3. Escribe node --version para verificar — deberías ver algo como v18.x.x o superior
4. Intenta de nuevo: npx @cubait/venom-cc install

"El plugin no se activa"

Claude Code no reconoce a Venom después de instalarlo.

Solución:

1. Cierra Claude Code completamente (no solo minimizar la ventana)
2. Vuelve a abrir Claude Code
3. Verifica que el plugin está registrado:

   CLAUDECODE= claude plugin list

   Deberías ver venom@venom-cc en la lista.
4. Si no aparece, desinstala y vuelve a instalar:

   npx @cubait/venom-cc uninstall
   npx @cubait/venom-cc install

"Permission denied" (Permiso denegado)

El sistema no permite que Venom se instale porque no tienes los permisos necesarios.

Solución en Mac/Linux:

sudo npx @cubait/venom-cc install

(Te pedirá tu contraseña. Al escribirla no verás nada en pantalla; eso es normal.)

Solución en Windows:

• Abre Git Bash o tu terminal como Administrador (clic derecho > "Ejecutar como administrador")

"Hook not running" (El hook no se ejecuta)

Los hooks son pequeños programas que Venom ejecuta automáticamente al inicio de cada sesión.

Solución:

1. Verifica que Bash está disponible en tu sistema:

   bash --version

2. En Windows, asegúrate de estar usando Git Bash o WSL
3. Ejecuta el diagnóstico para verificar hooks:

   npx @cubait/venom-cc doctor

Solución general

Si ninguna de las soluciones anteriores funciona:

1. Desinstala completamente: npx @cubait/venom-cc uninstall
2. Verifica tu versión de Node.js: node --version (necesitas 18 o superior)
3. Reinstala: npx @cubait/venom-cc install
4. Reinicia Claude Code
5. Si el problema persiste, reporta un issue en: github.com/goat1990/venom-cc/issues

Desinstalar

Si quieres eliminar Venom completamente de tu computadora:

# Desinstalar instalación global
npx @cubait/venom-cc uninstall

# Desinstalar instalación local (desde el directorio del proyecto)
npx @cubait/venom-cc uninstall --local

Esto eliminará todos los archivos de Venom. Claude Code volverá a funcionar normalmente sin las habilidades adicionales.

Preguntas Frecuentes

¿Necesito saber programar para usar Venom?

No. Venom está diseñado para que cualquier persona pueda crear software. Tú describes lo que quieres en lenguaje natural (como si hablaras con una persona) y Venom se encarga del resto. Dicho esto, si sabes programar, Venom te hará mucho más productivo.

¿Qué tipo de proyectos puedo crear?

Prácticamente cualquiera: páginas web, aplicaciones móviles, herramientas de automatización, APIs (programas que conectan servicios entre sí), juegos, bots, sistemas de gestión... Si se puede programar, Venom puede ayudarte a construirlo.

¿Es gratis?

Sí. Venom es software de código abierto con licencia MIT, lo que significa que es completamente gratuito para cualquier uso, incluyendo proyectos comerciales. Sin embargo, necesitas una suscripción activa de Claude Code para poder usarlo, ya que Venom funciona dentro de Claude Code.

¿Funciona en Windows, Mac y Linux?

Sí. Venom funciona en los tres sistemas operativos. En Windows necesitas Git Bash o WSL para ejecutar los comandos de instalación.

¿En qué se diferencia Venom de usar Claude Code sin plugins?

Claude Code sin Venom es como un programador que trabaja solo y empieza a escribir código inmediatamente. Con Venom, es como tener un equipo organizado que primero investiga, luego planifica, después construye, y finalmente revisa — igual que lo haría un equipo profesional de desarrollo.

¿Puedo instalar Venom solo en un proyecto específico?

Sí. Usa el flag --local para instalar Venom solo en el proyecto actual:

cd ~/mi-proyecto
npx @cubait/venom-cc install --local

Venom solo estará activo cuando Claude Code se ejecute desde ese directorio.

¿Qué es FireCrawl y cómo lo configuro?

FireCrawl es un servicio opcional que permite a Venom extraer contenido completo de sitios web (documentación, datos estructurados, etc.). Para configurarlo:

npx @cubait/venom-cc setup-firecrawl

Necesitas una API key gratuita de firecrawl.dev (500 créditos/mes gratis). Si no lo configuras, Venom seguirá funcionando normalmente pero sin la capacidad de scraping profundo.

Créditos y Licencia

Venom es un fork (una versión derivada) de Superpowers creado por Jesse Vincent. Venom se enfoca exclusivamente en Claude Code y añade agentes especializados, un flujo de trabajo basado en investigación, y distribución vía NPM.

Licencia MIT — puedes usar, copiar, modificar y distribuir este software libremente. Consulta el archivo LICENSE para los detalles completos.

• Trabajo original: Copyright (c) 2025 Jesse Vincent
• Modificaciones: Copyright (c) 2026 cubait

Enlaces

• Reportar problemas: github.com/goat1990/venom-cc/issues
• Paquete NPM: npmjs.com/package/@cubait/venom-cc
• Código fuente: github.com/goat1990/venom-cc