team-narrative

Donchitos/Claude-Code-Game-Studios · updated Apr 16, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/Donchitos/Claude-Code-Game-Studios --skill team-narrative
0 commentsdiscussion
summary

### Team Narrative

  • description: "Orchestrate the narrative team: coordinates narrative-director, writer, world-builder, and level-designer to create cohesive story content, world lore, and narrative-driven level design.
  • argument-hint: "[narrative content description]"
  • allowed-tools: Read, Glob, Grep, Write, Edit, Task, AskUserQuestion, TodoWrite
skill.md
name
team-narrative
description
"Orchestrate the narrative team: coordinates narrative-director, writer, world-builder, and level-designer to create cohesive story content, world lore, and narrative-driven level design."
argument-hint
"[narrative content description]"
user-invocable
true
allowed-tools
Read, Glob, Grep, Write, Edit, Task, AskUserQuestion, TodoWrite

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.

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

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 — i18n validation, string key compliance, translation headroom

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.
how to use team-narrative

How to use team-narrative on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your development machine
  • Node.js version 16.0+ with npm package manager (verify with node --version)
  • Active project directory or workspace where you want to add team-narrative
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/Donchitos/Claude-Code-Game-Studios --skill team-narrative

The skills CLI fetches team-narrative from GitHub repository Donchitos/Claude-Code-Game-Studios and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/team-narrative

Reload or restart Cursor to activate team-narrative. Access the skill through slash commands (e.g., /team-narrative) or your agent's skill management interface.

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

Improve work quality by 30-40% with less effort

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client with skill support
  • Clear understanding of task or problem to solve
  • Willingness to iterate and refine outputs

Time Estimate

15-45 minutes depending on use case complexity

Installation Steps

  1. 1.Install skill using provided installation command
  2. 2.Test with simple use case relevant to your work
  3. 3.Evaluate output quality and relevance
  4. 4.Iterate on prompts to improve results
  5. 5.Integrate into regular workflow if valuable

Common Pitfalls

  • Expecting perfect results without iteration
  • Not providing enough context in prompts
  • Using skill for tasks outside its intended scope
  • Accepting outputs without review and validation

Best Practices

✓ Do

  • +Start with clear, specific prompts
  • +Provide relevant context and constraints
  • +Review and refine all outputs before using
  • +Iterate to improve output quality
  • +Document successful prompt patterns

✗ Don't

  • Don't use without understanding skill limitations
  • Don't skip validation of outputs
  • Don't share sensitive information in prompts
  • Don't expect skill to replace human judgment

💡 Pro Tips

  • Be specific about desired format and style
  • Ask for multiple options to choose from
  • Request explanations to understand reasoning
  • Combine AI efficiency with human expertise

When to Use This

✓ Use When

Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.

✗ Avoid When

Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.

Learning Path

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.754 reviews
  • Chaitanya Patil· Dec 20, 2024

    Keeps context tight: team-narrative is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Neel Sanchez· Dec 20, 2024

    team-narrative is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • Dev Mensah· Dec 12, 2024

    Useful defaults in team-narrative — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Neel Li· Dec 4, 2024

    Solid pick for teams standardizing on skills: team-narrative is focused, and the summary matches what you get after install.

  • Hana Choi· Nov 23, 2024

    I recommend team-narrative for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Piyush G· Nov 11, 2024

    Registry listing for team-narrative matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Naina Okafor· Nov 11, 2024

    team-narrative reduced setup friction for our internal harness; good balance of opinion and flexibility.

  • Soo Desai· Nov 3, 2024

    team-narrative fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • Diya Chawla· Nov 3, 2024

    team-narrative has been reliable in day-to-day use. Documentation quality is above average for community skills.

  • Hana Park· Oct 22, 2024

    We added team-narrative from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

showing 1-10 of 54

1 / 6