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
│   └── security/          # scrub
├── cli/nub/               # CLI Go para ahorrar tokens
├── 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, mejorar y auditar archivos CLAUDE.md siguiendo best practices	"crear CLAUDE.md", "revisar CLAUDE.md", "auditar CLAUDE.md"
nextjs-project-starter	Crea proyectos Next.js con stack configurable (Mantine, Supabase, Zustand)	"crear proyecto", "new nextjs project"
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"
gh-cli	Referencia completa de GitHub CLI (gh): repos, issues, PRs, Actions, releases, search, API	"gh pr", "gh issue", "github cli", "gh api"
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"
furniture-planner	Diseña muebles a medida con planos HTML, BOM, renders IA y export Excel CorteCloud	"diseñar mueble", "bajo mesada", "placard", "cortecloud"
browser-extension	Crea extensiones cross-browser con WXT (scaffold, dev, testing, publish)	"crear extensión", "browser extension", "content script"
indice-titularidad	Renueva índices de titularidad CABA/PBA para crédito hipotecario BNA	"renovar titularidad", "índice titularidad", "informe N°3"
video-debugger	Extrae frames de screen recordings para debug visual de animaciones y UI	"debug video", "extraer frames", "frame by frame"
view-transitions	Implementa View Transitions API en proyectos web (SPA/MPA) con React y Next.js	"view transitions", "shared element", "animacion entre paginas"
web-animations	WAAPI, CSS Transitions, CSS Animations y scroll-driven animations	"Element.animate", "css transition", "@keyframes", "scroll-driven"
lm-studio	Gestiona modelos locales con LM Studio CLI y REST API v1	"lm studio", "lms", "modelo local", "lms server"
derecho-argentino	Consulta de legislación argentina: CN, CP y CCyC con texto verbatim (2670+ artículos)	"artículo", "código penal", "código civil", "constitución", "prescripción"

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

Security

Command	Descripcion	Uso
scrub	Escanea conversaciones por data sensible	/scrub, /scrub all

Agents Disponibles

Agent	Descripcion	Modelo
codebase-analyst	Analisis profundo de codebases	sonnet
github-actions-expert	Experto en GitHub Actions y CI/CD	opus
grafana-expert	Experto en dashboards y visualizacion Grafana	opus
java-expert	Experto en desarrollo Java	opus
loki-expert	Experto en agregacion de logs con Loki	opus
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

CLI Tool: nub

Binario Go que extrae contenido condensado para ahorrar tokens de LLM. Zero Node/Python deps.

# Build
cd cli/nub && go build -o nub .

# Uso
nub pdf documento.pdf              # Texto de PDF via pdftotext
nub pdf escaneado.pdf --deep       # OCR + spatial layout via liteparse
nub web https://example.com        # Texto limpio de URL (go-readability)
nub search "animaciones"           # Buscar skills/agents/commands
nub git diff                       # Diff condensado con stats
nub git log --since 3d             # Commits recientes
nub git stat --depth 5             # Cambios por archivo

Flags globales: --limit N (truncar output), --pretty (human-readable). Deps: pdftotext (brew install poppler). Opcional: liteparse para --deep.

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
Gotchas	Bugs difíciles, workarounds, configs no documentadas

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/, security/
3. Actualizar plugin.json

Security Risk Assessments

Some skills in this toolkit are flagged as High Risk or Med Risk by automated security scanners (Snyk, Socket.dev, and AI-based analysis). This is expected and by design.

Why? Several skills intentionally use Bash in allowed-tools and instruct Claude to run shell commands (npm install, brew install, npx, gh api, etc.). Automated scanners flag these patterns — particularly curl | bash, package installations, and API calls to external services — as potential supply chain or code execution risks.

Affected skills:

Skill	Flag	Reason
setup-project	Gen: High Risk	Instructs to install CLIs (brew install, npm i -g, curl | bash)
feature-planner	Gen: High Risk	Has Bash in allowed-tools, runs shell commands for project detection
nextjs-project-starter	Socket/Snyk: Med Risk	Runs npx create-next-app, installs npm packages
github-actions	Socket/Snyk: Med Risk	Creates CI/CD workflows that execute code

These are legitimate tool operations, not malicious behavior. All skills ask for user confirmation before executing destructive or external actions. Review the SKILL.md of each skill before installing if you want to understand exactly what it does.

Licencia

MIT