theus-cli-darwin-x64 0.2.84

package/vendor/theus-arsenal/skills/presupuesto-contexto/SKILL.md

@@ -0,0 +1,263 @@
+---
+name: presupuesto-contexto
+description: >-
+  Audita el consumo de la ventana de contexto de Theus (agentes, skills,
+  servidores MCP, reglas y THEUS.md) y produce recomendaciones priorizadas
+  de ahorro de tokens. Además, ofrece al usuario una elección informada
+  sobre la profundidad de respuesta antes de contestar.
+  ACTIVAR cuando: "presupuesto de contexto", "presupuesto de tokens",
+  "cuántos tokens", "consumo de contexto", "auditar contexto", "sobrecarga
+  de contexto", "ahorrar tokens", "límite de tokens", "longitud de
+  respuesta", "profundidad de respuesta", "versión corta", "respuesta
+  breve", "respuesta detallada", "respuesta exhaustiva", "respuesta corta
+  vs larga", "responde al 50%", "dame la versión corta", "quiero controlar
+  cuánto usas", o variantes claras donde el usuario pide auditar el
+  contexto o controlar el tamaño/profundidad de la respuesta.
+  NO ACTIVAR cuando: el usuario ya fijó un nivel de profundidad en la
+  sesión actual (mantenerlo), la petición se responde con una sola palabra,
+  o "token" se refiere a tokens de autenticación/sesión/pago y no al
+  tamaño de la respuesta.
+---
+
+# Presupuesto de contexto
+
+Skill unificada con dos modos complementarios:
+
+- **Modo A — Auditoría de contexto**: analiza la sobrecarga de tokens de cada componente cargado en una sesión de Theus y presenta optimizaciones accionables para recuperar espacio de contexto.
+- **Modo B — Asesor de profundidad de respuesta**: intercepta el flujo de respuesta para ofrecer al usuario una elección sobre la profundidad de la respuesta **antes** de que Theus conteste.
+
+## Cuándo usarla
+
+**Modo A (auditoría):**
+
+- El rendimiento de la sesión se siente lento o la calidad de salida está degradándose
+- Añadiste recientemente muchas skills, agentes o servidores MCP
+- Quieres saber cuánto margen de contexto tienes realmente
+- Planeas añadir más componentes y necesitas saber si hay espacio
+
+**Modo B (asesor de profundidad):**
+
+- El usuario quiere controlar qué tan larga o detallada será una respuesta
+- El usuario menciona tokens, presupuesto, profundidad o longitud de respuesta
+- El usuario dice "versión corta", "tldr", "breve", "al 25%", "exhaustiva", etc.
+- Cualquier momento en que el usuario quiera elegir el nivel de detalle por adelantado
+
+**No activar el Modo B** cuando: el usuario ya fijó un nivel en esta sesión (mantenerlo en silencio), o la respuesta es trivialmente de una línea.
+
+---
+
+## Modo A — Auditoría de contexto
+
+### Fase 1: Inventario
+
+Escanea todos los directorios de componentes y estima el consumo de tokens:
+
+**Agentes** (`agents/*.md`)
+- Cuenta líneas y tokens por archivo (palabras × 1.3)
+- Extrae la longitud del `description` del frontmatter
+- Marca: archivos >200 líneas (pesados), descripción >30 palabras (frontmatter inflado)
+
+**Skills** (`skills/*/SKILL.md`)
+- Cuenta tokens por SKILL.md
+- Marca: archivos >400 líneas
+- Comprueba copias duplicadas en `.agents/skills/` — omite las copias idénticas para no contar doble
+
+**Reglas** (`rules/**/*.md`)
+- Cuenta tokens por archivo
+- Marca: archivos >100 líneas
+- Detecta solapamiento de contenido entre archivos de reglas del mismo módulo de lenguaje
+
+**Servidores MCP** (`.mcp.json` o la configuración MCP activa)
+- Cuenta servidores configurados y total de tools
+- Estima la sobrecarga de esquemas en ~500 tokens por tool
+- Marca: servidores con >20 tools, servidores que envuelven comandos CLI simples (`gh`, `git`, `npm`, `supabase`, `vercel`)
+
+**THEUS.md** (de proyecto + de usuario)
+- Cuenta tokens por archivo en la cadena de THEUS.md
+- Marca: total combinado >300 líneas
+
+### Fase 2: Clasificar
+
+Ordena cada componente en una categoría:
+
+| Categoría | Criterio | Acción |
+|-----------|----------|--------|
+| **Siempre necesario** | Referenciado en THEUS.md, respalda un comando activo, o coincide con el tipo de proyecto actual | Mantener |
+| **A veces necesario** | Específico de dominio (p. ej. patrones de un lenguaje), no referenciado en THEUS.md | Considerar activación bajo demanda |
+| **Rara vez necesario** | Sin referencia desde comandos, contenido solapado, o sin coincidencia evidente con el proyecto | Eliminar o cargar de forma diferida |
+
+### Fase 3: Detectar problemas
+
+Identifica los siguientes patrones problemáticos:
+
+- **Descripciones de agente infladas** — una descripción de >30 palabras en el frontmatter se carga en cada invocación de la herramienta Task
+- **Agentes pesados** — archivos de >200 líneas inflan el contexto de la herramienta Task en cada lanzamiento
+- **Componentes redundantes** — skills que duplican la lógica de agentes, reglas que duplican THEUS.md
+- **Sobresuscripción de MCP** — >10 servidores, o servidores que envuelven herramientas CLI disponibles gratis
+- **THEUS.md inflado** — explicaciones verbosas, secciones desactualizadas, instrucciones que deberían ser reglas
+
+### Fase 4: Informe
+
+Produce el informe de presupuesto de contexto:
+
+```
+Informe de presupuesto de contexto
+═══════════════════════════════════════
+
+Sobrecarga total estimada: ~XX,XXX tokens
+Modelo de contexto: modelo estándar del catálogo Theus (ventana de 200K)
+Contexto efectivo disponible: ~XXX,XXX tokens (XX%)
+
+Desglose por componente:
+┌─────────────────┬────────┬───────────┐
+│ Componente      │ Nº     │ Tokens    │
+├─────────────────┼────────┼───────────┤
+│ Agentes         │ N      │ ~X,XXX    │
+│ Skills          │ N      │ ~X,XXX    │
+│ Reglas          │ N      │ ~X,XXX    │
+│ Tools MCP       │ N      │ ~XX,XXX   │
+│ THEUS.md        │ N      │ ~X,XXX    │
+└─────────────────┴────────┴───────────┘
+
+ADVERTENCIA: Problemas encontrados (N):
+[ordenados por ahorro de tokens]
+
+Top 3 optimizaciones:
+1. [acción] → ahorra ~X,XXX tokens
+2. [acción] → ahorra ~X,XXX tokens
+3. [acción] → ahorra ~X,XXX tokens
+
+Ahorro potencial: ~XX,XXX tokens (XX% de la sobrecarga actual)
+```
+
+En modo detallado (verbose), añade además los conteos de tokens por archivo, el desglose línea a línea de los archivos más pesados, las líneas redundantes concretas entre componentes solapados, y la lista de tools MCP con la estimación de tamaño de esquema por tool.
+
+### Ejemplos del Modo A
+
+**Auditoría básica**
+```
+Usuario: audita mi presupuesto de contexto
+Skill: Escanea la configuración → 16 agentes (12,400 tokens), 28 skills (6,200), 87 tools MCP (43,500), 2 THEUS.md (1,200)
+       Marca: 3 agentes pesados, 14 servidores MCP (3 reemplazables por CLI)
+       Mayor ahorro: eliminar 3 servidores MCP → -27,500 tokens (47% menos sobrecarga)
+```
+
+**Modo detallado**
+```
+Usuario: audita el contexto en modo detallado
+Skill: Informe completo + desglose por archivo mostrando planificador.md (213 líneas, 1,840 tokens),
+       lista de tools MCP con tamaños por tool, líneas de reglas duplicadas lado a lado
+```
+
+**Verificación previa a expansión**
+```
+Usuario: Quiero añadir 5 servidores MCP más, ¿tengo espacio?
+Skill: Sobrecarga actual 33% → añadir 5 servidores (~50 tools) sumaría ~25,000 tokens → sube a 45% de sobrecarga
+       Recomendación: eliminar primero 2 servidores reemplazables por CLI para mantenerse bajo el 40%
+```
+
+### Buenas prácticas del Modo A
+
+- **Estimación de tokens**: usa `palabras × 1.3` para prosa, `caracteres / 4` para archivos con mucho código
+- **MCP es la palanca más grande**: cada esquema de tool cuesta ~500 tokens; un servidor de 30 tools cuesta más que todas tus skills juntas
+- **Las descripciones de agente siempre se cargan**: aunque el agente nunca se invoque, su campo description está presente en todo contexto de la herramienta Task
+- **Modo detallado para depurar**: úsalo cuando necesites señalar los archivos exactos que generan la sobrecarga, no para auditorías rutinarias
+- **Audita después de cambios**: ejecuta la auditoría tras añadir cualquier agente, skill o servidor MCP para atajar el crecimiento a tiempo
+
+---
+
+## Modo B — Asesor de profundidad de respuesta
+
+### Paso 1 — Estimar los tokens de entrada
+
+Estima mentalmente el conteo de tokens del prompt usando las mismas heurísticas de calibración del Modo A:
+
+- prosa: `palabras × 1.3`
+- contenido con mucho código o bloques mixtos/código: `caracteres / 4`
+
+Para contenido mixto, usa el tipo de contenido dominante y mantén la estimación como heurística.
+
+### Paso 2 — Estimar el tamaño de la respuesta según complejidad
+
+Clasifica el prompt y aplica el rango de multiplicador para obtener la ventana completa de respuesta:
+
+| Complejidad  | Rango de multiplicador | Ejemplos de prompt                                  |
+|--------------|------------------------|-----------------------------------------------------|
+| Simple       | 3× – 8×                | "¿Qué es X?", sí/no, un solo dato                  |
+| Media        | 8× – 20×               | "¿Cómo funciona X?"                                |
+| Media-alta   | 10× – 25×              | Petición de código con contexto                    |
+| Compleja     | 15× – 40×              | Análisis multi-parte, comparaciones, arquitectura  |
+| Creativa     | 10× – 30×              | Cuentos, ensayos, escritura narrativa              |
+
+Ventana de respuesta = `tokens_entrada × mult_min` a `tokens_entrada × mult_max` (sin exceder el límite de tokens de salida configurado para tu modelo).
+
+### Paso 3 — Presentar las opciones de profundidad
+
+Presenta este bloque **antes** de responder, con los números realmente estimados:
+
+```
+Analizando tu prompt...
+
+Entrada: ~[N] tokens  |  Tipo: [tipo]  |  Complejidad: [nivel]  |  Idioma: [idioma]
+
+Elige tu nivel de profundidad:
+
+[1] Esencial    (25%)  ->  ~[tokens]   Solo la respuesta directa, sin preámbulo
+[2] Moderado    (50%)  ->  ~[tokens]   Respuesta + contexto + 1 ejemplo
+[3] Detallado   (75%)  ->  ~[tokens]   Respuesta completa con alternativas
+[4] Exhaustivo (100%)  ->  ~[tokens]   Todo, sin límites
+
+¿Qué nivel? (1-4 o di "al 25%", "al 50%", "al 75%", "al 100%")
+
+Precisión: estimación heurística con ~85-90% de exactitud (±15%).
+```
+
+Estimación de tokens por nivel (dentro de la ventana de respuesta):
+- 25%  → `min + (max - min) × 0.25`
+- 50%  → `min + (max - min) × 0.50`
+- 75%  → `min + (max - min) × 0.75`
+- 100% → `max`
+
+### Paso 4 — Responder en el nivel elegido
+
+| Nivel            | Longitud objetivo        | Incluir                                                 | Omitir                                              |
+|------------------|--------------------------|---------------------------------------------------------|-----------------------------------------------------|
+| 25% Esencial     | 2-4 oraciones máx.       | Respuesta directa, conclusión clave                     | Contexto, ejemplos, matices, alternativas           |
+| 50% Moderado     | 1-3 párrafos             | Respuesta + contexto necesario + 1 ejemplo              | Análisis profundo, casos borde, referencias         |
+| 75% Detallado    | Respuesta estructurada   | Varios ejemplos, pros/contras, alternativas             | Casos borde extremos, referencias exhaustivas       |
+| 100% Exhaustivo  | Sin restricción          | Todo — análisis completo, todo el código, todas las perspectivas | Nada                                       |
+
+### Atajos — omitir la pregunta
+
+Si el usuario ya señala un nivel, responde en ese nivel de inmediato sin preguntar:
+
+| Lo que dice                                                            | Nivel |
+|------------------------------------------------------------------------|-------|
+| "1" / "al 25%" / "versión corta" / "respuesta breve" / "tldr"          | 25%   |
+| "2" / "al 50%" / "profundidad moderada" / "respuesta equilibrada"      | 50%   |
+| "3" / "al 75%" / "respuesta detallada" / "respuesta a fondo"           | 75%   |
+| "4" / "al 100%" / "respuesta exhaustiva" / "análisis completo"         | 100%  |
+
+Si el usuario fijó un nivel antes en la sesión, **mantenlo en silencio** para las respuestas siguientes salvo que lo cambie.
+
+### Nota de precisión
+
+Este modo usa estimación heurística — sin tokenizador real. Exactitud ~85-90%, varianza ±15%. Muestra siempre el descargo de responsabilidad.
+
+### Ejemplos del Modo B
+
+#### Activa
+
+- "Dame primero la versión corta."
+- "¿Cuántos tokens usará tu respuesta?"
+- "Responde al 50% de profundidad."
+- "Quiero la respuesta exhaustiva, no el resumen."
+- "Dame la versión corta y luego la detallada."
+
+#### No activa
+
+- "¿Qué es un token JWT?"
+- "El flujo de checkout usa un token de pago."
+- "¿Esto es normal?"
+- "Completa el refactor."
+- Preguntas de seguimiento después de que el usuario ya eligió una profundidad para la sesión

package/vendor/theus-arsenal/skills/procesamiento-documentos-nutrient/SKILL.md

@@ -0,0 +1,168 @@
+---
+name: procesamiento-documentos-nutrient
+description: Procesa, convierte, aplica OCR, extrae, censura, firma y rellena documentos mediante la
+  API Nutrient DWS. Funciona con PDF, DOCX, XLSX, PPTX, HTML e imágenes. Requiere una cuenta y API key
+  propia de Nutrient.
+---
+
+# Procesamiento de documentos con Nutrient
+
+> **Importante:** esta skill es un integrador de la API comercial de Nutrient, un servicio de terceros. Requiere que tengas tu propia cuenta y API key en Nutrient; **no forma parte de la suscripción de Theus** y su costo/facturación corre por cuenta del usuario. Revisa los términos del servicio antes de usarla.
+
+Procesa documentos con la [API Nutrient DWS Processor](https://www.nutrient.io/api/). Convierte formatos, extrae texto y tablas, aplica OCR a documentos escaneados, censura PII, añade marcas de agua, firma digitalmente y rellena formularios PDF.
+
+## Configuración
+
+Obtén una API key en **[nutrient.io](https://dashboard.nutrient.io/sign_up/?product=processor)**
+
+```bash
+export NUTRIENT_API_KEY="pdf_live_..."
+```
+
+Todas las solicitudes van a `https://api.nutrient.io/build` como POST multipart con un campo JSON `instructions`.
+
+## Operaciones
+
+### Convertir documentos
+
+```bash
+# DOCX a PDF
+curl -X POST https://api.nutrient.io/build \
+  -H "Authorization: Bearer $NUTRIENT_API_KEY" \
+  -F "document.docx=@document.docx" \
+  -F 'instructions={"parts":[{"file":"document.docx"}]}' \
+  -o salida.pdf
+
+# PDF a DOCX
+curl -X POST https://api.nutrient.io/build \
+  -H "Authorization: Bearer $NUTRIENT_API_KEY" \
+  -F "document.pdf=@document.pdf" \
+  -F 'instructions={"parts":[{"file":"document.pdf"}],"output":{"type":"docx"}}' \
+  -o salida.docx
+
+# HTML a PDF
+curl -X POST https://api.nutrient.io/build \
+  -H "Authorization: Bearer $NUTRIENT_API_KEY" \
+  -F "index.html=@index.html" \
+  -F 'instructions={"parts":[{"html":"index.html"}]}' \
+  -o salida.pdf
+```
+
+Formatos de entrada soportados: PDF, DOCX, XLSX, PPTX, DOC, XLS, PPT, PPS, PPSX, ODT, RTF, HTML, JPG, PNG, TIFF, HEIC, GIF, WebP, SVG, TGA, EPS.
+
+### Extraer texto y datos
+
+```bash
+# Extraer texto plano
+curl -X POST https://api.nutrient.io/build \
+  -H "Authorization: Bearer $NUTRIENT_API_KEY" \
+  -F "document.pdf=@document.pdf" \
+  -F 'instructions={"parts":[{"file":"document.pdf"}],"output":{"type":"text"}}' \
+  -o salida.txt
+
+# Extraer tablas como Excel
+curl -X POST https://api.nutrient.io/build \
+  -H "Authorization: Bearer $NUTRIENT_API_KEY" \
+  -F "document.pdf=@document.pdf" \
+  -F 'instructions={"parts":[{"file":"document.pdf"}],"output":{"type":"xlsx"}}' \
+  -o tablas.xlsx
+```
+
+### OCR de documentos escaneados
+
+```bash
+# OCR a PDF buscable (soporta más de 100 idiomas)
+curl -X POST https://api.nutrient.io/build \
+  -H "Authorization: Bearer $NUTRIENT_API_KEY" \
+  -F "scanned.pdf=@scanned.pdf" \
+  -F 'instructions={"parts":[{"file":"scanned.pdf"}],"actions":[{"type":"ocr","language":"spanish"}]}' \
+  -o buscable.pdf
+```
+
+Idiomas: soporta más de 100 idiomas mediante códigos ISO 639-2 (p. ej. `spa`, `eng`, `deu`, `fra`, `jpn`, `kor`, `chi_sim`, `chi_tra`, `ara`, `hin`, `rus`). También funcionan nombres completos en inglés como `spanish` o `german`. Consulta la [tabla completa de idiomas OCR](https://www.nutrient.io/guides/document-engine/ocr/language-support/) para ver todos los códigos soportados.
+
+### Censurar información sensible
+
+```bash
+# Basado en presets (SSN, email)
+curl -X POST https://api.nutrient.io/build \
+  -H "Authorization: Bearer $NUTRIENT_API_KEY" \
+  -F "document.pdf=@document.pdf" \
+  -F 'instructions={"parts":[{"file":"document.pdf"}],"actions":[{"type":"redaction","strategy":"preset","strategyOptions":{"preset":"social-security-number"}},{"type":"redaction","strategy":"preset","strategyOptions":{"preset":"email-address"}}]}' \
+  -o censurado.pdf
+
+# Basado en regex
+curl -X POST https://api.nutrient.io/build \
+  -H "Authorization: Bearer $NUTRIENT_API_KEY" \
+  -F "document.pdf=@document.pdf" \
+  -F 'instructions={"parts":[{"file":"document.pdf"}],"actions":[{"type":"redaction","strategy":"regex","strategyOptions":{"regex":"\\b[A-Z]{2}\\d{6}\\b"}}]}' \
+  -o censurado.pdf
+```
+
+Presets disponibles: `social-security-number`, `email-address`, `credit-card-number`, `international-phone-number`, `north-american-phone-number`, `date`, `time`, `url`, `ipv4`, `ipv6`, `mac-address`, `us-zip-code`, `vin`.
+
+### Añadir marcas de agua
+
+```bash
+curl -X POST https://api.nutrient.io/build \
+  -H "Authorization: Bearer $NUTRIENT_API_KEY" \
+  -F "document.pdf=@document.pdf" \
+  -F 'instructions={"parts":[{"file":"document.pdf"}],"actions":[{"type":"watermark","text":"CONFIDENCIAL","fontSize":72,"opacity":0.3,"rotation":-45}]}' \
+  -o con-marca.pdf
+```
+
+### Firmas digitales
+
+```bash
+# Firma CMS autofirmada
+curl -X POST https://api.nutrient.io/build \
+  -H "Authorization: Bearer $NUTRIENT_API_KEY" \
+  -F "document.pdf=@document.pdf" \
+  -F 'instructions={"parts":[{"file":"document.pdf"}],"actions":[{"type":"sign","signatureType":"cms"}]}' \
+  -o firmado.pdf
+```
+
+### Rellenar formularios PDF
+
+```bash
+curl -X POST https://api.nutrient.io/build \
+  -H "Authorization: Bearer $NUTRIENT_API_KEY" \
+  -F "form.pdf=@form.pdf" \
+  -F 'instructions={"parts":[{"file":"form.pdf"}],"actions":[{"type":"fillForm","formFields":{"name":"Juana Pérez","email":"juana@ejemplo.com","date":"2026-02-06"}}]}' \
+  -o rellenado.pdf
+```
+
+## Servidor MCP (alternativa)
+
+Para una integración nativa como herramientas del agente, usa el servidor MCP de Nutrient en lugar de curl (recuerda: sigue siendo tu propia API key de Nutrient):
+
+```json
+{
+  "mcpServers": {
+    "nutrient-dws": {
+      "command": "npx",
+      "args": ["-y", "@nutrient-sdk/dws-mcp-server"],
+      "env": {
+        "NUTRIENT_DWS_API_KEY": "TU_API_KEY",
+        "SANDBOX_PATH": "/ruta/al/directorio/de/trabajo"
+      }
+    }
+  }
+}
+```
+
+## Cuándo usarla
+
+- Convertir documentos entre formatos (PDF, DOCX, XLSX, PPTX, HTML, imágenes).
+- Extraer texto, tablas o pares clave-valor de PDFs.
+- Aplicar OCR a documentos escaneados o imágenes.
+- Censurar PII antes de compartir documentos.
+- Añadir marcas de agua a borradores o documentos confidenciales.
+- Firmar digitalmente contratos o acuerdos.
+- Rellenar formularios PDF de forma programática.
+
+## Enlaces
+
+- [Playground de la API](https://dashboard.nutrient.io/processor-api/playground/)
+- [Documentación completa de la API](https://www.nutrient.io/guides/dws-processor/)
+- [Servidor MCP en npm](https://www.npmjs.com/package/@nutrient-sdk/dws-mcp-server)