ruleset-diff-audit

Audits Godot engine code against ruleset PDFs and flags hardcoded rule constants.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/rpmcdougall/claude-skills --skill ruleset-diff-audit-rpmcdougall
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ruleset-diff-audit
Source: https://github.com/rpmcdougall/claude-skills/tree/main/skills/ruleset-diff-audit
Command: npx skills add https://github.com/rpmcdougall/claude-skills --skill ruleset-diff-audit-rpmcdougall

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Verifying that a game engine faithfully implements a tabletop ruleset is tedious: rules live in PDFs, parameters live in JSON, and logic lives in GDScript, with no easy way to confirm they agree. This Skill cross-checks all three sources and produces a structured compliance checklist. ## Core Features & Use Cases - Rule-to-code mapping: Greps the rules PDF table of contents and changelist files, then locates the implementing functions in game_engine.gd and godot/game/. - Hardcoded constant detection: Flags rule parameters (like a panic threshold of 7) that should live in game/rulesets/*.json instead of engine code. - Checklist and findings output: Produces a table of Rule / Engine location / JSON-driven / Matches rules, plus grouped findings for mismatches and uncovered rules. - Use Case: Before adopting ruleset v18, run an audit scoped to melee to see which v17 mechanics are JSON-driven, which are hardcoded, and which v18 changelist items have no engine coverage yet. ## Quick Start Ask the AI to run a v17 ruleset compliance audit on the engine, scoped to all phases, and file issues for any hardcoded rule constants it finds.

Frequently Asked Questions about ruleset-diff-audit

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

FAQPage Schema
How do I audit game engine code against a ruleset PDF?▼

Run the audit with a target version (v17, v18, or v19) and optional scope filter like melee or shooting. It greps the rules PDF table of contents, maps each rule to engine functions in game_engine.gd, and checks whether parameters live in the ruleset JSON.

How to find hardcoded game rule constants that should be in JSON config?▼

The audit flags any rule parameter implemented as a literal in GDScript rather than read from game/rulesets/<version>.json. It distinguishes true rule parameters (like a panic threshold) from pure implementation details like array indices, which are not findings.

Can I audit a ruleset version that has no JSON file yet?▼

Yes. If the target version (for example v18 during playtest) has no ruleset JSON, the audit says so and instead compares the v18 changelist against what is currently coded under v17, listing expected changes versus current behavior.

Does the ruleset audit modify engine code automatically?▼

No. The audit is read-only by design: findings feed into issues filed via the file-issue skill, linked to parent audit issues like #38 or #72. It never edits engine code or opens PRs as part of the audit.

What are the limitations of a grep-based ruleset compliance audit?▼

Grep-based mapping can miss rules implemented indirectly or under unexpected function names, so some engine coverage may require manual judgment. Rule citations should be verified verbatim with page numbers using the companion v17-rule skill.