agentleFS
scotidevscotidev/GameDevStudio/.agents/skills/prototype/SKILL.md

prototype

Skill1 starsChanged 8 months agoMITView on GitHub

Rapid prototyping workflow. Skips normal standards to quickly validate a game concept or mechanic. Produces throwaway code and a structured prototype report.

194 other projects use a version of this, 5 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use soak-test, team-live-ops and 5 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • lilangMaxSkill

    soak-test

    Generate a soak test protocol for extended play sessions. Defines what to observe, measure, and log during long play sessions to surface slow leaks, fatigue effects, and edge cases that only appear after sustained play. Primarily used in Polish and Release phases.

    Also in 9 projects that use this

  • lilangMaxSkill

    team-live-ops

    Orchestrate the live-ops team for post-launch content planning: coordinates live-ops-designer, economy-designer, analytics-engineer, community-manager, writer, and narrative-director to design and plan a season, event, or live content update.

    Also in 9 projects that use this

  • +5 more from lilangMax

The file

We split this skill into the rules it gives an agent

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

  • 0

    Common

    Most of the 179 edited versions we read keep these.

  • 5

    Distinctive

    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
  1. Distinctive:

    When this skill is invoked:

    line 9
  2. Distinctive:

    Use the simplest approach that works

    line 39
  3. Distinctive:

    Test the concept: Run the prototype. Observe behavior.

    line 42
  4. Distinctive:

    If the recommendation is PROCEED, the production implementation must be written from scratch -- prototype code is not refactored into …

    line 107
  5. Distinctive:

    If the prototype scope starts growing, stop and reassess whether the question can be simplified

    line 110

“Common” is measured: kept by at least 6 in 10 of the 179 edited versions of this file we could read. “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

When this skill is invoked:

  1. Read the concept description from the argument. Identify the core question this prototype must answer. If the concept is vague, state the question explicitly before proceeding.
  2. Read AGENTS.md for project context and the current tech stack. Understand what engine, language, and frameworks are in use so the prototype is built with compatible tooling.
  3. Create a prototype plan: Define in 3-5 bullet points what the minimum viable prototype looks like. What is the core question? What is the absolute minimum code needed to answer it? What can be skipped?
  4. Create the prototype directory: prototypes/[concept-name]/ where [concept-name] is a short, kebab-case identifier derived from the concept.
  5. Implement the prototype in the isolated directory. Every file must begin with:

    // PROTOTYPE - NOT FOR PRODUCTION
    // Question: [Core question being tested]
    // Date: [Current date]

    Standards are intentionally relaxed:

    • Hardcode values freely
    • Use placeholder assets
    • Skip error handling
    • Use the simplest approach that works
    • Copy code rather than importing from production
  6. Test the concept: Run the prototype. Observe behavior. Collect any measurable data (frame times, interaction counts, feel assessments).
  7. Generate the Prototype Report and save it to prototypes/[concept-name]/REPORT.md:
## Prototype Report: [Concept Name]

### Hypothesis

[What we expected to be true -- the question we set out to answer]

### Approach

[What we built, how long it took, what shortcuts we took]

### Result

[What actually happened -- specific observations, not opinions]

### Metrics

[Any measurable data collected during testing]

- Frame time: [if relevant]
- Feel assessment: [subjective but specific -- "response felt sluggish at
  200ms delay" not "felt bad"]
- Player action counts: [if relevant]
- Iteration count: [how many attempts to get it working]

### Recommendation: [PROCEED / PIVOT / KILL]

[One paragraph explaining the recommendation with evidence]

### If Proceeding

[What needs to change for a production-quality implementation]

- Architecture requirements
- Performance targets
- Scope adjustments from the original design
- Estimated production effort

### If Pivoting

[What alternative direction the results suggest]

### If Killing

[Why this concept does not work and what we should do instead]

### Lessons Learned

[Discoveries that affect other systems or future work]
  1. Output a summary to the user with: the core question, the result, and the recommendation. Link to the full report at prototypes/[concept-name]/REPORT.md.

Important Constraints

  • Prototype code must NEVER import from production source files
  • Production code must NEVER import from prototype directories
  • If the recommendation is PROCEED, the production implementation must be written from scratch -- prototype code is not refactored into production
  • Total prototype effort should be timeboxed to 1-3 days equivalent of work
  • If the prototype scope starts growing, stop and reassess whether the question can be simplified

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.