Nexus Skills: Inteligencia de Codebase Nativa para Asistentes de Codificación con IA

Nexus Skills es una herramienta de código abierto que resuelve uno de los problemas más costosos en el desarrollo asistido por IA: el contexto del codebase. Cuando le dices a un asistente de codificación con IA “encuentra dónde se maneja la autenticación de usuarios”, necesita todo el codebase en su ventana de contexto (costando miles de tokens) o debes buscar y pegar manualmente los archivos relevantes (perdiendo tiempo). Nexus Skills cierra esta brecha construyendo una base de conocimiento persistente y consultable a partir de tu codebase que los asistentes de IA pueden buscar con un gasto mínimo de tokens.

El proyecto se divide en dos componentes principales. Nexus-mapper es el motor de indexación que escanea tu código fuente y genera inteligencia estructurada – grafos de dependencias basados en AST, mapas de estructura de archivos, jerarquías de llamadas y datos de impacto de cambios. Nexus-query es la interfaz de búsqueda que los asistentes de IA (o tú, mediante CLI) pueden usar para encontrar funciones, rastrear dependencias, entender relaciones entre módulos y evaluar el impacto de cambios.

Lo que hace particularmente ingenioso a Nexus Skills es su flujo de trabajo con fases y su filosofía de cero dependencias. El mapper se ejecuta una vez cuando el codebase cambia, no en cada consulta. Las consultas devuelven solo el contexto específico necesario, no toda la base de conocimiento. Y toda la herramienta está implementada en Python puro sin dependencias externas.

Repositorio: github.com/Haaaiawd/Nexus-skills

Cómo Funciona el Pipeline Nexus-Mapper a Nexus-Query?

flowchart LR
    subgraph Fase de Indexación
        A[Código Fuente] --> B[Nexus-Mapper]
        B --> C[Mapa de Estructura de Archivos]
        B --> D[Grafo de Dependencias\nbasado en AST]
        B --> E[Jerarquía de Llamadas]
        B --> F[Mapa de Importaciones]
    end

    subgraph Fase de Consulta
        G[Nexus-Query] --> H{Tipo de Consulta}
        H --> I[Buscar Definición\nde Función]
        H --> J[Rastrear Cadena\nde Dependencias]
        H --> K[Análisis de Impacto\npara Cambios]
        H --> L[Relaciones\nde Módulos]
    end

    C --> G
    D --> G
    E --> G
    F --> G

    subgraph Sesión de IA
        M[Asistente de IA] --> G
        G --> N[Respuesta de\nContexto Mínimo]
        N --> M
    end

Estructuras de Datos Clave

Flujo de Trabajo con Fases

sequenceDiagram
    participant Dev as Desarrollador
    participant Mapper as Nexus-Mapper
    participant Query as Nexus-Query
    participant AI as Asistente IA

    Note over Dev,AI: Fase 1: Analizar
    Dev->>Mapper: Ejecutar mapper en codebase
    Mapper->>Mapper: Analizar AST, construir grafos
    Mapper->>Dev: Base de conocimiento creada (./nexus/)

    Note over Dev,AI: Fase 2: Implementar
    Dev->>AI: "Añadir manejo de errores a login"
    AI->>Query: "Buscar la función login"
    Query->>AI: "login() en auth/auth.py línea 42"
    AI->>Query: "Mostrar dependencias del módulo auth"
    Query->>AI: "importaciones: jwt, database, cache"
    AI->>Dev: Escribe código con contexto completo

    Note over Dev,AI: Fase 3: Revisar
    Dev->>Mapper: Ejecutar mapper después de cambios
    Mapper->>Mapper: Detectar cambios, re-indexar
    Mapper->>Dev: "login() modificado. Impacto: tests/test_auth.py, middleware/rate_limit.py"
    AI->>Dev: Revisar y verificar puntos de impacto

Comparación con Otras Herramientas

Instalación y Configuración

git clone https://github.com/Haaaiawd/Nexus-skills.git
cd Nexus-skills
export PATH="$PWD:$PATH"

mkdir -p ~/.claude/skills/nexus-skills
cp SKILL.md ~/.claude/skills/nexus-skills/

nexus-query --find-function "login"
nexus-query --dependencies "auth/auth.py"
nexus-query --impact-analysis "schema/database.py"

FAQ

Qué es Nexus Skills? Herramienta de código abierto que construye bases de conocimiento persistentes desde codebases para asistentes de codificación con IA, resolviendo la ceguera de contexto.

Diferencia entre nexus-mapper y nexus-query? Mapper es el motor de indexación; Query es la interfaz de búsqueda. Mapper se ejecuta cuando el código cambia; Query se ejecuta en cada pregunta.

Qué es el flujo de trabajo con fases? Fase 1 (analizar): ejecutar mapper para capturar estado; Fase 2 (implementar): consultar según necesidad; Fase 3 (revisar): ejecutar mapper para detectar cambios.

Tiene dependencias? Cero. Solo usa la biblioteca estándar de Python. Sin Node.js, sin BD, sin modelos ML pesados.

Cómo se instala? Clone el repositorio y añada los scripts al PATH. Opcionalmente cree un archivo de skill de Claude Code.

Lecturas Adicionales

• Repositorio de Nexus Skills en GitHub
• Documentación de Skills de Claude Code
• Análisis AST con Python
• Análisis de Grafos de Dependencias