Skip to content

CLAUDE.md

Latest commit

 

History

History
87 lines (61 loc) · 2.48 KB

CLAUDE.md

File metadata and controls

87 lines (61 loc) · 2.48 KB

LLM Toolkit

Repositorio de herramientas para trabajar con modelos de lenguaje.

Estructura

  • skills/ - Skills para Claude Code (SKILL.md + references/)
  • agents/ - Agentes especializados
  • commands/ - Slash commands organizados por categoría
  • .claude-plugin/ - Plugin config (hooks.json, scripts/, plugin.json)
  • cli/nub/ - CLI tool para ahorrar tokens (Go)
  • docs/ - Documentación

Comandos útiles

# Ver estructura
tree -I 'node_modules|.git'

# Validar skill
cat skills/{nombre}/SKILL.md | head -20

# Probar skill localmente
ln -s $(pwd)/skills/{nombre} ~/.claude/skills/

Agregar nuevo skill

  1. Crear skills/{nombre}/SKILL.md:
---
name: nombre-del-skill
description: Descripción corta (max 1024 chars)
---

# Contenido del skill
...

  1. Agregar referencias si necesita ejemplos:

    • skills/{nombre}/references/ejemplo.md

  2. Actualizar README.md con el nuevo skill

  3. Actualizar .claude-plugin/marketplace.json

Agregar nuevo hook

  1. Crear script en .claude-plugin/scripts/{nombre}.sh
  2. Dar permisos: chmod +x .claude-plugin/scripts/{nombre}.sh
  3. Agregar entrada en .claude-plugin/hooks.json
  4. Documentar en docs/guides/hooks.md

Agregar nuevo command

  1. Crear commands/{nombre}.md con el prompt
  2. Documentar en README

CLI Tool (nub)

Token-saving CLI. Siempre preferir nub sobre Read/WebFetch cuando aplique.

nub search "video"              # Buscar skills/agents/commands
nub git log --since 3d          # Log condensado
nub git diff                    # Diff con stats
nub pdf documento.pdf           # Texto de PDF (vs Read que manda imágenes)
nub pdf escaneado.pdf --deep    # OCR + spatial layout (requiere liteparse)
nub web https://example.com     # Markdown limpio de URL

Build: cd cli/nub && go build -o nub . Deps externas (opcionales): npm i -g defuddle-cli @llamaindex/liteparse

Preferencias de herramientas

  • PDFs: usar nub pdf <file> antes que Read. Solo usar Read si nub no extrae bien el texto (escaneados sin OCR, diagramas).
  • URLs/web: preferir nub web <url> sobre WebFetch para artículos, docs, blogs. Usar WebFetch solo si necesitás el HTML crudo.
  • Buscar skills/agents/commands: nub search <query> en vez de leer múltiples SKILL.md.
  • Git: nub git diff y nub git log para resúmenes condensados antes de usar Bash con git directo.

Convenciones

  • Skills: nombres en kebab-case
  • Documentación: español (código en inglés)
  • Commits: conventional commits