Zealotic-spec/claude-skill-router

¿Qué hace claude-skill-router?

Reduce el catálogo de habilidades siempre cargado de Claude Code en ~90%: mantén las habilidades populares de forma nativa y mueve el resto a una biblioteca que un enrutador Haiku busca bajo demanda.

Descripción

Este sistema optimiza el rendimiento de Claude Code al evitar cargar todas las habilidades al inicio. En lugar de almacenar cientos de habilidades en memoria, solo las más usadas (hot skills) se mantienen de forma nativa. Las demás se almacenan en una biblioteca externa, y un pequeño enrutador basado en Haiku las recupera dinámicamente cuando se necesitan.

Cómo funciona

1. Habilidades activas: Las habilidades que usas con frecuencia se mantienen cargadas en memoria para acceso rápido.
2. Biblioteca de habilidades: El resto de habilidades se almacena en un repositorio o directorio central.
3. Enrutador Haiku: Cuando Claude Code necesita una habilidad que no está en memoria, el enrutador consulta la biblioteca y la carga sobre la marcha.

Beneficios

• Reducción de carga inicial: Solo se cargan las habilidades esenciales, reduciendo el uso de memoria y tiempo de inicio.
• Escalabilidad: Puedes tener cientos de habilidades sin afectar el rendimiento.
• Flexibilidad: El enrutador decide inteligentemente qué habilidad cargar según el contexto.

Instalación

# Clona el repositorio
git clone https://github.com/Zealotic-spec/claude-skill-router.git

# Sigue las instrucciones de configuración (ver más abajo)

Configuración

1. Define las habilidades hot en un archivo de configuración, por ejemplo skills-config.json:

{
  "hotSkills": ["skill1", "skill2", "skill3"],
  "libraryPath": "./skills-library",
  "routerModel": "haiku"
}

2. Coloca las habilidades restantes en la carpeta skills-library.
3. Ejecuta el enrutador.

Uso

# Inicia Claude Code con el enrutador habilitado
claude --router haiku --hot-config skills-config.json

El enrutador intercepta las solicitudes de habilidades y solo carga las que no están en la lista hot.

Ejemplo

Supongamos que tienes 100 habilidades instaladas. Con este sistema, solo 10 se cargan al inicio (las hot), y las otras 90 se cargan bajo demanda. Esto reduce el tiempo de carga inicial y el uso de memoria.

Compatibilidad

• Plataformas: Claude Code, Cursor, Codex, y cualquier sistema de habilidades basado en agentes de IA.
• Modelos: Utiliza Haiku para el enrutamiento, pero es compatible con otros modelos de Anthropic.

Contribuciones

Las contribuciones son bienvenidas. Por favor, abre un issue o envía un pull request.

Licencia

MIT