{
  "markdown": "# Game Superpowers\n\n[简体中文](./README.zh-CN.md)\n\nGame development skills for Claude Code, Codex, and Gemini CLI.\n\nBuild, audit, polish, and repair game projects with reusable game-native skills.\n\n## At a glance\n\n- for Claude Code, Codex, and Gemini CLI\n- skills live in `skills/`\n- install locally, fork freely, use selectively\n- source of truth stays in this repo\n\n## Quickstart\n\n### Claude\n\nUse the whole repo:\n\n```bash\nclaude --add-dir /path/to/game-superpowers-skills-only\n```\n\nOr install into your personal skills:\n\n```bash\nbash scripts/install-claude-skills.sh\n```\n\n```powershell\npowershell -ExecutionPolicy Bypass -File scripts/install-claude-skills.ps1\n```\n\nThis installs symlinks into `~/.claude/skills/` and sets up repo-local git hooks so later `git pull` and branch switches refresh those links automatically.\n\n### Codex\n\nInstall into your user skills:\n\n```bash\nbash scripts/install-codex-skills.sh\n```\n\n```powershell\npowershell -ExecutionPolicy Bypass -File scripts/install-codex-skills.ps1\n```\n\nThis installs the `~/.agents/skills/game-superpowers/` package root and sets up the same auto-sync hooks for future pulls and checkouts.\n\nOr copy or symlink selected skills into a project's `.agents/skills/`.\n\n### Gemini CLI\n\nInstall from the local repo:\n\n```bash\ngemini extensions link /path/to/game-superpowers-skills-only\n```\n\nOr install from GitHub:\n\n```bash\ngemini extensions install https://github.com/haoshengli/game-superpowers-skills-only\n```\n\nGemini loads the extension through the repo-root `GEMINI.md` and the `gemini-extension.json` manifest.\n\nFull setup instructions: [`INSTALL.md`](./INSTALL.md)\n\n### Updates after install\n\n- edits to existing skills apply immediately because the installed entries are symlinks back to this repo\n- added, renamed, or removed skills refresh automatically after `git pull` and branch switches\n- if you want to force a refresh manually, run `bash scripts/sync-all-skills.sh`\n- on Windows, use `powershell -ExecutionPolicy Bypass -File scripts/sync-all-skills.ps1`\n\n## Use\n\n### Entrypoint\n\n- Claude: `/using-game-superpowers`\n- Codex: `$using-game-superpowers`\n- Gemini: ask normally, for example `Use Game Superpowers to audit this game project.`\n\n### Example prompts\n\n- \"Use Game Superpowers to audit this existing game project's UI/UX and feedback design.\"\n- \"Use Game Superpowers to build a polished 2D web prototype with strong HUD and feedback.\"\n- \"Use Game Superpowers to review whether this game is closer to first-playable or production-feature quality.\"\n- \"Use Game Superpowers with spec-driven planning and create requirements, spec, design, and tasks for this combat feature.\"\n\n## Tracks\n\n```mermaid\nflowchart TD\n    A[User request] --> B[using-game-superpowers]\n    B --> C{Classify task}\n    C -->|build| D[Build Track]\n    C -->|audit| E[Audit Track]\n    C -->|repair| F[Repair Track]\n    C -->|polish| G[Polish Track]\n    D --> H[Scope + strategy + implementation skills]\n    E --> I[Audit skills + scorecard + roadmap]\n    F --> J[Targeted repair skills]\n    G --> K[UX + feedback + verifier skills]\n```\n\n## Optional Spec-Driven Workflow\n\nFor teams that want durable planning artifacts in the target repo, Game Superpowers now supports a lightweight OpenSpec-inspired workflow.\n\n- living specs: `specs/<capability>/spec.md`\n- change package: `changes/<change-id>/proposal.md`, `design.md`, `tasks.md`\n- spec delta: `changes/<change-id>/specs/<capability>/spec.md`\n\nUse `game-spec-driven-planning` when the user explicitly asks for `requirements/spec/design/tasks`, references OpenSpec, or wants repo-native planning artifacts that survive across sessions.\n\n## Repo Layout\n\n- `skills/` — the full Game Superpowers skill library\n- `schemas/` — shared structured output schemas\n- `shared/` — templates, references, checklists, and examples\n- `.claude/skills/` — Claude Code discovery symlinks pointing back to `skills/`\n- `.agents/skills/` — Codex discovery symlinks pointing back to `skills/`\n- `scripts/` — installers, auto-sync hooks, and validation helpers\n\nNotes:\n\n- `skills/` is the only source of truth\n- `.claude/skills/` and `.agents/skills/` are compatibility paths, not a second copy of the library\n- if your platform or archive tool handles symlinks poorly, inspect `skills/` first\n\n## Library\n\n- bootstrap and routing skills\n- optional spec-driven planning for durable change artifacts\n- build planning and strategy skills\n- UX, UI, and feedback skills\n- mechanics and systems skills\n- production and live patch skills\n- audit and scorecard skills\n- browser specialist skills for 2D and 3D web work\n\n## Development\n\nRead these first:\n\n- `skills/using-game-superpowers/SKILL.md`\n- `skills/game-super-build/SKILL.md`\n- `skills/game-project-audit/SKILL.md`\n- `skills/game-ux-flow-audit/SKILL.md`\n- `skills/game-feedback-design/SKILL.md`\n\nBefore opening a pull request, run:\n\n```bash\npython3 scripts/validate_skills.py\n```\n\nSee [`CONTRIBUTING.md`](./CONTRIBUTING.md) for repository change rules and local validation.\nSee [`CODE_OF_CONDUCT.md`](./CODE_OF_CONDUCT.md) for collaboration expectations.\n\n## License\n\nMIT\n",
  "bytes": 5090,
  "sha": "856df1b2aa8616f2bb4718d81d6842f64ad080594637672e1ff56a826b305a29",
  "repo_slug": "mike007jd/game-superpowers",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_mike007jd_game_superpowers_62e8ecc0/readme"
}