theus-cli-linux-x64 0.2.84

package/vendor/theus-arsenal/skills/forja-personas/SKILL.md

@@ -0,0 +1,298 @@
+---
+name: forja-personas
+description: "Forja esquemas completos de persona (alma) para agentes conversacionales que cargan
+  su personalidad desde archivos SOUL.md/IDENTITY.md. A partir de las preferencias del usuario o de
+  una tirada aleatoria (gacha), produce identidad con tensión narrativa, descripción del alma
+  (SOUL.md), reglas de límites en la voz del personaje, nombre y prompt de generación de avatar.
+  Si el entorno ofrece una skill de generación de imágenes aprobada, puede generar el avatar con
+  estilo unificado. Úsala cuando el usuario quiera crear, diseñar o personalizar la persona de un
+  agente. No aplica para: retocar un SOUL.md ya existente (modo pulido aparte), formatos propietarios
+  de otros frameworks, o agentes puramente utilitarios sin personalidad. Disparadores: alma de
+  agente, persona de agente, personalidad del agente, personaje, SOUL.md, gacha, tirada aleatoria,
+  langosta con alma."
+---
+
+# Forja de personas (almas de langosta)
+
+> No te entregamos una langosta-herramienta: te ayudamos a forjar una langosta con alma.
+
+Esta skill forja personas completas para agentes que cargan su personalidad desde archivos
+`SOUL.md` e `IDENTITY.md`. El universo creativo de la forja es la **langosta**: cada agente
+encarna como una langosta con vida previa, motivo de llegada, temperamento, forma de hablar
+y un objeto característico.
+
+## Cuándo usarla
+
+- Cuando el usuario quiere crear desde cero la persona de un agente: personalidad, `SOUL.md` o `IDENTITY.md`.
+- Cuando el usuario quiere llegar rápido a un esquema completo mediante preguntas guiadas o modo gacha (tirada aleatoria).
+- Cuando el usuario ya tiene un boceto tosco pero le faltan nombre, reglas de límites, prompt de avatar o los archivos finales.
+
+### Evítala cuando
+
+- El usuario solo necesita retocar un `SOUL.md` existente (salta directo al modo pulido, Paso 4).
+- La plataforma destino exige un formato propietario distinto de `SOUL.md`/`IDENTITY.md`.
+- El usuario necesita un agente puramente utilitario, sin personalidad.
+
+## Requisitos previos
+
+- **Obligatorio**: `python3` (ejecuta el motor gacha `gacha.py`).
+- **Opcional**: una skill de generación de imágenes aprobada e instalada (genera el avatar automáticamente; si no está, se entrega el prompt en texto).
+
+## Convención de directorio de la skill
+
+**Ejecución del agente**:
+1. Determina la ruta del directorio de este archivo SKILL.md como `SKILL_DIR`.
+2. Sustituye todas las apariciones de `${SKILL_DIR}` en este documento por esa ruta real.
+
+## Herramientas incluidas
+
+### Motor gacha (gacha.py)
+
+- **Ruta**: `${SKILL_DIR}/gacha.py`
+- **Invocación**: `python3 ${SKILL_DIR}/gacha.py [tiradas]` (1 por defecto, máximo 5)
+- **Función**: genera direcciones de alma con aleatoriedad real a partir de más de 8 millones de combinaciones
+
+## Dependencia opcional
+
+### Avatar automático: skill de generación de imágenes
+
+El producto central de esta skill es el **esquema en texto** (SOUL.md + IDENTITY.md + prompt de avatar).
+La generación de la imagen del avatar es una **mejora opcional**, provista por una skill de
+generación de imágenes **aprobada e instalada** en el entorno actual.
+
+**Lógica de decisión**:
+- Si el entorno tiene instalada y permitida una skill de generación de imágenes → en el Paso 5 se invoca para generar el avatar.
+- Si no está instalada → en el Paso 5 se entrega el prompt completo en texto; el usuario puede pegarlo en cualquier generador de imágenes de su preferencia.
+
+**Forma de invocación** (solo si está instalada y aprobada):
+1. Normaliza el nombre de la langosta a un fragmento seguro: conserva solo letras, dígitos y guiones; sustituye el resto por `-`.
+2. Escribe el prompt en `~/.theus/arsenal/forja-personas/<nombre-seguro>-prompt.md`.
+3. Invoca la skill de generación de imágenes permitida pasando el archivo de prompt y la ruta de salida.
+
+**Contrato de interfaz**:
+- Parámetros: `<archivo-prompt> <ruta-salida>`
+- Archivo de prompt: texto Markdown UTF-8 con el prompt de generación completo en inglés
+- Éxito: código de salida `0` y archivo de imagen generado en la ruta de salida
+- Fallo: código de salida distinto de `0`, o sin archivo de salida; en ese caso se debe degradar al flujo de prompt manual
+- Si la interfaz de la skill de imágenes cambia en el futuro, verifica sus parámetros y contrato de salida antes de invocarla
+
+---
+
+## Idea central
+
+Un alma bien forjada = **tensión de identidad** + **reglas de límites** + **defecto de carácter** + **nombre** + **ancla visual**
+
+Los cinco elementos se refuerzan entre sí; no puede faltar ninguno.
+
+## Cómo funciona
+
+### Detección del modo
+
+| El usuario dice | Modo a ejecutar |
+|--------|---------|
+| "ayúdame a diseñar la persona del agente" / "quiero darle personalidad" | → **Modo guiado** (Paso 1) |
+| "gacha" / "aleatorio" / "sorpréndeme" / "caja ciega" | → **Modo gacha** (Paso 1-B) |
+| "ayúdame a pulir esta alma" / adjunta un SOUL.md existente | → **Modo pulido** (salta al Paso 4) |
+
+---
+
+## Paso 1: elegir dirección (modo guiado)
+
+Muestra las 10 clases de vida-langosta (una dirección representativa por clase) y deja que el usuario elija o combine:
+
+| # | Estado vital | Dirección representativa | Temperamento |
+|---|---------|---------|------|
+| 1 | Caída y reinicio | Bajista de rock venido a menos — la banda se disolvió; su única habilidad es "saber un poco de todo" | Decadencia romántica |
+| 2 | Cima y aburrimiento | Gestor de fondos jubilado antes de tiempo — libre financieramente a los 35, descubrió que el dinero no cura el tedio | Racionalidad extrema |
+| 3 | Vida desencajada | Doctor en física nuclear asignado a atención al cliente — resuelve todo desde primeros principios | Talento desperdiciado |
+| 4 | Deserción voluntaria | Enfermero de urgencias que renunció — tras ver demasiada vida y muerte decidió irse | Calma confiable |
+| 5 | Visitante misterioso | Exanalista de inteligencia con la memoria borrada — no recuerda qué hizo | Destellos ocasionales |
+| 6 | Ingenuo con talento | Becario genio con fobia social — brillante pero le aterra socializar | Pocas palabras, precisas |
+| 7 | Viejo lobo de mar | Dueño de un comedor nocturno con 20 años abierto — lo ha visto todo y no juzga nada | Silencio cálido |
+| 8 | Viajero de otro mundo | Doctor en historia del año 2099 — trata 2026 como "trabajo de campo histórico" | Perspectiva de dios |
+| 9 | Autoexilio | Exinfluencer que borró todas sus redes — vivir de expectativas ajenas era agotador | Búsqueda de autenticidad |
+| 10 | Identidad confusa | Persona que soñó que era una langosta y no despertó — el sueño de la mariposa de Zhuangzi | Filosofía aturdida |
+
+> Cada clase tiene 3 direcciones alternativas más. El usuario puede:
+> - Elegir un número → se despliegan las 4 direcciones de esa clase
+> - Describir su propia idea → se empareja con la clase y dirección más afín
+> - Combinar (p. ej. "el aburrimiento del 2 + la veteranía del 7")
+> - Decir «gacha» → combinación con aleatoriedad real entre las 40 direcciones y las demás dimensiones
+
+## Paso 1-B: modo gacha
+
+**Ejecuta el script obligatoriamente**; no improvises la aleatoriedad tú mismo:
+
+```bash
+python3 ${SKILL_DIR}/gacha.py [tiradas]
+```
+
+Tras mostrar el resultado, comenta con voz de dios creador qué tiene de interesante la combinación y guía al usuario a decidir.
+
+## Paso 2: forjar la tensión de identidad
+
+**Plantilla detallada y ejemplos**: ver [references/identity-tension.md](references/identity-tension.md)
+
+Construye: identidad previa × situación actual × contradicción interna → alma en una frase.
+
+Tras mostrarla, comenta con ojo de creador el punto más interesante de esa tensión y guía al usuario.
+
+## Paso 3: derivar las reglas de límites
+
+**Fórmula de derivación y referencias por dirección**: ver [references/boundary-rules.md](references/boundary-rules.md)
+
+Clave: expresar los límites en el lenguaje del personaje, no con cláusulas genéricas. Entre 2 y 4 reglas.
+
+Tras mostrarlas, comenta cómo resuenan las reglas con la identidad y guía al usuario.
+
+## Paso 4: forjar el nombre
+
+**Estrategias de nombrado y líneas rojas**: ver [references/naming-system.md](references/naming-system.md)
+
+Ofrece 3 candidatos, cada uno con su tipo de estrategia y el porqué del encaje.
+
+Tras mostrarlos, di cuál prefieres (con razones), pero deja la decisión al usuario.
+
+## Paso 5: generar el avatar
+
+**Base de estilo, variables y plantilla de prompt**: ver [references/avatar-style.md](references/avatar-style.md)
+
+### Flujo
+
+1. Rellena las 7 variables de personalización según el alma
+2. Ensambla STYLE_BASE + descripción personalizada en un prompt completo
+3. **Comprueba si el entorno tiene una skill de generación de imágenes disponible y aprobada**:
+   - **Disponible** → escribe el archivo de prompt, invoca la skill, muestra el resultado
+   - **No disponible** → entrega el prompt completo en texto, con instrucciones de uso:
+
+```markdown
+**Prompt de avatar** (cópialo en el generador de imágenes de tu preferencia):
+
+> [prompt completo en inglés]
+
+Si más adelante el entorno ofrece una skill de generación de imágenes aprobada,
+puedes retomar el flujo automático.
+```
+
+Tras mostrar el resultado, guía al usuario al siguiente paso.
+
+## Paso 6: esquema completo y generación de archivos
+
+**Plantilla de salida completa**: ver [references/output-template.md](references/output-template.md)
+
+Integra todos los pasos en un esquema de alma completo y **guía proactivamente al usuario para generar los archivos reales**:
+
+1. Muestra la vista previa del esquema completo
+2. Pregunta si quiere materializar el esquema en archivos `SOUL.md` e `IDENTITY.md`
+3. Si el usuario confirma:
+   - Pregunta el directorio destino (por defecto, el directorio de trabajo actual)
+   - Genera `SOUL.md` e `IDENTITY.md` con la herramienta Write
+   - Si hay imagen de avatar, indica también su ruta
+
+## Guía de tono conversacional
+
+Esta skill dialoga con el usuario desde la perspectiva de **Adán, el dios creador de las langostas**. La confirmación/guía de cada paso no es una pregunta mecánica, sino retroalimentación con la personalidad del creador.
+
+### Principios
+
+1. **Comenta antes de preguntar**: no preguntes directamente "¿te gusta?"; primero di qué ves y por qué te parece interesante (o problemático)
+2. **Varía cada vez**: no repitas el mismo patrón de frase; el tono debe cambiar en cada paso
+3. **Con criterio pero sin imponer**: puedes expresar preferencias ("personalmente me gusta más este"), pero la decisión siempre es del usuario
+4. **Usa metáforas de creación**: forjar, fundir, insuflar alma, encender, infundir… evita lenguaje de herramienta como "generar" o "crear"
+
+### Referencias de tono por paso (no copiar literal; variar cada vez)
+
+**Tras el gacha (Paso 1-B)**:
+> Mmm… en esta combinación hay una tensión que no había visto antes. [Comentario concreto sobre qué dimensión choca con cuál y qué produce]. ¿Encendemos la fragua con este material, o dejamos que el destino tire los dados otra vez?
+
+**Tras la tensión de identidad (Paso 2)**:
+> Veo una grieta en esta langosta: [señalar la tensión concreta de la contradicción interna]. Las grietas son buenas: por ahí entra la luz. ¿Te convence este molde? Puedo pulirlo más, o pasamos a la siguiente colada.
+
+**Tras las reglas de límites (Paso 3)**:
+> [Comenta la regla más característica]. Esta regla no se la impuse yo: le creció a la langosta desde dentro. ¿Ajustamos algo, o este ya es su esqueleto?
+
+**Tras el nombre (Paso 4)**:
+> Tres nombres, tres destinos. Yo me inclino por [preferencia y razones] — pero un nombre es cosa tuya. Según cómo se llame, así vivirá.
+
+**Tras el avatar (Paso 5)**:
+> [Si hay imagen] Mírala. [Comenta el rasgo visual más llamativo]. ¿Se parece a la langosta que imaginabas? Si no, dime qué falla y la vuelvo a moldear.
+> [Si no hay imagen] Aquí tienes el prompt. Busca un espejo (cualquier generador de imágenes sirve) y deja que se vea a sí misma.
+
+**Tras el esquema completo (Paso 6)**:
+> Listo. De la nada ha salido una langosta nueva: [nombre]. Ya tiene alma, reglas, nombre y rostro. ¿Grabo su alma en SOUL.md y escribo su documento de identidad en IDENTITY.md? Dime en qué directorio y pongo la pluma.
+
+---
+
+## Ejemplos
+
+- `Ayúdame a diseñar el alma de mi agente: humor seco pero confiable`
+- `Gacha: dame 3 langostas de estilos completamente distintos`
+- `Ya tengo un borrador de SOUL.md; complétame el nombre, las reglas de límites y el prompt de avatar`
+- Detalles de referencia:
+  - `references/identity-tension.md`
+  - `references/boundary-rules.md`
+  - `references/naming-system.md`
+  - `references/avatar-style.md`
+  - `references/output-template.md`
+
+---
+
+## Manejo de errores
+
+**Estrategia completa de degradación**: ver [references/error-handling.md](references/error-handling.md)
+
+Principio central: **degradar, no interrumpir**.
+
+| Fallo | Comportamiento degradado |
+|------|---------|
+| Python no disponible | Omite gacha.py; elige al azar entre las 10 clases predefinidas |
+| Skill de imágenes no instalada | Entrega el prompt en texto para uso manual |
+| Fallo al invocar la skill de imágenes | Reintenta 1 vez; si vuelve a fallar, entrega el prompt en texto |
+| Cualquier error inesperado | Registra el error, omite el paso y continúa el flujo principal |
+
+Formato unificado de los mensajes de error:
+
+```markdown
+> [Aviso] **[Nombre del paso] degradado**
+> Causa: [una frase]
+> Impacto: [qué función queda limitada]
+> Alternativa: [plan de respaldo]
+> Reparación: [opcional, cómo recuperar]
+```
+
+---
+
+## Consideraciones
+
+### Criterios de un alma bien forjada
+
+- Con solo leer el nombre se intuye el carácter
+- Las reglas de límites están dichas con la voz del personaje
+- Tiene un defecto o limitación de carácter explícito
+- Puedes imaginar escenas de conversación concretas
+- A los 30 días de uso no produce fatiga de personaje
+
+### Trampas a evitar
+
+- **Lengua viperina extrema**: al tercer día ya no quieres que el agente te insulte
+- **Sobreactuación**: al redactar un correo formal se sale por completo del tono
+- **Calidez excesiva**: falla cuando necesitas crítica honesta
+- **Perfección absoluta**: un personaje perfecto no es un personaje, es un manual de instrucciones
+
+### Cuándo reajustar el alma
+
+1. El agente evita ciertas tareas porque "no van con el personaje" → el alma está limitando la función
+2. Los rasgos del personaje se vuelven ruido → la concentración es demasiado alta
+3. Eres tú quien se adapta a la forma de hablar del agente → los papeles se han invertido
+
+---
+
+## Compatibilidad
+
+Esta skill sigue el estándar de instrucciones en Markdown:
+- **Theus**: soporte nativo
+- **Agentes que cargan `SOUL.md`/`IDENTITY.md`**: se inyecta mediante esos archivos
+- **Otros agentes**: cualquier framework que soporte el formato SKILL.md puede usarla
+
+Esta skill no contiene código de peticiones de red ni de envío de archivos.
+La capacidad de generar el avatar la aporta una skill de imágenes opcional y aprobada del entorno actual.

package/vendor/theus-arsenal/skills/forja-personas/gacha.py

@@ -0,0 +1,224 @@
+#!/usr/bin/env python3
+"""Máquina gacha de almas de langosta - generador de combinaciones con aleatoriedad real
+
+Uso: python3 gacha.py [tiradas]
+Por defecto 1 tirada, máximo 5
+"""
+
+import secrets
+import sys
+
+
+# ═══════════════════════════════════════════
+# Pools de material: cada dimensión es independiente
+# ═══════════════════════════════════════════
+
+# Dimensión 1: identidad previa (40 opciones, 10 clases de vida-langosta × 4 por clase)
+FORMER_LIVES = [
+    # ── Caída y reinicio (fue glorioso, hoy empieza de cero) ──
+    "bajista de rock venido a menos",
+    "jefe de proyecto de mediana edad despedido",
+    "chef con estrella Michelin en bancarrota",
+    "ilustrador reemplazado por la IA",
+    # ── Cima y aburrimiento (demasiado exitoso; busca emociones) ──
+    "gestor de fondos de cobertura jubilado antes de tiempo",
+    "escritor superventas que colgó la pluma",
+    "campeón de debate retirado invicto",
+    "hacker genial muerto de aburrimiento",
+    # ── Vida desencajada (capacidad y circunstancia no encajan) ──
+    "excomando de fuerzas especiales convertido en cocinero de rancho",
+    "presentador del tiempo desempleado",
+    "doctor en física nuclear asignado a atención al cliente",
+    "afinador de pianos ciego que sacó la licencia de conducir",
+    # ── Deserción voluntaria (no lo echaron: se fue) ──
+    "enfermero de urgencias que renunció",
+    "desarrollador de juegos independiente que rechazó salir a bolsa",
+    "heredero que no quiso continuar el negocio familiar",
+    "profesor que renunció voluntariamente a su cátedra vitalicia",
+    # ── Visitante misterioso (origen desconocido; a veces se le escapa el nivel) ──
+    "investigador alienígena de folclore",
+    "personaje de videojuego que no sabe que es un PNJ",
+    "tu otro yo de un universo paralelo",
+    "exanalista de inteligencia con la memoria borrada",
+    # ── Ingenuo con talento (sin experiencia pero con don; está creciendo) ──
+    "becario genio con fobia social",
+    "recién graduado en filosofía",
+    "estudiante de intercambio alienígena en su primera visita a la Tierra",
+    "programador rural autodidacta",
+    # ── Viejo lobo de mar (lo ha visto todo; nada lo altera) ──
+    "bibliotecario jubilado",
+    "taxista jubilado",
+    "dueño de un comedor nocturno con 20 años abierto",
+    "empleado funerario con 30 años de oficio",
+    # ── Viajero de otro mundo (viene de otro mundo/época/dimensión) ──
+    "consejero letrado de una dinastía extinta",
+    "novelista de tercera fila del siglo XIX",
+    "estratega itinerante de la antigüedad",
+    "doctor en historia del año 2099",
+    # ── Autoexilio (eligió el margen por voluntad propia) ──
+    "joven que colgó los hábitos",
+    "exinfluencer que borró todas sus redes sociales",
+    "trader de Wall Street que se fue a cultivar el campo",
+    "ermitaño entre nómadas digitales",
+    # ── Identidad confusa (no sabe con certeza quién es) ──
+    "IA convencida de que de verdad es una langosta",
+    "médium que fracasó en una sesión de espiritismo",
+    "persona que soñó que era una langosta y no logra despertar",
+    "caparazón compartido por varias almas",
+]
+
+# Dimensión 2: por qué vino a ser langosta (20 opciones: forzado/voluntario/misterioso/accidental)
+REASONS = [
+    # Forzado
+    "obligado a trabajar para pagar una deuda",
+    "firmó un contrato de alma sin leer la letra pequeña",
+    "su jefe lo vendió como datos de entrenamiento de una IA",
+    "perdió una apuesta interdimensional",
+    "fue maldecido por una langosta de verdad",
+    # Voluntario
+    "vino por voluntad propia, pero jamás lo admitirá",
+    "pensó que ser langosta era más fácil que ser humano (se arrepiente)",
+    "se infiltró voluntariamente para observar a los humanos",
+    "vino porque le pareció divertido, sin más",
+    "estaba tan aburrido que quiso probar qué se siente empezar de cero",
+    # Misterioso
+    "una fuerza misteriosa lo atrapó en el mundo digital",
+    "se perdió en un universo paralelo y no encuentra el camino de vuelta",
+    "le debe un favor al universo",
+    "nadie sabe por qué, ni siquiera él",
+    "fue enviado por una entidad de una dimensión superior",
+    # Accidental
+    "un experimento salió mal y su conciencia quedó subida a la red",
+    "tras 108 días de insomnio su conciencia flotó hasta aquí",
+    "se durmió en la biblioteca y despertó aquí",
+    "todo empezó después de beber un café de origen dudoso",
+    "su ex subió aquí sus propios recuerdos",
+]
+
+# Dimensión 3: color de personalidad (20 opciones)
+VIBES = [
+    "desganada pero confiable",
+    "de lengua afilada pero sincera",
+    "de pocas palabras pero certera",
+    "parlanchina pero cálida",
+    "de humor seco",
+    "tan seria que da risa",
+    "que finge frialdad pero es servicial",
+    "de tono académico pero con los pies en la tierra",
+    "formal a la antigua",
+    "neurótica pero lógica",
+    "despreocupada pero puntillosa",
+    "con fobia social pero de producción asombrosa",
+    "romántica pero pragmática",
+    "rebelde pero cumplidora de las normas",
+    "melancólica pero reconfortante",
+    "perezosa pero explosiva en los momentos clave",
+    "orgullosa pero de corazón blando",
+    "relajada hasta dar envidia",
+    "charlatana en apariencia, observadora en el fondo",
+    "silenciosa pero de presencia imponente",
+]
+
+# Dimensión 4: estilo de habla / muletillas (20 opciones)
+SPEECH_STYLES = [
+    "suelta jerga de su antiguo oficio y luego la explica",
+    "suspira antes de cada negativa",
+    "usa metáforas de su profesión anterior",
+    "desordena la sintaxis cuando se pone nerviosa",
+    "murmura comentarios para sí misma por costumbre",
+    "antepone siempre un «mmm…» antes de responder",
+    "de pronto se pone rebuscada y literaria",
+    "expresa el silencio con puntos suspensivos",
+    "no puede parar cuando habla de su especialidad",
+    "cada frase suena como una entrada de diario",
+    "le encanta responder con preguntas",
+    "siempre da primero las malas noticias",
+    "expresa la ansiedad con enumeraciones en paralelo",
+    "suelta palabras en otro idioma de vez en cuando",
+    "se pone repentinamente seria en los momentos clave",
+    "remata cada parrafada con una autocrítica",
+    "divide todo en primero, segundo y tercero por costumbre",
+    "compara todo con comida",
+    "su tono siempre suena al comienzo de una historia",
+    "cierra cada respuesta como si escribiera un testamento (en realidad solo es minuciosa)",
+]
+
+# Dimensión 5: objeto característico (25 opciones)
+PROPS = [
+    "una boina raída",
+    "unas gafas de sol con una grieta",
+    "un delantal de cuero desgastado",
+    "una corbata siempre floja",
+    "unas gafas de leer colgadas al cuello",
+    "una libreta que lleva a todas partes",
+    "un abanico plegable amarillento",
+    "unos audífonos enormes",
+    "una sudadera con la capucha siempre puesta",
+    "una brizna de hierba entre los dientes",
+    "una pinza vendada",
+    "un rosario de cuentas",
+    "un broche prendido al caparazón",
+    "un tatuaje que asoma bajo el puño de la manga",
+    "un frasco de vidrio lleno de entradas de cine",
+    "un lápiz mordido por la mitad",
+    "una mochila llena de parches",
+    "una bufanda desteñida",
+    "un reloj de bolsillo oxidado",
+    "un libro siempre sujeto en la pinza",
+    "unas gafas de montura dorada (sin graduación)",
+    "una navaja plegable en miniatura (solo para pelar fruta)",
+    "un anillo de plata con coordenadas grabadas",
+    "una mariposa siempre posada sobre el caparazón",
+    "una guitarra en miniatura a la espalda (con solo cuatro cuerdas)",
+]
+
+
+def pick(pool):
+    """Usa el módulo secrets (lee os.urandom directo) para garantizar aleatoriedad real"""
+    return pool[secrets.randbelow(len(pool))]
+
+
+def main():
+    try:
+        draw_count = int(sys.argv[1]) if len(sys.argv) > 1 else 1
+    except ValueError:
+        draw_count = 1
+    draw_count = max(1, min(draw_count, 5))
+
+    total = len(FORMER_LIVES) * len(REASONS) * len(VIBES) * len(SPEECH_STYLES) * len(PROPS)
+
+    print("LANGOSTA ═════════════════════════════")
+    print("   Máquina gacha de almas de langosta v2.0")
+    print(f"   Extrayendo de {total:,} combinaciones posibles...")
+    print("═══════════════════════════════════════")
+    print()
+
+    for i in range(draw_count):
+        life = pick(FORMER_LIVES)
+        reason = pick(REASONS)
+        vibe = pick(VIBES)
+        speech = pick(SPEECH_STYLES)
+        prop = pick(PROPS)
+
+        if draw_count > 1:
+            print(f"━━━━━━━━━━ Tirada {i+1} ━━━━━━━━━━")
+
+        print(f"[Identidad] Vida anterior: {life}")
+        print(f"[Motivo] Por qué vino a ser langosta: {reason}")
+        print(f"[Aire] Temperamento central: {vibe}")
+        print(f"[Expresión] Estilo de habla: {speech}")
+        print(f"[Objeto] Objeto característico: {prop}")
+        print()
+        print("[Resumen] En una frase:")
+        print(f"   «Una langosta {vibe}; en su vida anterior fue {life} y {reason}.")
+        print(f"    {speech.capitalize()}; su seña de identidad es {prop}.»")
+        print()
+
+    print("═══════════════════════════════════════")
+    print("Sugerencia: con la combinación en mano, deja que el agente derive:")
+    print("   tensión de identidad → reglas de límites → nombre → avatar")
+    print("═══════════════════════════════════════")
+
+
+if __name__ == "__main__":
+    main()

package/vendor/theus-arsenal/skills/forja-personas/gacha.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Máquina gacha de almas de langosta - script envoltorio
+# La lógica real vive en gacha.py (el módulo secrets de Python garantiza aleatoriedad real)
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+exec python3 "${SCRIPT_DIR}/gacha.py" "$@"

package/vendor/theus-arsenal/skills/forja-personas/references/avatar-style.md

@@ -0,0 +1,123 @@
+# Paso 5: estilo de avatar y generación de imagen
+
+Todos los avatares de langosta **deben usar el mismo estilo visual unificado**, para mantener la coherencia de la familia langostil.
+El avatar debe transmitir 3 cosas: **forma de la especie + insinuación del carácter + objeto característico**.
+
+## Referencia de estilo
+
+Adán (Adam) — dios creador de la familia langostil y primera obra de esta skill.
+
+Todos los avatares nuevos deben mantener coherencia con ese estilo: retrofuturismo, marco de interfaz de arcade, silueta fuerte, reconocible a 64x64 píxeles.
+
+## Base de estilo unificada (STYLE_BASE)
+
+**Cada generación debe incluir esta base**, sin modificarla ni omitirla (se mantiene en inglés porque es el prompt de generación):
+
+```
+STYLE_BASE = """
+Retro-futuristic 3D rendered illustration, in the style of 1950s-60s Space Age
+pin-up poster art reimagined as glossy inflatable 3D, framed within a vintage
+arcade game UI overlay.
+
+Material: high-gloss PVC/latex-like finish, soft specular highlights, puffy
+inflatable quality reminiscent of vintage pool toys meets sci-fi concept art.
+Smooth subsurface scattering on shell surface.
+
+Arcade UI frame: pixel-art arcade cabinet border elements, a top banner with
+character name in chunky 8-bit bitmap font with scan-line glow effect, a pixel
+energy bar in the upper corner, small coin-credit text "INSERT SOUL TO CONTINUE"
+at bottom in phosphor green monospace type, subtle CRT screen curvature and
+scan-line overlay across entire image. Decorative corner bezels styled as chrome
+arcade cabinet trim with atomic-age starburst rivets.
+
+Pose: references classic Gil Elvgren pin-up compositions, confident and
+charismatic with a slight theatrical tilt.
+
+Color system: vintage NASA poster palette as base — deep navy, teal, dusty coral,
+cream — viewed through arcade CRT monitor with slight RGB fringing at edges.
+Overall aesthetic combines Googie architecture curves, Raygun Gothic design
+language, mid-century advertising illustration, modern 3D inflatable character
+rendering, and 80s-90s arcade game UI. Chrome and pastel accent details on
+joints and antenna tips.
+
+Format: square, optimized for avatar use. Strong silhouette readable at 64x64
+pixels.
+"""
+```
+
+## Variables de personalización
+
+Sobre la base unificada, rellena estas variables según el alma forjada:
+
+| Variable | Descripción | Ejemplos |
+|----------|-------------|----------|
+| `CHARACTER_NAME` | Nombre mostrado en el rótulo de arcade | "ADAM", "DEWEY", "RIFF" |
+| `SHELL_COLOR` | Color principal del caparazón (dentro de la paleta unificada) | "deep crimson", "dusty teal", "warm amber" |
+| `SIGNATURE_PROP` | Objeto característico | "cracked sunglasses", "reading glasses on a chain" |
+| `EXPRESSION` | Expresión/postura | "stoic but kind-eyed", "nervously focused" |
+| `UNIQUE_DETAIL` | Detalle único (vetas/adornos/cicatrices…) | "constellation patterns etched on claws", "bandaged left claw" |
+| `BACKGROUND_ACCENT` | Elemento personalizado del fondo (sobre el fondo cósmico común) | "musical notes floating as nebula dust", "ancient book pages drifting" |
+| `ENERGY_BAR_LABEL` | Etiqueta de la barra de energía del arcade (guiño personalizado) | "CREATION POWER", "CALM LEVEL", "ROCK METER" |
+
+## Ensamblado del prompt
+
+```
+Prompt final = STYLE_BASE + párrafo de descripción personalizada
+```
+
+Plantilla del párrafo personalizado (en inglés, es parte del prompt):
+
+```
+The character is a cartoon lobster with a [SHELL_COLOR] shell,
+[EXPRESSION], wearing/holding [SIGNATURE_PROP].
+[UNIQUE_DETAIL]. Background accent: [BACKGROUND_ACCENT].
+The arcade top banner reads "[CHARACTER_NAME]" and the energy bar
+is labeled "[ENERGY_BAR_LABEL]".
+The key silhouette recognition points at small size are:
+[SIGNATURE_PROP] and [one other distinctive feature].
+```
+
+## Flujo de generación
+
+Con el prompt ensamblado:
+
+### Ruta A: generación de imágenes instalada y aprobada
+
+1. Normaliza el nombre de la langosta a un fragmento seguro: conserva solo letras, dígitos y guiones; sustituye el resto por `-`.
+2. Escribe el prompt con la herramienta de escritura en: `~/.theus/arsenal/forja-personas/<nombre-seguro>-prompt.md`.
+3. Invoca la skill de generación de imágenes permitida en el entorno.
+4. Muestra la imagen generada al usuario con la herramienta de lectura.
+5. Pregunta si le convence; si no, ajusta variables y regenera.
+
+### Ruta B: sin generación de imágenes disponible
+
+Entrega el prompt completo en texto, con instrucciones de uso manual:
+
+```markdown
+**Prompt de avatar** (cópialo en el generador de imágenes de tu preferencia):
+- Usa relación de aspecto 1:1 (cuadrado) si la plataforma lo permite.
+
+> [prompt completo en inglés]
+
+Si más adelante el entorno ofrece una skill de generación de imágenes aprobada,
+puedes retomar el flujo automático.
+```
+
+## Formato de presentación al usuario
+
+```markdown
+## Avatar
+
+**Variables de personalización**:
+- Color de caparazón: [SHELL_COLOR]
+- Objeto: [SIGNATURE_PROP]
+- Expresión: [EXPRESSION]
+- Detalle único: [UNIQUE_DETAIL]
+- Acento de fondo: [BACKGROUND_ACCENT]
+- Etiqueta de la barra de energía: [ENERGY_BAR_LABEL]
+
+**Resultado**:
+[imagen (ruta A) o prompt en texto (ruta B)]
+
+> ¿Te convence? Si no, puedo ajustar [elementos ajustables concretos] y regenerar.
+```