One-click install
npx skills add https://github.com/MichaelSolati/mkai --skill quick-design-michaelsolati
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quick-design
Source: https://github.com/MichaelSolati/mkai/tree/main/profiles/game-dev/skills/quick-design
Command: npx skills add https://github.com/MichaelSolati/mkai --skill quick-design-michaelsolati

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating full game design documents (GDDs) for small changes like balance tweaks or minor mechanic adjustments adds unnecessary overhead and slows down iteration for game development teams. This Skill eliminates that friction by providing a lightweight, structured path for small, low-risk changes that don't warrant a full GDD.

Core Features & Use Cases

  • Change Classification: Automatically categorizes small changes as Tuning, Tweak, Addition, or New Small System to apply the correct spec template.
  • Context-Aware Drafting: Scans existing GDDs and prior quick specs to avoid contradictions and ensure alignment with established game systems.
  • Structured Spec Output: Generates ready-to-use quick design specs with clear rules, tuning knobs, and acceptance criteria tailored to the change type.
  • Use Case: A game dev needs to increase a character's jump height by 1 unit. This Skill creates a structured tuning spec in minutes, aligned with the existing movement system GDD, instead of requiring a full design document.

Quick Start

Use the quick-design skill to create a design spec for a small parry window addition to the existing block mechanic.

Frequently Asked Questions about quick-design

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

FAQPage Schema
How do I create a game design spec for small balance tweaks without writing a full GDD?

To create a game design spec for small balance tweaks without a full GDD, use a lightweight quick spec that automatically classifies changes as Tuning, Tweak, Addition, or New Small System and generates structured rules with acceptance criteria.

What is a quick design spec used for in game development?

A quick design spec in game development is used to document low-risk changes like minor mechanic adjustments or small system additions under one week of implementation, eliminating the overhead of authoring full game design documents for fast iterations.

Can I generate design specs that align with my existing game design documents?

Yes, you can generate design specs that align with existing game design documents by scanning prior GDDs and quick specs to avoid contradictions, ensuring new tuning knobs and mechanic tweaks match established game systems.

How do I document a new micro-feature for a game mechanic?

To document a new micro-feature for a game mechanic, apply a structured quick spec template tailored for small system additions that includes clear rules, tuning knobs, and acceptance criteria aligned with the existing game system.

When should I use a quick spec instead of a full game design document?

You should use a quick spec instead of a full game design document when implementing standalone micro-features, balance tuning, or minor mechanic tweaks that take under one week and do not warrant full design overhead.