One-click install
npx skills add https://github.com/imclab/xrA1-swarm --skill map-systems-imclab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: map-systems
Source: https://github.com/imclab/xrA1-swarm/tree/main/.claude/skills/map-systems
Command: npx skills add https://github.com/imclab/xrA1-swarm --skill map-systems-imclab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams decompose a game concept into a complete, prioritized set of gameplay and supporting systems so you can stop guessing what to build next.

Core Features & Use Cases

  • Systems decomposition: Extracts explicit systems from the GDD and infers implicit “hidden” systems (e.g., inventory implies UI, serialization, persistence) to avoid missing critical building blocks.
  • Dependency mapping: Builds a dependency graph, layers systems by build order, and highlights circular dependencies and bottlenecks to reduce rework.
  • Priority and design-order planning: Assigns systems into MVP/alpha/vertical-slice/full tiers, then derives the correct GDD authoring sequence and writes/updates the systems index with explicit user approvals.

Quick Start

Run /map-systems to read your game concept and interactively produce an approved systems index at design/gdd/systems-index.md.

Frequently Asked Questions about map-systems

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

FAQPage Schema
How do I decompose a game concept into an actionable systems plan?

Systems decomposition extracts explicit systems from your game concept and infers implicit ones like UI or persistence to produce an actionable systems plan. This avoids missing critical building blocks during project planning.

What is dependency mapping in game design documentation?

Dependency mapping in game design documentation builds a dependency graph to layer systems by build order and highlights circular dependencies. This reduces rework by visualizing bottlenecks before GDD authoring.

How do I prioritize gameplay systems for MVP and vertical slice development?

Prioritize gameplay systems by assigning them into MVP, alpha, vertical-slice, and full tiers based on dependency order. This derives the correct GDD authoring sequence and establishes a structured build plan.

Can I generate a systems index from an existing game concept document?

You can generate a systems index by reading design/gdd/game-concept.md and optional design docs. The process interactively determines dependencies and writes systems-index.md only after explicit user approval.

What are the limitations of automated systems decomposition for game design?

Automated systems decomposition requires reading a valid game-concept.md file and operates interactively, meaning it pauses for explicit user approval before writing. It infers hidden systems but cannot bypass circular dependency bottlenecks automatically.

When do I need to map circular dependencies in a game systems plan?

You need to map circular dependencies when evolving a game project to prevent structural bottlenecks. Mapping highlights these loops during systems decomposition, allowing you to resolve rework issues before GDD authoring.