notque/vexjoy-agent / skills/game/game-dev
game-dev
FlaggedGame development: design, asset pipelines, Phaser, Unity CLI and builds, vanilla JS frontend, GM mode, match booking.
references/capabilities/17-game-design-flow-audit.md
View on GitHub# game-design-flow-audit
## Purpose
Audit challenge, skill, focus, feedback, interruption, and recovery. This packet is a repository-aware operating procedure, not a label to apply to a design.
## Evidence intake
Inspect repository evidence before requesting context: level sequence, sessions, UX, player behavior. Then inspect these capability-specific signals: challenge ramp, clarity, decision load, feedback speed, distraction, re-entry. Ask only for external evidence, confidential player research, decision authority, or constraints unavailable in the repository.
Mark every claim as `observed`, `documented`, `measured`, or `inferred`. Give each inference a confidence level and a disproof route.
## Method
1. Plot player skill against challenge over time, then annotate clarity, focus, feedback speed, interruption, and recovery.
2. Identify anxiety spikes, boredom flats, overload clusters, and mastery plateaus.
3. Introduce one new demand at a time and provide a safe application before stacking complexity.
## Capability matrix
| Lens | Repository question | Player or delivery consequence |
|---|---|---|
| challenge ramp | What evidence shows how this changes the reviewed moment? | Record the effect, confidence, and repair test. |
| clarity | What evidence shows how this changes the reviewed moment? | Record the effect, confidence, and repair test. |
| decision load | What evidence shows how this changes the reviewed moment? | Record the effect, confidence, and repair test. |
| feedback speed | What evidence shows how this changes the reviewed moment? | Record the effect, confidence, and repair test. |
| distraction | What evidence shows how this changes the reviewed moment? | Record the effect, confidence, and repair test. |
| re-entry | What evidence shows how this changes the reviewed moment? | Record the effect, confidence, and repair test. |
## Diagnostic questions
- What exact player moment or delivery decision is under review?
- Which capability lens above has the strongest evidence and which is only an inference?
- Which competing explanation would produce the same visible symptom?
- What is the smallest change or test that would separate them?
## Output schema
Return all of the following, not a generic summary:
- flow timeline
- interruption map
- demand sequence
- pacing interventions
## Failure modes
- Do not equate flow with continuous reward or zero friction.
- Do not diagnose flow without a time sequence.
- Flow is not maximum intensity or uninterrupted reward.
## Example application
When a team needs to audit challenge, skill, focus, feedback, interruption, and recovery, begin with the available build path and the capability matrix above. Apply the named method to the affected moment, not an abstract feature description. If direct player evidence is absent, publish an evidence gap rather than a false conclusion; label the result as inferred and use the validation below to move it toward measured evidence.
## Decision procedure
1. Use `challenge ramp` as the first discriminating lens, because it is closest to the stated capability.
2. Compare it against `re-entry` before selecting a fix; this prevents a single-dimension conclusion.
3. Convert the result into `flow map and pacing fixes` with an owner, a quality guard, and a stop rule.
## Validation
Observe attention, errors, voluntary persistence, and post-session recall across the revised segment.
## Full-diagnostic disposition
In a complete repository diagnostic, run this packet and record `assessed`, `evidence gap`, or `not applicable` with a game-specific reason. A missing artifact is a finding; it never permits silent omission.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |