content-audit

Compare GDD-specified content counts against repository assets to identify missing game content.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill content-audit-polsegu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: content-audit
Source: https://github.com/polsegu/Claude-Code-Game-Dev/tree/main/.claude/skills/content-audit
Command: npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill content-audit-polsegu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits design document (GDD) specified content counts against implemented assets to reveal missing, underspecified, or mismatched game content. This saves producer time by converting scattered spec language and repository artifacts into a prioritized, actionable gap report.

Core Features & Use Cases

  • Multi-mode audit: full-project scans or single-system audits with a summary-only option.
  • Spec parsing: extracts explicit counts and enumerated lists from design/gdd Markdown files and flags unspecified counts as design gaps.
  • Implementation scan: uses glob and grep patterns to approximate implemented counts for levels, enemies, items, abilities, dialogue, and quests across assets and source directories.
  • Gap reporting & prioritization: produces a per-system gap table with status categories, highlights HIGH PRIORITY items, and optionally writes a dated report file to docs/.
  • Actionable next steps: suggests follow-ups such as creating backlog stories, running design or sprint planning flows, and re-running audits after fixes.

Quick Start

Run /content-audit to produce a full audit and prompt to save a dated report, or run /content-audit [system-name] for a single-system check.

Frequently Asked Questions about content-audit

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

FAQPage Schema
How do I find gaps between game design specs and implemented assets?

Find gaps between game design specs and implemented assets by scanning Markdown GDDs for enumerated content counts and using glob and grep to tally artifacts in your repository. The audit compares specified versus implemented levels, enemies, items, abilities, dialogue, and quests to generate a gap table.

What is a game content audit and when do I need to run one?

A game content audit is a gap analysis comparing GDD-specified content counts against implemented repository artifacts. You need to run one when scattered design language and source assets must be converted into a prioritized, actionable gap report to identify missing or mismatched game content.

Can I audit a single system like enemies or dialogue instead of the full game project?

Yes, you can audit a single system like enemies or dialogue by running the audit with a specific system name argument. This single-system mode checks individual content categories, while the full-project mode scans all systems with an optional summary-only output.

Does the content audit work with any game engine or repository structure?

The content audit works with game development projects using Markdown GDDs and repository asset or source folders. It applies glob and grep scans across design, assets, and src directories to approximate implemented counts for levels, enemies, items, abilities, dialogue, and quests.

How to generate a dated gap report for missing game content?

Generate a dated gap report for missing game content by running a full audit scan, which extracts enumerated counts from Markdown design files and tallies found artifacts. It produces a per-system gap table with status flags and optionally writes a dated report file to your docs directory.

What are the limitations of using grep and glob for game asset inventory?

Using grep and glob for game asset inventory approximates implemented counts by pattern matching files across assets and source directories. It may flag unspecified counts as design gaps, but relies on directory structure and cannot assess runtime behavior or asset quality beyond file presence.