LLM Toolkit

Coleccion de herramientas, configuraciones y extensiones para trabajar con modelos de lenguaje (Claude, GPT, Qwen, Mistral, etc.).

Quick Start: Ver docs/QUICK-START.md para empezar en 5 minutos.

Estructura del Repositorio

llm-toolkit/
├── skills/                 # Skills para Claude Code
│   ├── llms-txt-generator/
│   ├── claude-md-writer/
│   ├── nextjs-project-starter/
│   └── doc-writer/
├── agents/                 # Agentes especializados
├── commands/               # Slash commands organizados
│   ├── git/               # commit
│   ├── code/              # explain, simplify, translate
│   ├── docs/              # diagram, document
│   └── dev/               # prototype, summary
├── docs/                   # Documentacion
├── .claude-plugin/         # Configuracion del plugin
│   ├── hooks.json         # Hooks PreToolUse/PostToolUse
│   ├── scripts/           # Scripts de hooks
│   ├── marketplace.json
│   └── plugin.json        # Declaracion de todo el contenido
├── .claude/               # Configuracion local
│   └── settings.template.json
├── rules/                  # Reglas y guidelines (futuro)
├── prompts/                # Prompts reutilizables (futuro)
└── configs/                # Configuraciones por IDE (futuro)

Skills Disponibles

Skill	Descripcion	Trigger
llms-txt-generator	Genera documentacion optimizada para LLMs siguiendo el estandar llms.txt	"crear llms.txt", "generate LLM docs"
claude-md-writer	Guia para escribir y mejorar archivos CLAUDE.md siguiendo best practices	"crear CLAUDE.md", "revisar CLAUDE.md"
nextjs-project-starter	Crea proyectos Next.js con stack configurable (Mantine, Supabase, Zustand)	"crear proyecto", "new nextjs project"
pr-reviewer	Revisa PRs aplicando KISS, DRY, SOLID con respuestas en español	"revisar PR", "code review"
git-reconciler	Sincroniza branch con main/master detectando conflictos antes de merge	"sync con main", "reconciliar", "actualizar branch"
worktree-manager	Gestiona git worktrees en carpeta .worktrees/	"crear worktree", "listar worktrees"
setup-project	Configura proyectos con scripts de check y detecta CLIs disponibles	"configurar proyecto", "setup", "qué CLIs tengo"
feature-planner	Planifica features con entrevista estructurada y genera plan de implementacion	"planificar feature", "nueva funcionalidad"
doc-writer	Organiza specs, planes y docs tecnicos en docs/ con categorias y naming automatico	"escribir spec", "crear plan", "documentar ADR"
doc-organizer	Organiza y categoriza documentos existentes en estructura correcta	"organizar docs", "categorizar archivos"
investor-profiler	Entrevista estructurada para determinar perfil de inversor y recomendar asset allocation	"perfil inversor", "en qué invertir", "asset allocation"
github-actions	Configura GitHub Actions con deteccion proactiva de repos sin CI. Soporta Node.js, Python, Go	"agregar CI", "configurar GitHub Actions", "workflow de deploy"
logging-backend	Wide Events para observabilidad real en backend	"agregar logging", "wide events", "mejorar logs"
coding-guidelines	Principios para escribir codigo de calidad con LLMs	"escribir codigo", "refactorizar", "buenas practicas"
blender-architect	Modelado arquitectonico 3D en Blender via MCP	"modelar casa", "create 3D architecture"

Commands Disponibles

Git

Command	Descripcion	Uso
commit	Genera commits siguiendo conventional commits	/commit

Code

Command	Descripcion	Uso
explain	Explica codigo o arquitectura	/explain
simplify	Refactoriza codigo complejo	/simplify
translate	Traduce codigo entre lenguajes	/translate

Docs

Command	Descripcion	Uso
diagram	Genera diagramas ASCII o Mermaid	/diagram
document	Genera documentacion automatica	/document

Dev

Command	Descripcion	Uso
prototype	Crea proof-of-concepts rapidos	/prototype
summary	Resume conversaciones largas	/summary

Agents Disponibles

Agent	Descripcion	Modelo
codebase-analyst	Analisis profundo de codebases	sonnet
github-actions-expert	Experto en GitHub Actions y CI/CD	sonnet
grafana-expert	Experto en dashboards y visualizacion Grafana	sonnet
java-expert	Experto en desarrollo Java	opus
loki-expert	Experto en agregacion de logs con Loki	sonnet
nodejs-expert	Experto en Node.js y programacion asincrona	opus
scala-expert	Experto en Scala y programacion funcional	opus
tech-researcher	Investigador tecnico para frameworks y librerias	sonnet
vitest-expert	Experto en unit testing con Vitest	opus
web-researcher	Investigador general para cualquier tema	sonnet

Sound Hooks

Audio feedback con sonidos de Command & Conquer (EVA + unidades), Red Alert (Tanya, Spy, Soviet, Engineer, Medic) y Super Mario Bros. Cada evento reproduce un .wav random de su carpeta. Ver docs/guides/hooks.md para detalle completo.

Evento	Sonidos
SessionStart	commando, tanya, mario pipe (5 wav)
UserPromptSubmit	acknowledged, affirmative, tanya, spy, soviet, engineer, medic, coin... (46 wav)
SubagentStart	reporting, soviet, engineer, medic, reinforcements, 1-up (12 wav)
SubagentStop	present for ya (1 wav)
PostToolUseFailure	cannot deploy, mission failed, tanya, kick (4 wav)
TaskCompleted	construction complete, powerup (3 wav)
TeammateIdle	waiting orders, ready & waiting, soviet (11 wav)
Notification	fireball (1 wav)
PermissionRequest	tanya laugh, chaching (2 wav)
SessionEnd	power down (1 wav)
Stop	unitready (1 wav)

MCP Servers Recomendados

El toolkit incluye configuracion para MCP servers que mejoran la experiencia:

Server	Proposito
Context7	Documentacion actualizada de librerias - evita alucinaciones

Ver docs/mcp-servers-guide.md para la guia completa con tiers y configuracion.

Instalacion

Claude Code (recomendado)

# Agregar como marketplace
claude plugin marketplace add Testacode/llm-toolkit

# Instalar el plugin
claude plugin install llm-toolkit

Instalacion manual

# Clonar repositorio
git clone https://github.com/Testacode/llm-toolkit.git

# Symlink de skills
ln -s $(pwd)/llm-toolkit/skills/* ~/.claude/skills/

# Symlink de agents
ln -s $(pwd)/llm-toolkit/agents/* ~/.claude/agents/

Uso

Una vez instalados los skills, Claude Code los detectara automaticamente:

> Crear documentacion llms.txt para este proyecto
> Mejorar el CLAUDE.md de este proyecto
> Crear un nuevo proyecto Next.js con Supabase

Para usar los commands:

> /commit
> /explain src/main.ts
> /diagram arquitectura del sistema
> /simplify path/to/complex-file.ts

Documentacion

Documento	Descripcion
Quick Start	Empieza en 5 minutos
Hooks Guide	Sistema de hooks para validaciones
MCP Servers Guide	Guia de MCP servers con tiers
Getting Started	Guia detallada de inicio
CLAUDE.md Best Practices	Best practices para CLAUDE.md

Contribucion

1. Fork el repositorio
2. Crear branch: git checkout -b feature/mi-feature
3. Seguir la estructura existente
4. Documentar en el README correspondiente
5. Crear PR

Agregar un nuevo skill

1. Crear carpeta en skills/{nombre-skill}/
2. Crear SKILL.md con el formato requerido
3. Agregar referencias en references/ si aplica
4. Actualizar plugin.json y marketplace.json

Agregar un nuevo agent

1. Crear archivo en agents/{nombre-agent}.md
2. Usar formato YAML frontmatter con: name, description, tools, model
3. Actualizar plugin.json

Agregar un nuevo command

1. Crear archivo en commands/{categoria}/{nombre}.md
2. Categorias: git/, code/, docs/, dev/
3. Actualizar plugin.json

Licencia

MIT