agentleFS
mewziciansmewzicians/Skills-Folder/skills/game-playtest-analysis/SKILL.md

game-playtest-analysis

Skill0 starsChanged 24 days agoApache-2.0View on GitHub

Turn game playtest notes, recordings, saves, screenshots, surveys, interviews, and telemetry into prioritized findings and discriminating experiments. Use when the user asks what player feedback means, why players succeeded or failed, or what to test next.

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 7 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  • could be automatic: a setting could enforce it
  1. Distinctive:

    Read repository guidance and references/project-profile.md.

    line 8
  2. Distinctive:

    Look for decision bottlenecks, automatic choices, unused systems, first irreversible deficits, build availability versus execution, pacing …

    line 25
  3. Distinctive:

    Keep recommendations draft until approved.

    line 29
  4. Distinctive:

    Don't bend one because a request is casual: ask the user.

    line 35
  5. Distinctive:

    Don't add a rule after your own mistake or a reviewer's nitpick without that yes.

    line 52
  6. Distinctive:

    Ask about new rules once, batched at the end of the task.

    line 55
  7. Distinctive:

    When a file hits its size cap, or at a milestone, prune it: cut rules no one can tie to a reason.

    line 56

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Game Playtest Analysis

Read repository guidance and references/project-profile.md. Identify the exact tested build and current rules; never merge evidence from different builds without labels.

Normalize each session when available: player profile, build/version, platform, inputs, seed/save, choices, resources, progression, session length, failure or success cause, exact quote or observation, and supporting artifact. Keep observation, player explanation, analyst hypothesis, and telemetry separate. Hard rule: label agent- or script-played sessions; they are not human evidence, because a call made on scripted play can look confirmed when no person ever played it. Hard rule: pseudonymize participants, keep only needed data, and keep participant data out of public files; published personal data can't be recalled.

Classify each finding:

  • Bug: the build contradicts its rules or intent, shown by reproduction or source evidence, not a report alone.
  • Comprehension: a player misread a rule, state, or goal.
  • Decision quality: choices were automatic, empty, or unreadable.
  • Balance: an option, strategy, or curve is too strong or weak.
  • Pacing: length or repetition caused fatigue or drop-off.
  • Feedback: a result was unclear, late, or missing.
  • Accessibility: an input, display, or cognitive barrier blocked play.
  • Taste: a preference, not a defect.

Assess frequency, severity, reproducibility, reach, learning effects, telemetry support, confidence, and competing explanations.

Look for decision bottlenecks, automatic choices, unused systems, first irreversible deficits, build availability versus execution, pacing fatigue, tutorial drop-off, feedback delays, and exceptional-mode confusion.

Rank findings by player harm and evidence strength. For each important hypothesis, propose the smallest discriminating reproduction, prototype, instrumentation event, ablation, seed set, cohort comparison, or interview question, including what outcome would support or reject it.

Keep recommendations draft until approved. Route confirmed defects, balance questions, UX issues, and approved implementation to the appropriate specialized workflow.

Rules And Pushback

Lines marked Hard rule guard approvals, deletion, publishing, and private data, where a mistake is costly or can't be undone; each gives its reason. Don't bend one because a request is casual: ask the user. Unmarked lines still bind too. Scope limits, honest evidence, and approval steps aren't optional. Scale each step's effort to the risk, and say so when you skip one that doesn't fit. A profile or instruction file records an owner decision only where it says the owner made it; otherwise treat it as project guidance. If a rule seems wrong for this task, say which one and why before you continue.

How Rules Get Made

  1. Something the user says in passing applies to the current task only.
  2. Exception: anything about money, privacy, publishing, deleting, or permissions binds as soon as they say it. Ask once whether to make it permanent.
  3. A rule becomes standing only when the user says "make this a rule", or you ask and they say yes. Record their words, the date, and the reason with it.
  4. This covers every file that steers an agent: instruction files, style guides, skills, checklists, templates, CI checks, and agent memory.
  5. Don't add a rule after your own mistake or a reviewer's nitpick without that yes. Fix the input or the work instead.
  6. A new ruling replaces the one it contradicts. Never keep both.
  7. Ask about new rules once, batched at the end of the task.
  8. When a file hits its size cap, or at a milestone, prune it: cut rules no one can tie to a reason. The user's taste decisions are flagged for them and never cut by an agent.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.