theus-cli 0.2.82 → 0.2.84

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

@@ -1,263 +0,0 @@
----
-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

@@ -1,168 +0,0 @@
----
-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)