adopt

Audit game project artifacts for template format compliance and generate a prioritized remediation plan.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When joining an in-progress game development project or upgrading from an older template version, existing project artifacts like game design documents (GDDs), architecture decision records (ADRs), and user stories may exist but be formatted incorrectly for your team's template workflow. This leads to template skills silently failing or producing incorrect results later in the development process. This skill eliminates that risk by performing a full compliance audit of all existing artifacts before you start working.

Core Features & Use Cases

  • Full Format Compliance Audit: Checks all existing game project artifacts (GDDs, ADRs, user stories, infrastructure files, technical preferences) against the template's required structure, not just file existence.
  • Gap Severity Classification: Organizes all found gaps into four priority tiers (Blocking, High, Medium, Low) so you know exactly what to fix first to avoid pipeline failures.
  • Prioritized Migration Plan: Generates a numbered, actionable plan with exact fix commands, manual steps, and time estimates for every gap, plus guidance on bootstrapping missing infrastructure.
  • Use Case: You're a new game dev joining a mid-production project, and you need to confirm all existing design docs and architecture decisions will work with your team's template skills like /create-stories and /architecture-review before you start contributing.

Quick Start

Run the adopt skill on your active game development project directory to get a full compliance audit and prioritized migration plan for all existing project artifacts.

Frequently Asked Questions about adopt

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

FAQPage Schema
How do I check if existing game design documents and ADRs match a new team template?

To check if existing game design documents and ADRs match a team template, perform a full format compliance audit. This validates all project artifacts against required structures to identify format gaps before pipeline workflows begin.

What is the best way to migrate in-progress game development artifacts to a new template version?

Migrating in-progress game development artifacts to a new template version requires generating a prioritized migration plan. This plan classifies identified format gaps by severity and provides actionable fix commands with time estimates for remediation.

Why do template skills silently fail when onboarding a brownfield game project?

Template skills silently fail during brownfield onboarding because existing project artifacts like GDDs and user stories are formatted incorrectly. Running a pre-workflow compliance audit identifies these structural mismatches to prevent processing errors.

Can I audit infrastructure files and technical preferences for template compliance?

Yes, you can audit infrastructure files and technical preferences for template compliance. The audit evaluates these specific artifacts alongside GDDs and ADRs to ensure full structural alignment before contributing to game projects.

How do I prioritize remediation for format gaps found in game project artifacts?

Prioritize remediation for format gaps by classifying them into four severity tiers: Blocking, High, Medium, and Low. This classification generates a numbered, actionable migration plan so you know exactly what to fix first to avoid pipeline failures.

Does this artifact audit work for mid-production game projects or only new repositories?

The artifact audit works specifically for mid-production game projects and brownfield onboarding scenarios. It evaluates existing in-progress project artifacts rather than bootstrapping new repositories, ensuring current files meet template requirements.