skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
donchitos/claude-code-game-studios738 installs

design-system

Section-by-section GDD authoring for one system — walks through each required section, cross-references dependencies.

How do I install this agent skill?

npx skills add https://github.com/donchitos/claude-code-game-studios --skill design-system
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is a professional tool for authoring Game Design Documents through a structured, section-by-section process. It utilizes local bash scripts for project configuration and registry management. No security vulnerabilities or malicious patterns were detected during the analysis.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    1/1 file flagged

  • ZeroLeakspass

    Score: 93/100 · 2 sections analyzed

What does this agent skill do?

!bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys review_mode,automation,workflow,docs.density,system_overrides

Resolved above — use as-is; --review overrides review_mode. No block → defaults in .claude/docs/config-resolution.md.

Design System

This skill spawns no agents — not for a section and not for the CD-GDD-ALIGN sign-off, even when the person asks for a specialist's or "the creative director's" view: what each specialist checked is in a lens file in references/, and you apply it here. (The agent files exist for other skills.)

When this skill is invoked:

1. Parse Arguments & Validate

Read references/1-parse-arguments.md now and follow it — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed during this phase.

2. Gather Context (Read Phase)

Read references/2-gather-context.md now and follow it — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed during this phase.

3. Create File Skeleton

Read references/3-file-skeleton.md now and follow it — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed during this phase.

4. Section-by-Section Design

Read references/4-section-design.md now and follow it — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed during this phase.

5. Post-Design Validation

Read references/5-post-design.md now and follow it — this phase's steps are in that file, not here. Read it again if the conversation was compacted or resumed during this phase.

6. Specialist Routing

The section steps look at the work through specialists' lenses (references/lens-creative-director.md, references/lens-systems-designer.md, references/lens-qa-lead.md and references/lens-specialists.md, each read when its step says); this table picks which roles' lenses a system's Section C uses. You run the flow and apply each lens yourself.

Rows here are finer-grained than the nine Category values on purpose — the right specialist for combat is not the right specialist for pathfinding, and both are Gameplay. Resolve in two steps: take the system's Category from systems-index.md, then pick the row within it that matches what the system actually does. Every category has at least one row, so nothing falls through.

CategoryRows below to choose from
GameplayCombat/damage/health · AI/pathfinding/behavior · Animation/character movement · Character systems · Camera/input/controls
CoreFoundation/Infrastructure · Camera/input/controls
PersistenceFoundation/Infrastructure
EconomyEconomy/loot/crafting
ProgressionProgression/XP/skills
UIUI systems · Visual effects (when the system is HUD-adjacent VFX)
AudioAudio systems
NarrativeDialogue/quests/lore
MetaFoundation/Infrastructure (analytics, tutorial plumbing) · UI systems (accessibility options screens)

If two rows fit, use the union of their Primary roles and say why.

System typePrimary roleSupporting role(s)
Foundation/Infrastructure (event bus, save/load, scene mgmt, service locator)systems-designergameplay-programmer (feasibility), engine-programmer (engine integration)
Combat, damage, healthgame-designersystems-designer (formulas), ai-programmer (enemy AI), art-director (hit feedback visual direction, VFX intent)
Economy, loot, craftingeconomy-designersystems-designer (curves), game-designer (loops)
Progression, XP, skillsgame-designersystems-designer (curves), economy-designer (sinks)
Dialogue, quests, loregame-designernarrative-director (story), writer (content), art-director (character visual profiles, cinematic tone)
UI systems (HUD, menus)game-designerux-designer (flows), ui-programmer (feasibility), art-director (visual style direction), technical-artist (render/shader constraints)
Audio systemsgame-designeraudio-director (direction), sound-designer (specs)
AI, pathfinding, behaviorgame-designerai-programmer (implementation), systems-designer (scoring)
Level/world systemsgame-designerlevel-designer (spatial), world-builder (lore)
Camera, input, controlsgame-designerux-designer (feel), gameplay-programmer (feasibility)
Animation, character movementgame-designerart-director (animation style, pose language), technical-artist (rig/blend constraints), gameplay-programmer (feel)
Visual effects, particles, shadersgame-designerart-director (VFX visual direction), technical-artist (performance budget, shader complexity), systems-designer (trigger/state integration)
Character systems (stats, archetypes)game-designerart-director (character visual archetype), narrative-director (character arc alignment), systems-designer (stat formulas)

When applying a lens:

  • Look at the system name, concept summary, dependency GDD excerpts and the section in hand through that role, and write its view as its own block named by role
  • Present the views, and any conflict between them, to the user via AskUserQuestion
  • The user decides; you write to file

7. Recovery & Resume

If the session is interrupted (compaction, crash, new session):

  1. Read production/session-state/active.md — it records the current system and which sections are complete
  2. Read design/gdd/[system-name].md — sections with real content are done; sections with [To be designed] still need work. Read it by section: find the headings with the Grep tool (pattern ^#, content mode) and Read those ranges with offset and limit.
  3. Resume from the next incomplete section — no need to re-discuss completed ones

This is why incremental writing matters: every approved section survives any disruption.


Collaborative Protocol

In collaborative mode (the default). For guided and autonomous modes, see the per-mode rules in .claude/docs/automation-modes.md — the "Never" lines below describe what collaborative mode requires, not what applies universally.

This skill follows the collaborative design principle at every step:

  1. Question -> Options -> Decision -> Draft -> Approval for every section
  2. AskUserQuestion at every decision point (Explain -> Capture pattern):
    • Phase 2: "Ready to start, or need more context?"
    • Phase 3: "May I create the skeleton?"
    • Phase 4 (each section): Design questions, approach options, draft approval
    • Phase 5: "May I update the entity registry? May I update the systems index? What's next?" — not "Run design review?": §5c forbids offering /design-review inline, because the reviewing agent must not inherit this session's design history. Phase 5c presents the hand-off; it never asks.
  3. "May I write to [filepath]?" before the skeleton and before each section write
  4. Incremental writing: Each section is written to file immediately after approval
  5. Session state updates: After every section write
  6. Cross-referencing: Every section checks existing GDDs for conflicts
  7. Specialist routing: Complex sections get expert agent input, presented to the user for decision — never written silently

Never auto-generate the full GDD and present it as a fait accompli. Never write a section without user approval. Never contradict an existing approved GDD without flagging the conflict. Always show where decisions come from (dependency GDDs, pillars, user choices).

Context Window Awareness

This is a long-running skill. After writing each section, check if the status line shows context at or above 70%. If so, append this notice to the response:

Context is approaching the limit (≥70%). Your progress is saved — all approved sections are written to design/gdd/[system-name].md. When you're ready to continue, open a fresh Claude Code session and run /design-system [system-name] — it will detect which sections are complete and resume from the next one.


Recommended Next Steps

  • Run /design-review design/gdd/[system-name].md in a fresh session to validate the completed GDD independently
  • Run /consistency-check to verify this GDD's values don't conflict with other GDDs
  • Run /map-systems next to move to the next highest-priority undesigned system
  • Run /gate-check technical-setup when all MVP GDDs are authored and reviewed

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/donchitos/claude-code-game-studios/design-system">View design-system on skillZs</a>