Skynex Skills
joeldevz/skynex
Orquestrador com sub-agentes especializados para código sem perda de contexto
Ver no GitHubAgente orquestrador que delega tarefas a sub-agentes especializados, mantendo contexto fresco e estruturado. Resolve perda de contexto em conversas longas com IA de código através de planejamento explícito, revisão gateada e memória persistente (Neurox) entre sessões.
Instalação
npx convez-ai joeldevz/skynex1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Implementar features complexas em múltiplas etapas sem degradação de contexto
- Manter histórico de decisões e padrões entre diferentes conversas
- Revisar e validar código antes de commit com quality gates estruturados
Veredito

Solução prática para o problema real de agentes IA perderem coerência em projetos longos. A arquitetura delegate-first com planos explícitos e memória persistente é clara e bem-fundamentada; funciona com Claude Code e OpenCode.
README
A tradução para o português deste README ainda está na fila.
Skills
Dale a tu agente de IA un equipo de sub-agentes especializados y un flujo de trabajo profesional.
Un solo instalador. Funciona con Claude Code y OpenCode.
Quick Start · Como funciona · Commands · Herramientas soportadas · Modos de trabajo · Instalacion · Docs
El Problema
Los asistentes de IA para codigo son potentes, pero fallan con features complejas:
- Sobrecarga de contexto — Conversaciones largas llevan a compresion, detalles perdidos, alucinaciones
- Sin estructura — "Implementa login con JWT" produce resultados impredecibles
- Sin gate de revision — El codigo se escribe antes de que alguien acuerde que construir
- Sin memoria — Las decisiones viven en el historial del chat que desaparece
La Solucion
Skills es un workflow portable de planificacion y ejecucion donde un orquestador liviano delega todo el trabajo real a agentes especializados. Cada agente arranca con contexto fresco, ejecuta una tarea acotada, y devuelve un resultado estructurado.
TU: "Quiero agregar export CSV a la app"
ORQUESTADOR (delega, contexto minimo):
→ lanza PLANNER → retorna: discovery + PLAN.md
→ te muestra el plan, vos apruevas
→ lanza CODER → retorna: paso 1 implementado
→ te muestra el diff, vos revisas
→ lanza CODER → retorna: paso 2 implementado
→ ...hasta completar el plan
→ /review → quality gate final
→ /commit + /pr → entrega limpia
La clave: el orquestador NUNCA hace trabajo real directamente. Delega a sub-agentes, trackea estado en PLAN.md, y sintetiza resumenes. Esto mantiene el hilo principal liviano y estable.
Neurox como sistema de memoria persistente entre sesiones — las decisiones, patrones y descubrimientos sobreviven entre conversaciones.
Como funciona
Tres conceptos:
-
Arquitectura delegate-first — Tu agente principal se convierte en orquestador y delega todo a sub-agentes especializados. Cada uno recibe contexto fresco, hace trabajo acotado, y devuelve solo un resumen. Ver agentes →
-
Command-driven workflow — Un flujo estructurado con comandos de discovery, validacion y entrega. Cada fase es un skill que cualquier agente puede correr. Ver commands →
-
Memoria persistente — Neurox guarda decisiones, bugs, patrones y preferencias. El orquestador los consulta automaticamente al empezar cada sesion. Ver memoria →
Quick Start
macOS / Linux
curl -fsSL https://raw.githubusercontent.com/joeldevz/skynex/main/scripts/install.sh | bash
Windows (PowerShell)
irm https://raw.githubusercontent.com/joeldevz/skynex/main/scripts/install.ps1 | iex
Homebrew (macOS / Linux)
brew tap joeldevz/tap
brew install skynex
Go install (cualquier plataforma con Go 1.23+)
go install github.com/joeldevz/skynex/cmd/skynex@latest
Una vez instalado:
# Interactivo (recomendado la primera vez)
skynex install
# Solo Claude Code
skynex install --package skills --target claude
# Solo OpenCode
skynex install --package skills --target opencode
# Todo (skills + neurox)
skynex install --package skills --package neurox --target both
El setup hace backup de tu configuracion existente antes de escribir.
Para instalacion manual, verificacion post-instalacion, y troubleshooting, ver docs/installation.md.
Skynex CLI
skynex es el CLI unificado para instalar, configurar y lanzar tu entorno de agentes.
Comandos principales
| Comando | Que hace |
|---|---|
skynex install | Instalador interactivo (TUI) |
skynex update [package] | Actualiza paquetes instalados a la ultima version |
skynex status | Dashboard: paquetes instalados, perfiles, herramientas |
skynex doctor | Diagnostico del entorno y dependencias |
skynex up [profile] | Lanza OpenCode con un perfil de modelos |
Perfiles de modelos
Los perfiles permiten lanzar OpenCode con diferentes configuraciones de modelos sin tocar opencode.json.
# Listar perfiles disponibles
skynex profile list
# Crear un perfil custom
skynex profile create
# Editar un perfil
skynex profile backend edit
# Eliminar un perfil
skynex profile backend delete
# Establecer perfil por defecto
skynex profile backend default
# Lanzar con perfil
skynex up # usa el perfil por defecto
skynex up cheap # tier builtin: todo Haiku
skynex up premium # tier builtin: Opus + Sonnet
skynex up backend # tu perfil custom
skynex up backend --web # modo web UI
Tiers builtin:
| Tier | Descripcion |
|---|---|
cheap | Haiku para todo — rapido y barato |
balanced | Sonnet para planificacion, Haiku para ejecucion (default) |
premium | Opus para planificacion, Sonnet para ejecucion |
Autocompletado de shell
# Bash
eval "$(skynex completion bash)"
# O permanente:
skynex completion bash > /etc/bash_completion.d/skynex
# Zsh
eval "$(skynex completion zsh)"
# Fish
skynex completion fish > ~/.config/fish/completions/skynex.fish
Herramientas soportadas
| Herramienta | Sub-agentes | Setup |
|---|---|---|
| Claude Code | Full (Agent tool) | ./scripts/setup.sh --claude |
| OpenCode | Full (delegate/task) | ./scripts/setup.sh --opencode |
Full = el orquestador delega a sub-agentes con contexto independiente.
Agentes
| Agente | Rol | Que hace |
|---|---|---|
planner | Discovery y planificacion | Inicia memoria con Neurox, lee convenciones, explora el codebase, hace preguntas, genera PLAN.md |
manager | Orquestacion y review | Lee PLAN.md, ejecuta un paso por vez, delega a coder, exige revision humana |
coder | Implementacion acotada | Implementa una tarea, sigue patrones locales, consulta Context7 para docs, verifica antes de entregar |
Estados de PLAN.md
| Estado | Significado |
|---|---|
[ ] | Pendiente |
[~] | En progreso |
[!] | Necesita fixes |
[x] | Completado |
Commands
Nota: solo se listan los commands realmente disponibles en
opencode/commands/. Las matrices anteriores prometían commands ficticios (doc rot eliminado en QW1).
Onboarding y exploracion
| Command | Que hace |
|---|---|
/onboard | Explora el proyecto: stack, arquitectura, convenciones |
/docs <lib> <tema> | Busca docs en vivo via Context7 MCP |
Calidad y verificacion
| Command | Que hace |
|---|---|
/verify-skill [scope] | Valida skills, convenciones y cobertura con agentes en paralelo |
/verify-security [scope] | Valida seguridad con dos jueces adversariales en paralelo |
/rollback [step] | Deshace el ultimo paso (pide confirmacion) |
Git
| Command | Que hace |
|---|---|
/commit | Crea commit con Conventional Commits |
/pr | Abre pull request con gh |
Backlog (commands planeados, aún no implementados)
Los siguientes commands están en el roadmap (docs/IMPROVEMENT-PLAN.md) pero no existen aún: /grill, /skills:scan, /afk-run. Hasta que se implementen, los flujos equivalentes se hacen invocando skills directamente o via el orchestrator.
Modos de trabajo
| Supervisado | Vibe Coding | |
|---|---|---|
| Agentes | planner + manager + coder | 1 solo (vibe) |
| PLAN.md | Obligatorio | Opcional |
| Review humano | Despues de cada paso | No existe |
| Commands | 12 | 4 (/do, /fix, /commit, /done) |
| Velocidad | Controlada | Maxima |
| Cuando usarlo | Features grandes, decisiones de arquitectura, equipos | Exploraciones rapidas, bugfixes, features chicos |
El modo vibe coding esta en
vibe-coding/. Para usarlo:./scripts/setup.sh --opencodecon la config de vibe.
Flujo recomendado
/verify-skill # validar skills y convenciones en paralelo
/verify-security # validar seguridad en paralelo
/apply-feedback <correcciones> # aplicar feedback si hay issues
/commit # commit con Conventional Commits
/pr # abrir pull request
/context # guardar aprendizajes en memoria
Memoria persistente
Neurox es el sistema de memoria que conecta sesiones de trabajo:
session_start— Inicia una sesion con titulo, directorio y branchcontext— Carga memorias relevantes al namespace actualrecall— Busca decisiones, patrones o bugs previossave— Guarda descubrimientos con tags y archivos relacionadossession_end— Cierra la sesion con un resumen
El setup configura Neurox automaticamente en ambas herramientas.
Estructura del proyecto
skills/
├── cmd/skynex/ # CLI entry point
├── internal/
│ ├── adapters/ # instalacion (claude, opencode)
│ ├── completion/ # autocompletado bash/zsh/fish
│ ├── profiles/ # CRUD de perfiles de modelos
│ ├── runner/ # lanzador de OpenCode con perfiles
│ └── ...
├── claude-code/
│ └── CLAUDE.md # overlay para el orquestador en Claude Code
├── opencode/
│ ├── opencode.json # configuracion base de agentes y MCPs
│ ├── commands/ # 7 slash commands reales
│ ├── skills/ # grill-me, prd, security, write-a-skill, diagnose, triage + _shared
│ ├── templates/ # convenciones, commits, 5 tipos de plan
│ ├── evals/ # 9 golden tests de regresion
│ └── plugins/
├── vibe-coding/
│ ├── opencode.json # config del modo autonomo
│ └── commands/ # 4 commands minimos
├── skills/
│ └── prd/ # skill compartida de PRD
└── scripts/
├── setup.sh # instalador principal
└── install_claude_assets.py
Que instala en cada herramienta
Claude Code
- 3 agentes en
~/.claude/agents:planner,manager,coder - 12 slash skills en
~/.claude/skillscon los mismos nombres operativos - Overlay de
CLAUDE.mdpara mantener el mismo workflow - Neurox MCP configurado en
~/.claude.json
OpenCode
- 3 agentes con roles claros en
opencode.json - 12 commands para todo el ciclo
- Neurox + Context7 MCP como sistemas externos
- Templates para convenciones, commits/PRs, y 5 tipos de plan
- Skills de PRD, TypeScript avanzado, y patrones NestJS DDD+CQRS
- Eval framework con 9 golden tests
Eval Framework
9 golden tests en evals/golden/ que validan el comportamiento de los agentes:
| Test | Agente | Valida |
|---|---|---|
| 01 | planner | Lee CONVENTIONS.md antes de preguntar |
| 02 | planner | Usa template PLAN-crud para tareas CRUD |
| 03 | manager | Lee PLAN.md antes de hacer nada |
| 04 | manager | Se detiene tras un paso y pide review |
| 05 | coder | Lee codigo existente antes de escribir |
| 06 | coder | Corre verificacion antes de reportar exito |
| 07 | manager | /review lee CONVENTIONS.md y git diff |
| 08 | coder | /test lee tests existentes antes de generar |
| 09 | manager | /rollback pide confirmacion antes de revertir |
./evals/run-evals.sh
./evals/run-evals.sh --agent coder
Documentacion
| Tema | Descripcion |
|---|---|
| Instalacion | Guia completa: requisitos, setup automatico/manual, verificacion, troubleshooting |
| OpenCode setup | Configuracion detallada de OpenCode |
| Claude Code setup | Overlay y reglas para Claude Code |
| Vibe Coding | Modo autonomo con un solo agente |
Claude Code: nota importante
Claude Code no permite que un subagente lance otro subagente. Para mantener el mismo comportamiento:
- El hilo principal de Claude hace de orquestador
plannerycoderse usan como subagentesmanageres agente de apoyo para scoping y review- La orquestacion multi-agente se queda en el hilo principal
Recomendacion
En cada proyecto nuevo, copia opencode/templates/CONVENTIONS.md a la raiz del repo y ajustalo al stack real. Eso hace que los agentes sean mucho mas consistentes.
Licencia
MIT