@xmarts/genius-setup 1.14.0 → 1.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmarts/genius-setup",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "One-command, self-updating onboarding for Xmarts Genius (Brain MCP + per-turn injection + automatic session/time capture + presence heartbeat for honest time-tracking 'amarre' + plan/committee→Brain enforcement + CLAUDE.md protocol + MCP fan-out: provisions the consultant's granted MCP servers into Claude Code & Claude Desktop). Secret-free onboarding via single-use setup-token exchange. Installs once; self-updates daily so new tools/skills/features arrive with zero action.",
   "bin": {
     "genius-setup": "bin/genius-setup.js"

package/plugin/skills/content-war-tank/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: content-war-tank
+description: La máquina de guerra de creación de contenido de Xmarts — pipeline quirúrgico, estratégico y data-driven que orquesta TODAS las herramientas (ContentForge para inteligencia+estrategia+scripts con Opus 4.8, NanoBanana2 para imágenes, Veo para video, Remotion para animación de charts/flujos, ElevenLabs para voz). USAR cuando el usuario quiera crear un video/pieza de contenido serio, un guion estratégico, análisis competitivo de un canal/nicho, o "contenido tipo tanque de guerra". Nada se decide sin data.
+---
+
+# Content War-Tank — creación de contenido quirúrgica y estratégica
+
+Regla madre: **NUNCA empezar por el guion.** Se empieza por la DATA. Cada pieza
+nace de inteligencia competitiva, se valida contra lo que ya gana en el nicho, y
+sólo entonces se produce. Todas las herramientas están SERVIDAS (cero instalación
+del consultor). ContentForge vive en el MCP `contentforge` (servido desde VPS).
+
+## Las 6 fases (en orden — no saltar la 1 ni la 2)
+
+### Fase 1 — INTELIGENCIA (data primero, siempre)
+Antes de idear nada, medir el terreno con ContentForge:
+- `cf_intel_channel` / `cf_intel_leaderboard` → qué está ganando en el nicho, qué
+  canales/videos lideran, con qué formatos.
+- `cf_trends` → narrativas y temas en alza AHORA.
+- `cf_packaging_swaps` → títulos/miniaturas que convierten vs los que no.
+- Salida: un brief de oportunidad con evidencia (qué ángulo está desatendido y por qué ganaría).
+
+### Fase 2 — ESTRATEGIA (comparativa vs competidores)
+- Elegir UN ángulo del brief con el mayor gap (alto interés + baja saturación).
+- `cf_hook_library` → hooks probados para ese ángulo (no inventar hooks a ciegas).
+- `cf_pacing` → ritmo/beats objetivo por duración (30/60/90/120/150s).
+- Definir: objetivo, audiencia, plataforma + aspect ratio, UNA CTA, duración.
+- Delegar la estructura narrativa al skill `video-storytelling` (Hook≤2.5s → Value →
+  Proof a ~50% → CTA; diseñar para MUDO).
+
+### Fase 3 — GUION (Opus 4.8, grounded en la data)
+- `cf_run` genera el guion con **claude-opus-4-8** (tier deep), alimentado por el
+  brief de la Fase 1 — NO un guion genérico, uno anclado a lo que la data dijo que gana.
+- `cf_guards` → validar calidad/voz/claims antes de producir (fact-check con haiku).
+- `cf_script_get` → recuperar/versionar el guion aprobado.
+
+### Fase 4 — STORYBOARD (gate humano obligatorio)
+- Skill `video-storytelling`: storyboard-as-JSON (escenas, beats, visual, onScreenText,
+  voiceover, dataBindings, transición). **Aprobación humana ANTES de gastar generación.**
+  Es el "snapshot pre-cambio" del contenido.
+
+### Fase 5 — PRODUCCIÓN (cada activo con su modelo óptimo)
+Routing de modelos por tarea (todos servidos):
+| Activo | Herramienta / modelo | Cómo |
+|---|---|---|
+| **Imágenes** (keyframes, miniaturas, brand) | NanoBanana2 (`gemini-3.1-flash-image-preview`) · hi-fi: `imagen-4.0-ultra` | tool `generate_image` / skill `nanobanana-image-gen` |
+| **Video / motion** (b-roll, tomas cinemáticas) | **Google Veo 3.1** (`veo-3.1-generate-preview`, borradores: `veo-3.1-fast`) | Gemini key ya en el entorno; o Higgsfield para presets de cámara (skill `higgsfield-video`) |
+| **Animación** (charts, flujos de ideas, KPIs, intro/outro, subtítulos) | **Remotion** (React programático) | skill `remotion-video` — data-driven, branding del cliente |
+| **Voz** (narración custom) | **ElevenLabs** (`eleven_multilingual_v2`, es-MX) | skill `elevenlabs-voiceover` — audio tags, timestamps para captions |
+
+Regla de costo: iterar barato (nanobanana, veo-fast, kling), finalizar en premium
+(imagen-4-ultra, veo full). Keyframes SIEMPRE con NanoBanana2 propio; voz SIEMPRE
+ElevenLabs propio (no gastar créditos de terceros en lo que ya tenemos gratis).
+
+### Fase 6 — ENSAMBLAJE + MEDICIÓN
+- **Remotion** ensambla todo: escenas Veo + imágenes NanoBanana + charts animados +
+  captions word-by-word (para mudo) + voz ElevenLabs + branding/tema del cliente.
+- Publicar → volver a `cf_intel_*` para medir vs competidores: ¿cumplió la hipótesis
+  de la Fase 1? El resultado retro-alimenta la próxima ronda (loop de aprendizaje).
+
+## Mapa de modelos (task → model), autoritativo
+- **research / estrategia** → `claude-sonnet-5` (+ webSearch)
+- **guion / análisis profundo** → `claude-opus-4-8`
+- **fact-check / clasificación** → `claude-haiku-4-5`
+- **imagen** → `gemini-3.1-flash-image-preview` (NanoBanana2) · hi-fi `imagen-4.0-ultra`
+- **video** → `veo-3.1-generate-preview` (fast: `veo-3.1-fast`)
+- **animación** → Remotion
+- **voz** → ElevenLabs `eleven_multilingual_v2`
+
+## Principios no negociables
+1. **Data antes que creatividad** — sin Fase 1+2, no se produce.
+2. **Comparativa vs competidores** en cada brief (qué hacen los que ganan, dónde el gap).
+3. **Gate humano** en el storyboard antes de gastar generación.
+4. **Diseñar para mudo** (60% ve sin sonido) — hook y beats funcionan solo con texto.
+5. **Branding del cliente** (tema OKLCH, nunca hex hardcodeado — Brain #245) + anti-AI-slop (#5668).
+6. **Medir y retro-alimentar** — cada pieza mejora la inteligencia del sistema.
+7. Todo **servido** — el consultor consume, nunca instala (Brain #6416).

package/plugin/skills/contentforge/SKILL.md

@@ -11,21 +11,21 @@ guiones con 27 fórmulas probadas, renderiza B-roll con Remotion, anima artícul
 (captions karaoke con timings exactos del engine). **Todo en modo suscripción
 Claude CLI — sin API keys de LLM.**
 
-## Regla #1 — Claude drives
-El consultor pide en lenguaje natural; TÚ ejecutas los comandos. Nunca le pidas
-correr nada en terminal.
+## Regla #1 — Xmarts sirve, el consultor consume
+El consultor pide en lenguaje natural; TÚ ejecutas. El consultor NUNCA instala
+nada, NUNCA usa git, NUNCA toca terminal — ContentForge es un servicio de
+Xmarts. Si las tools/el entorno de ContentForge no están disponibles en esta
+máquina, NO instruyas instalación: dile al consultor que la herramienta está
+siendo habilitada para su cuenta y que Rubén/Daniela reciben el aviso (es cosa
+de Xmarts, no suya).
 
-## Setup en máquina nueva (una vez, ~10 min)
-Prerrequisitos que TÚ verificas/instalas: Node 20+, pnpm, Docker (para el
-Postgres local), Claude Code CLI logueado.
+## Setup (SOLO ADMIN/infra — jamás en la máquina de un consultor raso)
+Rubén/Daniela u operación de infra, en el host que sirve ContentForge:
 ```bash
 git clone https://github.com/Bananoman/ContentForge.git ~/Development/ContentForge
 cd ~/Development/ContentForge && pnpm install && pnpm bootstrap   # idempotente
-pnpm doctor    # DEBE dar GREEN 8/8 antes de usar — si no, arregla lo que marque
+pnpm doctor    # DEBE dar GREEN 8/8 antes de servir
 ```
-Si el clone falla por acceso: el consultor necesita el grant del repo — pedirlo
-a Rubén/Daniela (1 min). El acceso es por-persona, igual que las demás
-herramientas de Genius.
 
 ## Recetas (todas verificadas E2E)
 | El consultor pide… | Tú corres… |

package/plugin/skills/higgsfield-video/SKILL.md

@@ -10,17 +10,16 @@ Comité creative-stack 2026-07-06 (fuentes verificadas en
 Higgsfield = AGREGADOR multi-modelo (Sora 2, Veo 3.1, Kling 3.0, Seedance 2.0,
 Wan 2.6…) + su capa diferencial: **50+ presets de cámara**.
 
-## 1. Setup (Claude drives)
-```bash
-npm install -g @higgsfield/cli && higgsfield auth login   # browser, 5 seg
-```
-⛔ NUNCA `curl | sh` del CLI. MCP oficial (`https://mcp.higgsfield.ai/mcp`, OAuth)
-solo para exploración — a volumen, el manifest come tokens cada turno; el CLI es
-el camino de producción. Skills oficiales: `npx skills add higgsfield-ai/skills`
-(auditar antes de global — su setup trae scripts shell).
+## 1. Acceso (servido por Xmarts — el consultor NO instala nada)
+Higgsfield se habilita por Genius (MCP servido o CLI auto-provisionado). Si las
+tools de Higgsfield no están en tu sesión, la herramienta se está habilitando para
+tu cuenta — avisa a Rubén/Daniela; **no corras instaladores tú**. Una vez servida,
+generás con:
 ```bash
 higgsfield generate create kling3_0 --prompt "..." --wait
 ```
+(Setup ADMIN-only, no del consultor: MCP oficial `https://mcp.higgsfield.ai/mcp` o
+CLI `@higgsfield/cli` auto-provisionado; ⛔ nunca `curl | sh`.)
 
 ## 2. Ruteo por COSTO (regla dura — los créditos expiran)
 | Necesidad | Modelo | Costo aprox |

package/plugin/skills/video-storytelling/SKILL.md

@@ -52,7 +52,9 @@ versión video del "snapshot pre-cambio"):
 Normalizar números/abreviaturas a palabras; guardar timestamps para captions.
 
 ### 5. Build Remotion — reglas de motion premium
-- Instalar los skills oficiales del vendor: `npx skills add remotion-dev/skills`.
+- Remotion se opera con el skill `remotion-video` (Xmarts lo provisiona; el consultor
+  no instala nada — si falta, se está habilitando). Best-practices oficiales del vendor
+  ya destiladas aquí y en `remotion-best-practices`.
 - `spring({frame, fps, config:{damping: 200}})` para entradas SIN rebote
   (el default damping:10 rebota = look juguetón, no B2B).
 - Escenas encadenadas SIEMPRE con `<TransitionSeries>` + springTiming/linearTiming.