content-audit

Audit GDD-specified content counts against implemented game content files.

13|Updated Jul 30, 2026
One-click install
npx skills add https://github.com/frabcd/codex-ai-game-studio --skill content-audit-frabcd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: content-audit
Source: https://github.com/frabcd/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/content-audit
Command: npx skills add https://github.com/frabcd/codex-ai-game-studio --skill content-audit-frabcd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Game projects drift out of sync with their design documents: GDDs specify enemies, levels, items, and quests, but nobody tracks how much of that content is actually implemented. This Skill compares planned content counts against files present in the project and reports the gap. ## Core Features & Use Cases - GDD Content Extraction: Parses design documents for explicit content counts (enemies, levels, items, abilities, dialogue, quests) and flags GDDs with unspecified counts. - Implementation Scanning: Searches scene files (.tscn, .unity, .umap) and data files (.json, .tres, .asset, .yaml) across engine-specific directory conventions to count built content. - Gap Reporting: Produces a status table (COMPLETE, IN PROGRESS, EARLY, NOT STARTED) with HIGH PRIORITY flags for MVP-tagged systems, plus an optional dated report written to docs/. - Use Case: Before a sprint review, run a full audit to discover that the GDD specifies 12 enemy types but only 4 exist as data files, then generate backlog stories for the gap. ## Quick Start Ask the AI to run a content audit comparing the GDD-specified content counts against the implemented content in this project and report the gaps.

Frequently Asked Questions about content-audit

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

FAQPage Schema
How do I check if my game content matches the GDD?

Run a content audit that parses GDD files for explicit content counts like enemy types, levels, and items, then scans the project directories for implemented scene and data files. The result is a gap table showing specified versus found counts per system.

How to track game development progress against design documents?

Extract content counts from GDD markdown files and compare them against files discovered in assets and src directories. Each system gets a status of COMPLETE, IN PROGRESS, EARLY, or NOT STARTED based on the percentage implemented.

Does content auditing work with Unity, Godot, and Unreal projects?

Yes, the scan looks for .tscn, .unity, and .umap scene files plus .json, .tres, .asset, and .yaml data files in conventional directory structures. Counts are approximations since the scan cannot distinguish shipped content from editor-only or test assets.

Can I audit just one game system instead of the whole project?

Yes, pass a system name as the argument to audit only that system's GDD and content. Use the --summary flag to print the gap table to the conversation without writing a report file.

What are the limitations of automated content counting?

Counts are approximations because file scanning cannot perfectly parse every engine format or separate gameplay scenes from UI and system scenes. GDDs that describe content qualitatively without explicit counts are flagged as unspecified rather than audited.