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/08-game-design-craft-critique.md
View on GitHub# game-design-craft-critique
## Purpose
Critique how a player learns, notices, predicts, and masters. This packet is a repository-aware operating procedure, not a label to apply to a design.
## Evidence intake
Inspect repository evidence before requesting context: video, build, control scheme, tutorial, challenge sequence. Then inspect these capability-specific signals: readability, pattern discovery, feedback timing, variation, mastery ceiling. 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. Trace the learning ladder: notice, form a prediction, act, receive legible feedback, revise a model, and demonstrate mastery.
2. Separate surface polish from pattern readability, challenge composition, and expressive decision space.
3. Critique a concrete sequence rather than the game’s genre or ambition.
## Capability matrix
| Lens | Repository question | Player or delivery consequence |
|---|---|---|
| readability | What evidence shows how this changes the reviewed moment? | Record the effect, confidence, and repair test. |
| pattern discovery | What evidence shows how this changes the reviewed moment? | Record the effect, confidence, and repair test. |
| feedback timing | What evidence shows how this changes the reviewed moment? | Record the effect, confidence, and repair test. |
| variation | What evidence shows how this changes the reviewed moment? | Record the effect, confidence, and repair test. |
| mastery ceiling | 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:
- moment transcript
- learning-model diagnosis
- craft strengths
- frictions
- sequence-specific revisions
## Failure modes
- Do not use “fun” as a finding.
- Do not add variation before players can read the base pattern.
- Ground every verdict in a specific player moment, choice, and observed consequence.
## Example application
When a team needs to critique how a player learns, notices, predicts, and masters, 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 `readability` as the first discriminating lens, because it is closest to the stated capability.
2. Compare it against `mastery ceiling` before selecting a fix; this prevents a single-dimension conclusion.
3. Convert the result into `moment-level craft critique` with an owner, a quality guard, and a stop rule.
## Validation
Test whether players can explain a new pattern and adapt it on the next encounter.
## 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 |