Skills Agentes

Team Narrative

Orquesta al equipo narrativo: coordina a narrative-director, writer, world-builder y level-designer para crear historia, lore de mundo y diseño de nivel guiado por la narrativa.

Solicitareadglobgrepwriteedittaskaskuserquestiontodowrite
Estrellas
24.4k

en todo el repo

Actividad
43

0–100, la ruta de este skill

Actualizado
hace 3 meses

último commit aquí

Commits
0

últimos 90 días

Contexto
1.9k tok

47 tok en reposo

Paquete
1 archivo

8 KB

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add Donchitos/Claude-Code-Game-Studios --skill team-narrative --agent claude-code

Se instala solo en este repositorio.

Este skill writes to your files.

Qué hace

  • Orquesta a narrative-director, writer, world-builder, art-director, level-designer y localization-lead en un pipeline de 5 fases
  • Usa AskUserQuestion en cada transición de fase para que el usuario apruebe las propuestas antes de avanzar
  • Resuelve un modo de revisión (full/lean/solo) que determina qué gates de director se ejecutan
  • Genera un reporte final con estado del brief narrativo, lore, diálogos y puntos de integración de nivel
  • Aplica un protocolo de recuperación de errores si algún subagente queda BLOCKED

Úsalo cuando

  • Necesitas crear contenido de historia, lore de mundo o diseño de nivel narrativo
  • Quieres coordinar diálogos, facciones y ambientación de forma coherente entre varios agentes
  • Vas a integrar narrativa con el diseño de niveles y validar consistencia de canon

No lo uses cuando

    Qué lo activa

    Di cualquiera de estas frases y el agente debería cargar este skill.

    • /team-narrative boss encounter cutscene
    • /team-narrative faction intro dialogue --review full
    • /team-narrative tutorial narrative --review solo

    SKILL.md

    En inglés

    If no argument is provided, output usage guidance and exit without spawning any agents:

    Usage: /team-narrative [narrative content description] — describe the story content, scene, or narrative area to work on (e.g., boss encounter cutscene, faction intro dialogue, tutorial narrative). Do not use AskUserQuestion here; output the guidance directly.

    When this skill is invoked with an argument, orchestrate the narrative team through a structured pipeline.

    Decision Points: At each phase transition, use AskUserQuestion to present the user with the subagent's proposals as selectable options. Write the agent's full analysis in conversation, then capture the decision with concise labels. The user must approve before moving to the next phase.

    Phase 0: Resolve Review Mode

    1. If --review [mode] was passed as an argument, use that mode.
    2. Else read production/review-mode.txt — use whatever is written there.
    3. Else default to lean.

    Modes:

    • full — spawn all director and lead gates as described
    • lean — skip director gates unless they are PHASE-GATE type (CD-PHASE-GATE, TD-PHASE-GATE, PR-PHASE-GATE, AD-PHASE-GATE)
    • solo — skip all director gate spawning entirely; run the skill without any agent gates

    Store the resolved mode for use in all subsequent phases.

    Team Composition

    • narrative-director — Story arcs, character design, dialogue strategy, narrative vision
    • writer — Dialogue writing, lore entries, item descriptions, in-game text
    • world-builder — World rules, faction design, history, geography, environmental storytelling
    • art-director — Character visual design, environmental visual storytelling, cutscene/cinematic tone
    • level-designer — Level layouts that serve the narrative, pacing, environmental storytelling beats
    • localization-lead — Localization readiness — flags non-localizable strings, cultural assumptions, and i18n gaps

    How to Delegate

    Use the Task tool to spawn each team member as a subagent:

    • subagent_type: narrative-director — Story arcs, character design, narrative vision
    • subagent_type: writer — Dialogue writing, lore entries, in-game text
    • subagent_type: world-builder — World rules, faction design, history, geography
    • subagent_type: art-director — Character visual profiles, environmental visual storytelling, cinematic tone
    • subagent_type: level-designer — Level layouts that serve the narrative, pacing
    • subagent_type: localization-lead — Localization readiness — flags non-localizable strings, cultural assumptions, and i18n gaps

    Always provide full context in each agent's prompt (narrative brief, lore dependencies, character profiles). Launch independent agents in parallel where the pipeline allows it (e.g., Phase 2 agents can run simultaneously).

    Pipeline

    Phase 1: Narrative Direction

    Delegate to narrative-director:

    • Define the narrative purpose of this content: what story beat does it serve?
    • Identify characters involved, their motivations, and how this fits the overall arc
    • Set the emotional tone and pacing targets
    • Specify any lore dependencies or new lore this introduces
    • Output: narrative brief with story requirements

    Phase 2: World Foundation (parallel)

    Delegate in parallel — issue all three Task calls simultaneously before waiting for any result:

    • world-builder: Create or update lore entries for factions, locations, and history relevant to this content. Cross-reference against existing lore for contradictions. Set canon level for new entries.
    • writer: Draft character dialogue using voice profiles. Ensure all lines are under 120 characters, use named placeholders for variables, and are localization-ready.
    • art-director: Define character visual design direction for key characters appearing in this content (silhouette, visual archetype, distinguishing features). Specify environmental visual storytelling elements for each key space (prop composition, lighting notes, spatial arrangement). Define tone palette and cinematic direction for any cutscenes or scripted sequences.

    Phase 3: Level Narrative Integration

    Delegate to level-designer:

    • Review the narrative brief and lore foundation
    • Design environmental storytelling elements in the level
    • Place narrative triggers, dialogue zones, and discovery points
    • Ensure pacing serves both gameplay and story

    Phase 4: Review and Consistency

    Delegate to narrative-director:

    • Review all dialogue against character voice profiles
    • Verify lore consistency across new and existing entries
    • Confirm narrative pacing aligns with level design
    • Check that all mysteries have documented "true answers"

    Phase 5: Polish (parallel)

    Delegate in parallel:

    • writer: Final self-review — verify no line exceeds dialogue box constraints, all text uses string keys (not raw strings), placeholder variable names are consistent
    • localization-lead: Validate i18n compliance — check string key naming conventions, flag any strings with hardcoded formatting that won't survive translation, verify character limit headroom for languages that expand (German/Finnish typically +30%), confirm no cultural assumptions in text that would need locale-specific variants
    • world-builder: Finalize canon levels for all new lore entries

    Error Recovery Protocol

    If any spawned agent (via Task) returns BLOCKED, errors, or cannot complete:

    1. Surface immediately: Report "[AgentName]: BLOCKED — [reason]" to the user before continuing to dependent phases
    2. Assess dependencies: Check whether the blocked agent's output is required by subsequent phases. If yes, do not proceed past that dependency point without user input.
    3. Offer options via AskUserQuestion with choices:
      • Skip this agent and note the gap in the final report
      • Retry with narrower scope
      • Stop here and resolve the blocker first
    4. Always produce a partial report — output whatever was completed. Never discard work because one agent blocked.

    Common blockers:

    • Input file missing (story not found, GDD absent) → redirect to the skill that creates it
    • ADR status is Proposed → do not implement; run /architecture-decision first
    • Scope too large → split into two stories via /create-stories
    • Conflicting instructions between ADR and story → surface the conflict, do not guess

    File Write Protocol

    All file writes (narrative docs, dialogue files, lore entries) are delegated to sub-agents spawned via Task. Each sub-agent enforces the "May I write to [path]?" protocol. This orchestrator does not write files directly.

    Output

    A summary report covering: narrative brief status, lore entries created/updated, dialogue lines written, level narrative integration points, consistency review results, and any unresolved contradictions.

    Verdict: COMPLETE — narrative content delivered.

    If the pipeline stops because a dependency is unresolved (e.g., lore contradiction or missing prerequisite not resolved by the user):

    Verdict: BLOCKED — [reason]

    Next Steps

    • Run /design-review on the narrative documents for consistency validation.
    • Run /localize extract to extract new strings for translation after dialogue is finalized.
    • Run /dev-story to implement dialogue triggers and narrative events in-engine.

    Reproducido de Donchitos/Claude-Code-Game-Studios bajo licencia MIT. Leer esta página en markdown.

    Archivos

    1 archivo en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

    Antes de instalar

    Puede requerir production/review-mode.txt para el modo de revisión por defecto y depende de sub-agentes narrative-director, writer, world-builder, art-director, level-designer y localization-lead.

    Detalles

    Creador
    Donchitos
    Licencia
    MIT
    Recursos incluidos
    Solo SKILL.md
    Código fuente
    Ver SKILL.md

    Etiquetas

    Más de Donchitos/Claude-Code-Game-Studios

    Este repo incluye 73 skills. Si instalas uno, normalmente ya tienes los demás.

    Adopt

    24.4k

    Onboarding brownfield: audita el cumplimiento de formato de los artefactos existentes, clasifica los vacíos por impacto y genera un plan de migración numerado.

    Costo de contexto al activarse
    4.5k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 3 meses
    herramientas desarrollo

    Crea un Registro de Decisión de Arquitectura (ADR) que documenta una decisión técnica importante, su contexto, alternativas consideradas y consecuencias.

    Costo de contexto al activarse
    4.8k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 3 meses
    documentos

    Valida que la arquitectura del proyecto cubra por completo los GDD: cruza requisitos con ADR, detecta conflictos entre decisiones y compatibilidad de motor, y da un veredicto PASS/CONCERNS/FAIL.

    Costo de contexto al activarse
    6.7k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 3 meses
    herramientas desarrollo

    Autoría guiada, sección por sección, del Art Bible. Crea la especificación de identidad visual que condiciona toda la producción de assets. Se ejecuta tras aprobar /brainstorm y antes de /map-systems o de redactar cualquier GDD.

    Costo de contexto al activarse
    3.7k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 3 meses
    documentos

    Audita los assets del juego según convenciones de nombres, presupuestos de tamaño, formatos estándar y requisitos de pipeline. Identifica assets huérfanos, referencias faltantes e infracciones de estándares.

    Costo de contexto al activarse
    697 tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 3 meses
    testing qa

    Genera especificaciones visuales por asset y prompts de generación IA a partir de GDDs, docs de nivel o perfiles de personaje. Produce archivos de spec y actualiza el manifiesto maestro.

    Costo de contexto al activarse
    4.1k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 3 meses
    documentos

    Skills relacionados

    Pipeline completo de localización: escanea strings hardcodeados, gestiona tablas de strings, valida traducciones, genera briefings, revisión cultural, VO, RTL, freeze y reporte de cobertura.

    Costo de contexto al activarse
    4.7k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 3 meses
    Permisos
    redaccion contenido

    Adopt

    24.4k

    Onboarding brownfield: audita el cumplimiento de formato de los artefactos existentes, clasifica los vacíos por impacto y genera un plan de migración numerado.

    Costo de contexto al activarse
    4.5k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 3 meses
    herramientas desarrollo

    Crea un Registro de Decisión de Arquitectura (ADR) que documenta una decisión técnica importante, su contexto, alternativas consideradas y consecuencias.

    Costo de contexto al activarse
    4.8k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 3 meses
    documentos