Instalación

Guía para instalar y configurar llm-toolkit en tu entorno de desarrollo.

Requisitos previos

  • Claude Code instalado y funcionando
  • Git para clonar el repositorio
  • Node.js 18+ (para MCP servers)

Instalación

Opción 1: Instalación global (recomendada)

Instalá el plugin globalmente para que esté disponible en todos tus proyectos:

# Clonar el repositorio
git clone https://github.com/testacode/llm-toolkit.git ~/.claude/plugins/llm-toolkit

# Instalar como plugin global
claude plugins install ~/.claude/plugins/llm-toolkit

Opción 2: Instalación por proyecto

Si querés el toolkit solo en un proyecto específico:

# Desde el directorio de tu proyecto
git clone https://github.com/testacode/llm-toolkit.git .claude-plugins/llm-toolkit

# Instalar para este proyecto
claude plugins install .claude-plugins/llm-toolkit --project

Opción 3: Sin clonar

Instalar directamente desde GitHub:

claude plugins install github:testacode/llm-toolkit

Verificar instalación 

# Listar plugins instalados
claude plugins list

# Verificar que se cargaron los skills
claude skills list

Deberías ver:

  • 12 skills cargados
  • 10 agents disponibles
  • 15 commands registrados

Configurar MCP Servers

El toolkit incluye Context7 para documentación actualizada. Agregalo a tu configuración:

Global (~/.claude.json) 

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Por proyecto (.mcp.json) 

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Actualizar el toolkit 

# Si lo clonaste
cd ~/.claude/plugins/llm-toolkit
git pull origin master

# Si usás github:
claude plugins update llm-toolkit

Estructura del toolkit 

llm-toolkit/
├── .claude-plugin/
│   └── plugin.json        # Manifest del plugin
├── skills/                # Skills (12)
│   ├── pr-reviewer/
│   ├── git-reconciler/
│   └── ...
├── agents/                # Agents (10)
│   ├── codebase-analyst.md
│   ├── nodejs-expert.md
│   └── ...
├── commands/              # Commands (15)
│   ├── git/
│   ├── dev/
│   ├── code/
│   └── docs/
└── docs/                  # Documentación

Troubleshooting

El plugin no aparece en la lista

  1. Reiniciar Claude Code
  2. Verificar que plugin.json exista en .claude-plugin/
  3. Revisar logs: claude --debug

Los skills no se activan

  1. Usar las frases trigger exactas (ver Skill Triggers)
  2. Verificar que el skill esté habilitado: claude skills list

Context7 no funciona

  1. Verificar que npm/npx estén instalados: which npx
  2. La primera vez es lenta (descarga paquetes)
  3. Reiniciar después de configurar MCP

Próximos pasos