convez.ai
AgenteAutomaçãoIntermediário
joeldevz

Skynex Skills

joeldevz/skynex

Orquestrador com sub-agentes especializados para código sem perda de contexto

Ver no GitHub
InicialPluginScore · de 0 a 100

Agente 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/skynex

1 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

Estrelas
2
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
v2.2.0
Issues abertas
7
Contribuidores
1

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:

  1. 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 →

  2. 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 →

  3. 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

ComandoQue hace
skynex installInstalador interactivo (TUI)
skynex update [package]Actualiza paquetes instalados a la ultima version
skynex statusDashboard: paquetes instalados, perfiles, herramientas
skynex doctorDiagnostico 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:

TierDescripcion
cheapHaiku para todo — rapido y barato
balancedSonnet para planificacion, Haiku para ejecucion (default)
premiumOpus 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

HerramientaSub-agentesSetup
Claude CodeFull (Agent tool)./scripts/setup.sh --claude
OpenCodeFull (delegate/task)./scripts/setup.sh --opencode

Full = el orquestador delega a sub-agentes con contexto independiente.

Agentes

AgenteRolQue hace
plannerDiscovery y planificacionInicia memoria con Neurox, lee convenciones, explora el codebase, hace preguntas, genera PLAN.md
managerOrquestacion y reviewLee PLAN.md, ejecuta un paso por vez, delega a coder, exige revision humana
coderImplementacion acotadaImplementa una tarea, sigue patrones locales, consulta Context7 para docs, verifica antes de entregar

Estados de PLAN.md

EstadoSignificado
[ ]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

CommandQue hace
/onboardExplora el proyecto: stack, arquitectura, convenciones
/docs <lib> <tema>Busca docs en vivo via Context7 MCP

Calidad y verificacion

CommandQue 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

CommandQue hace
/commitCrea commit con Conventional Commits
/prAbre 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

SupervisadoVibe Coding
Agentesplanner + manager + coder1 solo (vibe)
PLAN.mdObligatorioOpcional
Review humanoDespues de cada pasoNo existe
Commands124 (/do, /fix, /commit, /done)
VelocidadControladaMaxima
Cuando usarloFeatures grandes, decisiones de arquitectura, equiposExploraciones rapidas, bugfixes, features chicos

El modo vibe coding esta en vibe-coding/. Para usarlo: ./scripts/setup.sh --opencode con 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 branch
  • context — Carga memorias relevantes al namespace actual
  • recall — Busca decisiones, patrones o bugs previos
  • save — Guarda descubrimientos con tags y archivos relacionados
  • session_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/skills con los mismos nombres operativos
  • Overlay de CLAUDE.md para 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:

TestAgenteValida
01plannerLee CONVENTIONS.md antes de preguntar
02plannerUsa template PLAN-crud para tareas CRUD
03managerLee PLAN.md antes de hacer nada
04managerSe detiene tras un paso y pide review
05coderLee codigo existente antes de escribir
06coderCorre verificacion antes de reportar exito
07manager/review lee CONVENTIONS.md y git diff
08coder/test lee tests existentes antes de generar
09manager/rollback pide confirmacion antes de revertir
./evals/run-evals.sh
./evals/run-evals.sh --agent coder

Documentacion

TemaDescripcion
InstalacionGuia completa: requisitos, setup automatico/manual, verificacion, troubleshooting
OpenCode setupConfiguracion detallada de OpenCode
Claude Code setupOverlay y reglas para Claude Code
Vibe CodingModo 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
  • planner y coder se usan como subagentes
  • manager es 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


Ver o original no GitHub

Bom para

Relacionados