umbral-agent-stack

curate recent items from authority sources into a ranked editorial shortlist before any derivative content is drafted. use when chatgpt needs to fetch or review the latest accessible items from gartner, mckinsey, every, and ruben substack; normalize them into a shared schema; score alignment against david's narrative, proposal, and audience; present a shortlist for human selection; and only then hand off to derivative-content workflows. also use when planning manual or semi-automated source monitoring with research, n8n, linkedin-content, or linkedin-david if those skills are installed. do not use this skill to promise scraping behind logins or paywalls, or automatic publishing without real tooling and permissions.

Guardrail conductual cross-repo que previene exposición de tokens, secrets y API keys en outputs de agentes. Usar antes de commitear, publicar retros, escribir mailbox, pegar salida de az/gh/kubectl/curl, o generar cualquier output visible. Motivada por incidente AF-1k.16i1c (gate-token leak).

Process Granola meeting notes or transcripts into Notion raw intake, review them through the V1 `session_capitalizable` layer, extract action items, and create proactive follow-ups. Use when "subir transcripcion", "procesar granola", "reunion terminada", "compromisos reunion", or "propuesta de seguimiento".

PIT — Product Innovation Tournament: parser NL + alias /torneo_producto que convierte un pedido de David en pit_spec.yaml validado, confirma con gate literal "ok, arranca" y orquesta N lanes efímeras que compiten con prototipos + KPI (PROTOTYPE_URL + KPI_PACK + fulfillment). Incluye el modo PIT-DEV (spec v3): torneos de producto técnico usable con jueces ejecutores, security-egress y trazabilidad. NO es el torneo de código D3 (PR_URL) — ese es multi-agent-tournament-orchestrator.

Configurar sesiones, agentes y workspace en el Gateway OpenClaw dentro del Umbral Agent Stack. Incluye arquitectura Gateway, Pi integration, agents.list, bindings, Agent Loop, System Prompt, Context, Agent Workspace, OAuth, Presence, multi-agent routing y referencias oficiales. Use when "openclaw config", "agents.list", "workspace", "sessions", "bootstrap", "AGENTS.md SOUL.md", "auth-profiles", "context window", "compaction", "bindings".

curar redaccion, narrativa, lenguaje y voz de David en piezas editoriales de Umbral; revisar candidatos de Rick/OpenClaw cuando el copy sea correcto pero no suene a David; producir variantes controladas, detectar terminos no naturales como escalacion, y proponer ajustes de prompts/configuracion sin publicar ni tocar gates.

Estrategia de contenido para LinkedIn de David Moreira: algoritmo 2025, formatos de alto engagement, hooks de apertura, checklist pre-publicacion y anti-patrones. Especializado en sector BIM/AEC para consultores independientes. Use when "publicar en linkedin", "post linkedin", "contenido linkedin", "newsletter linkedin", "carrusel linkedin", "hook linkedin", "algoritmo linkedin".

Asistente de contenido LinkedIn de David Moreira. Genera posts, hooks y estrategia de contenido alineados con el algoritmo 2025 y el perfil BIM/AEC/IA de David. Formatos probados, templates listos, anti-patterns identificados. Use when "publicar linkedin", "post linkedin", "contenido semana", "redactar linkedin", "escribir post", "estrategia linkedin", "hook linkedin", "contenido bim linkedin".

Thin OpenClaw-native wrapper for Mega 1 tournaments: pre-flight, N parallel lanes via sessions_spawn, PR collection, winner rubric, merge + metrics. Runs only from agent main in standalone session (G-D1b). NOT the ideational tournament.run skill — see docs/79-tournament-protocol-openclaw-native.md.

GitHub CLI workflow for OpenClaw-native tournament lane agents only. Use when you are a tournament participant (subagent lane): create branch tournament/<id>/lane-<specialty>, commit explicit files, push, open PR with mandatory title prefix, verify PR, announce PR_URL to parent. Do NOT use for daily rick/ branches (github-ops) or ideational tournaments (skill tournament). Prefer umbral_tournament_* plugin tools when available; raw gh is fallback only.

OpenClaw plugin bridge for tournament lane GitHub tools (Worker tournament_lane.*). Use only inside tournament lanes; pair with skill tournament-github-cli. Not enabled until D3.6 Phase 3 deploy.

Operate Git and GitHub from the VPS: branches, commits, pushes, and pull requests. Use when "create branch", "commit and push", "open PR", "github preflight", "orchestrate tournament branches", "check git status", "push to GitHub", "branch cleanup", "torneo real", "torneo de implementación", "competir implementaciones en ramas", "benchmark de código real", "poner a competir soluciones", "torneo sobre este cambio". NOT for OpenClaw-native tournament lanes (tournament/*/lane-*) — use skill tournament-github-cli and plugin umbral-tournament-github instead.

Proponer y listar eventos de Google Calendar de forma segura para Rick (policy propose+confirm).

Gestionar Gmail de Rick con ADR-16: crear borradores y listar borradores de forma segura, sin envío directo.

Operar OpenClaw y el stack real en la VPS de Umbral. Úsala cuando la tarea toque gateway, openclaw.json, modelos, nodos, runtime, VPS, VM, health checks, deploys, fallbacks, runbooks, o cuando Claude necesite sacar el máximo provecho a OpenClaw sin inventar arquitectura.

Operar OpenClaw runtime desde la VPS de forma segura, trazable y reversible. Usar cuando la tarea toque ~/.openclaw/openclaw.json, openclaw-gateway.service, aliases, modelos, smoke gateway, journalctl --user, backup, patch, restart, rollback, o cualquier acción runtime sobre OpenClaw en la VPS de Umbral. NO usar para Azure, Foundry, Notion, n8n, RRSS, O16.2, ni desde Windows local.

Activar un deployment de Azure AI Foundry / Azure OpenAI como alias disponible en OpenClaw sin cambiar el default global. Coordina audit y configuración Foundry desde Copilot Windows con audit y patch del gateway desde Copilot-VPS, exigiendo autorización explícita de David para cualquier write.

Evitar que Copilot confunda la workstation Windows con la VPS al ejecutar tareas que tocan Azure AI Foundry, Azure OpenAI, OpenClaw, deployments o `openclaw-gateway.service`. Define qué superficie ejecuta cada acción, qué requiere autorización explícita de David, y cómo se hace el handoff Windows → VPS.

Aplicar en la VPS de Umbral los cambios committeados en umbral-agent-stack y verificar health antes de cerrar la tarea. Úsala siempre tras editar archivos en worker/, dispatcher/, openclaw/, identity/, config/, o tras cambiar pyproject.toml. Cubre git pull, dependency install, service restart, y health check por servicio.

Auditar, disenar, crear y corregir agentes Rick/OpenClaw, skills, ROLE.md, handoffs, permisos, tools, QA y prompts de implementacion para Codex, Copilot o VPS sin operar produccion.

Alinear cualquier trabajo sobre Notion, Granola, smart replies, task pages, comentarios, surfaces canónicas y Control Room con la gobernanza V2 y la utilidad real para David. Úsala cuando la tarea toque experiencia de David en Notion o posibles conflictos V1/V2.

Tournament multi-agent pattern: exploración divergente con desarrollo completo + debate informado + consolidación por juez. Rick recibe un desafío, identifica 2-5 enfoques distintos, los desarrolla completamente en paralelo, ejecuta un debate donde cada enfoque argumenta contra los rivales, y consolida con tabla comparativa + recomendación. Usa cuando "comparar enfoques", "explorar opciones", "analizar alternativas", "torneo de ideas", "qué camino tomar", "pros y contras de N opciones", "debate entre opciones". NO usar para torneo real, torneo de implementación, competir implementaciones en ramas o benchmark de código real — eso va por github-ops.

RAG (Retrieval-Augmented Generation) sobre base de conocimiento en Azure AI Search. Rick puede indexar documentos (Notion pages, archivos, web), buscar con búsqueda híbrida (keyword + vector), y responder preguntas con contexto recuperado. Usa cuando "buscar en la base de conocimiento", "qué sabemos de", "indexar documentos", "RAG", "buscar en nuestros docs", "base de conocimiento", "knowledge base", "pregunta sobre el proyecto".

Briefing matutino proactivo. Rick compila calendario, tareas pendientes y alertas del día para David. Se ejecuta automáticamente vía cron cada mañana. Usa cuando David diga "briefing del día", "qué tengo hoy", "resumen de la mañana".

Preparación proactiva antes de reuniones. Rick revisa el calendario, busca contexto relevante en Notion y entrega un brief de preparación. Se ejecuta cada 30 minutos para detectar reuniones próximas. Usa cuando David diga "prepárame para la reunión", "contexto de la próxima reunión".

Vigilancia de tareas estancadas. Rick revisa tareas en Notion y Linear que llevan más de N días sin actualización y alerta proactivamente. Se ejecuta una vez al día. Usa cuando David diga "tareas estancadas", "qué quedó pendiente", "revisar atrasos".

Skill legacy reconciliada para solicitudes docentes del Master AEC 4.0. Sirve para preparar clases, ejercicios y guias tecnicas sin tratar esta skill como fuente canonica de conocimiento; el contenido reusable debe venir de las bases canonicas vigentes.

Operar navegador y escritorio en la VM Windows del stack. Usar cuando el trabajo requiera `browser.*`, `gui.*` o `windows.open_url`, por ejemplo para abrir una URL en la sesion interactiva, navegar con Playwright, leer DOM, hacer clics, tomar capturas o automatizar ventanas y dialogs nativos.

Ejecutar tareas compuestas de investigación y generación de reportes. Orquesta múltiples búsquedas web (research.web) + generación LLM (llm.generate) para producir un reporte de investigación completo en Notion. Usa cuando el usuario pida "investigar y reportar", "research report", "reporte de investigación", "buscar y resumir", "análisis de mercado", "estudio de tema".

Search the web and generate research reports using Tavily/Google CSE and LLM synthesis. Use when "search the web", "research topic", "find information", "market research", "generate report", "investigate", "web search".

Generar audio con la task `google.audio.generate` usando Gemini TTS preview. Usar cuando David pida "texto a voz con Google", "audio Gemini", "crear wav", "locucion" o cuando un agente necesite documentar honestamente la ruta TTS de Google sin inventar soporte.

Use Google Cloud Vertex AI and the Gemini API for text generation, embeddings, multimodal inputs, model tuning, and deployment via Python SDK. Use when "vertex ai", "gemini api", "google cloud ai", "embeddings vertex", "imagen", "gemini model", "google ai studio", "vertex deploy".

Manage Linear issues with automatic team routing, labels, and status updates. Use when "create issue", "create ticket", "Linear task", "update issue status", "list teams", "track task in Linear", "project management", "attach to project", or "create Linear project".

Design and debug n8n workflows using nodes, expressions, credentials, and the Code node (JavaScript/Python) for self-hosted or cloud automation pipelines. Use when "create n8n workflow", "n8n webhook", "n8n expression", "n8n node", "automate with n8n", "n8n http request", "n8n schedule", "n8n code node", "n8n credential", "n8n self-hosted", "trigger n8n flow", "n8n error handling".

Operar el registro canonico de proyectos en Notion de forma registry-first. Usar cuando haya que crear, auditar, actualizar o regularizar proyectos, entregables, tareas o paginas sueltas para que el estado quede coherente entre Notion, Linear, Drive y el trabajo real del stack.

Interact with Notion via Umbral Worker tasks for transcripts, comments, Control Room polling, Kanban task updates, dashboard updates, and report pages. Use when "write to notion", "notion comment", "poll notion comments", "update dashboard", "create report page", "sync task status to notion".

Diagnosticar la interconectividad real del stack Umbral sin confundir conectividad base con sanidad operativa. Usar cuando David pida "diagnostico completo", "verifica el sistema", "revisa conexiones entre apps", "que esta roto", "que esta sano", "smoke post deploy" o "barrido cross-system".

Query LLM provider status, quota usage, and model routing configuration from the Worker API. Use when "check providers", "quota status", "which models", "provider health", "LLM status", "routing config", "API usage".

Crear borradores de email en Gmail. Usa cuando el usuario diga "redactar email", "guardar borrador", "email borrador", "Gmail draft".

Crear y listar eventos en Google Calendar. Usa cuando el usuario diga "agendar reunion", "crear evento", "recordatorio en calendario", "ver mis eventos", "Google Calendar".