gds-create-game-brief

Create, update, or validate game briefs through conversational coaching and structured drafting.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/watchthelight/shatterfish --skill gds-create-game-brief-watchthelight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gds-create-game-brief
Source: https://github.com/watchthelight/shatterfish/tree/main/.claude/skills/gds-create-game-brief
Command: npx skills add https://github.com/watchthelight/shatterfish --skill gds-create-game-brief-watchthelight

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Turning a raw game idea into a clear, right-sized game brief is hard: assumptions go unexamined, scope balloons, and the resulting document fails as a foundation for the Game Design Document. This Skill coaches you through discovery, drafting, and validation so the brief captures the core vision honestly. ## Core Features & Use Cases - Three intent modes: Create a new brief from conversation, Update an existing brief against a change signal with a mandatory decision log, or Validate a brief against a quality bar (single-sentence core fantasy, 2-4 pillars, clear core loop, minimal MVP). - Guided discovery: Surfaces vision, target players, core loop, scope, references, and differentiation through coaching dialogue, with fast-path and coaching-path working modes. - Persistent workspace: Writes brief.md, addendum.md, and .decision-log.md to a run folder, supports resume across sessions, and runs polish passes and reviewer gates at finalize. - Use Case: You have a pitch for a roguelike deckbuilder due tomorrow. Invoke the skill, choose the fast path, answer one consolidated batch of questions, and receive a polished brief with [ASSUMPTION] tags to review. ## Quick Start Ask the assistant to help you create a game brief for your game idea using the gds-create-game-brief skill.

Frequently Asked Questions about gds-create-game-brief

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a game brief before writing a GDD?

Invoke the skill with your game idea and it will coach you through discovery covering vision, audience, core loop, scope, and differentiation. It then drafts a brief.md with YAML frontmatter in a persistent run folder, ready as input for a GDD workflow.

What makes a good game brief quality bar?

The skill validates that the core fantasy fits one sentence, pillars are 2-4 and specific, the core loop is clear, the audience is not "everyone", comparable titles are named with what is taken versus left, scope matches the team, and the MVP is truly minimal.

Can I update an existing game brief instead of starting over?

Yes. Update mode reads the existing brief, addendum, and decision log, reconciles the change signal against prior decisions, and records every change to .decision-log.md as a mandatory audit trail before applying edits.

Does the game brief skill work in headless or non-interactive mode?

Yes. In headless mode it completes the detected intent without prompting, infers missing information, and returns a JSON status block listing intent and artifact paths. If intent is ambiguous it halts with a blocked status and reason.

What files does the game brief workflow produce?

It produces brief.md with YAML frontmatter, an optional addendum.md for depth that belongs downstream, and a .decision-log.md audit trail, all inside a run folder under the configured briefs output path.