concept-intake

Converts raw game concept notes into structured design documentation through batched clarifying questions.

Updated Apr 27, 2024
One-click install
npx skills add https://github.com/IgorGribowsky/rts-sandbox --skill concept-intake-igorgribowsky
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: concept-intake
Source: https://github.com/IgorGribowsky/rts-sandbox/tree/main/rts-sandbox-src/.claude/skills/concept-intake
Command: npx skills add https://github.com/IgorGribowsky/rts-sandbox --skill concept-intake-igorgribowsky

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning free-form game ideas into actionable documentation is hard: raw concept notes are ambiguous, and filling gaps with assumptions leads to building the wrong game. This Skill structures the intake process so every design decision comes from the user, not from the AI's guesses. ## Core Features & Use Cases - Batched Questioning: Reads all unprocessed files in concept/ first, then asks one numbered batch of questions, each with 2-3 concrete options and a recommendation. - Adaptive Documentation Set: Creates only the docs the project needs — vision and scope boundaries are mandatory, mechanics docs are created per independent system with statuses (accepted/proposed). - Delta Handling: When the user changes their mind mid-project, it reports what breaks (docs, code systems, tasks) before rewriting anything, and logs changes in docs/CHANGELOG.md. - Use Case: A solo game developer dumps scattered notes into concept/ and runs /intake; the Skill produces a vision doc, scope boundaries, per-mechanic docs with concrete numbers, and a deferred-questions list — ready to derive tasks from. ## Quick Start Ask the AI to run the intake process on the files in the concept folder and turn them into project documentation.

Frequently Asked Questions about concept-intake

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

FAQPage Schema
How do I turn raw game ideas into design documentation?

Place your free-form notes in the concept folder and trigger the intake process. The Skill reads all unprocessed files first, asks one batch of numbered clarifying questions with concrete options, then writes vision, scope, and mechanics docs from your answers.

What documents does a game concept intake process create?

Only two documents are mandatory: a vision doc (genre, feel, reference) and scope boundaries (what is in and out of MVP). Everything else — core loop, mechanics, narrative docs — is created only if the project has substance for it.

How do I handle design changes mid-project without breaking existing docs?

The Skill produces a delta report first: which docs change, which code systems are affected, and which tasks need rework. Closed tasks are never reopened; a new task is proposed instead, and changes are logged in docs/CHANGELOG.md.

When should a game mechanic get its own design document?

A mechanic gets its own file when it is an independent system with its own inputs, behavior, and boundaries that can be implemented and tested separately. Details inside a system, like recoil within shooting, stay as edits to that system's doc.

What happens to unanswered or deferred design questions?

Deferred questions go into docs/06-open-questions.md with status deferred and a 'for' field naming the future task that needs them. They are never silently dropped or filled in with invented answers.