gaelic-ghost · gaelic-ghost · Jul 3, 2026 · Jul 2, 2026 · Jul 2, 2026 · Jul 2, 2026
diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json
@@ -226,6 +226,18 @@
         "authentication": "ON_INSTALL"
       },
       "category": "Developer Tools"
+    },
+    {
+      "name": "game-dev-skills",
+      "source": {
+        "source": "local",
+        "path": "./plugins/game-dev-skills"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Developer Tools"
     }
   ]
 }
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -139,6 +139,7 @@ The installable local child entries currently point at:
 - `./plugins/cardhop-app`
 - `./plugins/codex-utilities`
 - `./plugins/dotnet-skills`
+- `./plugins/game-dev-skills`
 - `./plugins/productivity-skills`
 - `./plugins/python-skills`
 - `./plugins/reverse-engineering-skills`

diff --git a/README.md b/README.md
@@ -88,6 +88,7 @@ Currently available from the catalog:
 - `cardhop-app`
 - `codex-utilities`
 - `dotnet-skills`
+- `game-dev-skills`
 - `productivity-skills`
 - `python-skills`
 - `reverse-engineering-skills`
@@ -112,6 +113,7 @@ Current Socket catalog shape:
 - `cardhop-app`: mixed skill plus bundled MCP server for Cardhop.app contact workflows
 - `codex-utilities`: local Codex runtime utilities, starting with hooks that prefix generated Codex thread titles with the project directory name
 - `dotnet-skills`: .NET, F#, and C# project-shape, bootstrap, implementation, test, package, diagnostics, ASP.NET Core, interop, CI, upgrade, and tooling guidance
+- `game-dev-skills`: Apple platform game development workflows for SpriteKit, SceneKit, GameplayKit simulation, Game Controller input, Core Haptics feedback, Xcode game profiling, game-stack routing, and device-aware validation handoffs
 - `productivity-skills`: general-purpose maintainer, documentation, Dice MCP job-search with bundled remote MCP config, Codex GUI worktree workflow, and automation-design workflows plus source-bundled docs-audit and code-tracing custom-agent definitions
 - `python-skills`: Python runtime and tooling workflows for Python-based projects; see the [Python skills expansion plan](./docs/maintainers/python-skills-plugin-plan.md) for maintainer details
 - `reverse-engineering-skills`: binary inspection, artifact triage, and reproducible reverse-engineering note workflows

diff --git a/ROADMAP.md b/ROADMAP.md
@@ -20,6 +20,7 @@
 - [Milestone 17: Cross-agent skill and plugin portability](#milestone-17-cross-agent-skill-and-plugin-portability)
 - [Milestone 18: Swift Lang shared language plugin](#milestone-18-swift-lang-shared-language-plugin)
 - [Milestone 19: Project audit skills plugin](#milestone-19-project-audit-skills-plugin)
+- [Milestone 20: Game Dev Skills plugin](#milestone-20-game-dev-skills-plugin)
 - [Small Tickets](#small-tickets)
 - [Backlog Candidates](#backlog-candidates)
 - [History](#history)
@@ -53,6 +54,7 @@
 - Milestone 17: Cross-agent skill and plugin portability - Planned
 - Milestone 18: Swift Lang shared language plugin - Completed
 - Milestone 19: Project audit skills plugin - Planned
+- Milestone 20: Game Dev Skills plugin - Completed
 
 ## Milestone 5: SwiftASB skills plugin
 
@@ -589,6 +591,45 @@ Planned
 - [ ] Stack-specific implementation advice routes to owning Socket plugins.
 - [ ] Root Socket docs, marketplace wiring, and validation agree on the exported project-audit surface.
 
+## Milestone 20: Game Dev Skills plugin
+
+### Status
+
+Completed
+
+### Scope
+
+- [x] Add a Socket-hosted `game-dev-skills` child plugin for game-specific authoring, rendering-stack choice, simulation, input, haptics, profiling handoffs, and validation guidance.
+- [x] Keep the first slices Apple-platform-first rather than a broad engine plugin: SpriteKit, SceneKit, GameplayKit simulation, Game Controller input, Core Haptics game feedback, Xcode game profiling, and Apple game-stack routing.
+- [x] Keep the plugin as a companion guidance surface rather than a runtime plugin: do not bundle a game engine, template feed, simulator wrapper, profiler automation, MCP server, or local game runtime.
+- [x] Keep generic Swift, Xcode project integrity, simulator, signing, asset-catalog mechanics, and Apple docs exploration delegated to `apple-dev-skills` and shared Swift language guidance delegated to `swift-lang`.
+
+### Tickets
+
+- [x] Record the detailed plan in [`docs/maintainers/game-dev-skills-plugin-plan.md`](./docs/maintainers/game-dev-skills-plugin-plan.md).
+- [x] Create `plugins/game-dev-skills/` with `.codex-plugin/plugin.json`, `AGENTS.md`, and authored `skills/` source.
+- [x] Add `game-dev-skills:choose-apple-game-stack`.
+- [x] Add `game-dev-skills:spritekit-game-workflow`.
+- [x] Add `game-dev-skills:scenekit-game-workflow`.
+- [x] Add `game-dev-skills:gameplaykit-simulation-workflow`.
+- [x] Add `game-dev-skills:game-controller-input-workflow`.
+- [x] Add `game-dev-skills:core-haptics-game-feedback-workflow`.
+- [x] Add `game-dev-skills:xcode-game-profiling-workflow`.
+- [x] Keep `game-dev-skills:metal-game-rendering-workflow` on the roadmap for a later shader and Metal rendering architecture slice.
+- [x] Wire `game-dev-skills` into the root Socket marketplace as an installable child plugin.
+- [x] Update root README and ROADMAP so users understand the new plugin surface.
+- [x] Run skill-folder validation and plugin-manifest validation for the new child plugin.
+- [x] Run root metadata validation with `uv run scripts/validate_socket_metadata.py`.
+
+### Exit Criteria
+
+- [x] The Socket marketplace exposes `game-dev-skills` as an installable child plugin.
+- [x] The first skill slices can route and guide Apple game work across SpriteKit, SceneKit, GameplayKit simulation, Game Controller input, Core Haptics feedback, Xcode game profiling, and Apple Dev Skills handoffs.
+- [x] The plugin boundary is clear enough that reverse-engineering Unity artifacts stay with `reverse-engineering-skills`, generic Apple mechanics stay with `apple-dev-skills`, and game-specific authoring/profiling work stays here.
+- [x] Root Socket docs, marketplace wiring, and validation agree on the exported game-dev skill surface.
+
+Completed Milestone 20 by adding the `game-dev-skills` child plugin, shipping the Apple-platform game-development workflow slices, wiring the Socket marketplace entry, documenting the plugin boundary, and validating skill metadata, plugin metadata, and root marketplace wiring. Metal rendering and shader architecture remain planned as a later dedicated slice.
+
 ## Small Tickets
 
 - [ ] Record issue-sized fixes, TODO/FIXME imports, and cleanup work that is too small or too unplanned for a milestone.
@@ -613,6 +654,7 @@ Planned
 
 ## Backlog Candidates
 
+- [ ] Add `game-dev-skills:metal-game-rendering-workflow` for a later shader and Metal rendering architecture slice. Scope it after concrete use cases decide whether it owns shader code, render-pass architecture, command encoding, resource layout, Metal debugger workflow, GPU counters, or all of those.
 - [x] Add the first repo-local Socket Steward prototype as a Python `uv` project under `.agents/socket-steward`, using deterministic read-only audits plus an optional OpenAI Agents SDK `ask` path before any write, LaunchAgent, or app behavior.
 - [x] Expand Socket Steward with a docs-sync planning command that emits structured recommended edits for README, CONTRIBUTING, AGENTS, ROADMAP, marketplace metadata, and child plugin guidance without applying them.
 - [x] Add `docs/agents/` as the repo-local report surface and let Socket Steward write reviewable docs-sync proposal reports there without applying the proposed documentation edits.

diff --git a/docs/maintainers/game-dev-skills-plugin-plan.md b/docs/maintainers/game-dev-skills-plugin-plan.md
@@ -0,0 +1,106 @@
+# Game Dev Skills Plugin Plan
+
+This plan records the first durable shape for a Socket-hosted game development skills plugin.
+
+## Intent
+
+The `game-dev-skills` plugin should help agents choose and maintain game-specific project surfaces without turning `apple-dev-skills` into a catch-all for rendering, input, haptics, asset pipelines, profiling, and gameplay architecture.
+
+The first release is Apple-platform-first. It covers SpriteKit, SceneKit, GameplayKit simulation, Game Controller input, Core Haptics feedback, Xcode game profiling, and rendering-stack choice across SpriteKit, SceneKit, RealityKit, Metal, and existing Apple app workflows.
+
+This is a companion guidance plugin, not a runtime plugin. The first version does not bundle a game engine, template feed, asset pipeline, simulator wrapper, profiler automation, MCP server, or local game runtime.
+
+## Packaging Direction
+
+Package the guidance as an independent child plugin under:
+
+```text
+plugins/game-dev-skills/
+```
+
+The child plugin owns its Codex-facing guidance surface:
+
+- `.codex-plugin/plugin.json`
+- `skills/`
+- plugin metadata, skill metadata, `AGENTS.md`, and maintainer notes that explain the plugin's role
+- any validation scripts needed for the plugin's own authored guidance
+
+The root Socket marketplace lists `game-dev-skills` as installable now that first-slice skill content exists. If the plugin ever loses its exported skill content, switch the marketplace entry back to `NOT_AVAILABLE` in the same pass.
+
+## Boundaries With Existing Plugins
+
+- Use `game-dev-skills` for game-specific authoring, input, haptics, rendering-stack choice, frame pacing, game-loop shape, gameplay architecture, and game profiling handoffs.
+- Use `apple-dev-skills` for general Swift, SwiftUI, AppKit, UIKit, Xcode project integrity, simulator, signing, asset-catalog integration, Apple docs routing, DocC, and Apple-platform validation mechanics.
+- Use `swift-lang` for Swift language style, API shape, concurrency, error handling, source layout, and non-game-specific cleanup.
+- Use `reverse-engineering-skills` when the central input is a compiled artifact, binary, Unity build output, symbol file, crash log, decompiled output, or disassembler output.
+- Use future engine-specific skills only when Unity, Godot, Unreal, or another engine-authoring workflow earns a dedicated owner.
+
+Unity belongs here when the task is authoring, maintaining, profiling, or packaging a Unity project. Unity compiled-artifact analysis stays with `reverse-engineering-skills`.
+
+## Documentation And Tool Sources
+
+Use local Xcode documentation, Dash Apple API Reference docsets, and official Apple documentation before making framework-specific claims. Current first-slice source anchors include:
+
+- [SpriteKit](https://developer.apple.com/documentation/spritekit)
+- [SceneKit](https://developer.apple.com/documentation/scenekit)
+- [GameplayKit](https://developer.apple.com/documentation/gameplaykit)
+- [Game Controller](https://developer.apple.com/documentation/gamecontroller)
+- [Core Haptics](https://developer.apple.com/documentation/corehaptics)
+- [RealityKit game development](https://developer.apple.com/documentation/realitykit#Game-development)
+- [Metal developer workflows](https://developer.apple.com/documentation/xcode/metal-developer-workflows)
+- [Designing for games](https://developer.apple.com/design/human-interface-guidelines/designing-for-games)
+
+Translate documentation into the concrete project, framework, validation, or handoff decision it changes.
+
+## Shipped Skill Inventory
+
+### `game-dev-skills:choose-apple-game-stack`
+
+Choose the smallest correct Apple game-development shape before implementation. This skill routes between SpriteKit, SceneKit, RealityKit, Metal, SwiftUI/AppKit/UIKit host surfaces, Game Controller input, Core Haptics feedback, GameKit/Game Center, and existing Apple Dev Skills workflows.
+
+### `game-dev-skills:spritekit-game-workflow`
+
+Guide SpriteKit scene, node, action, physics, camera, resource, GameplayKit integration, and Xcode validation work.
+
+### `game-dev-skills:scenekit-game-workflow`
+
+Guide SceneKit scene, node graph, camera, lighting, material, animation, physics, asset, RealityKit migration, and Xcode validation work.
+
+### `game-dev-skills:gameplaykit-simulation-workflow`
+
+Guide GameplayKit entities, components, component systems, state machines, pathfinding, agents, randomization, renderer synchronization, and simulation validation.
+
+### `game-dev-skills:game-controller-input-workflow`
+
+Guide Game Controller framework work for physical controllers, virtual controllers, keyboard and mouse game input, mappings, connection lifecycle, haptics handoffs, and device-aware validation.
+
+### `game-dev-skills:core-haptics-game-feedback-workflow`
+
+Guide Core Haptics and game-controller haptic feedback design, capability checks, pattern ownership, audio-haptic boundaries, fallback behavior, accessibility, and physical-device validation.
+
+### `game-dev-skills:xcode-game-profiling-workflow`
+
+Guide Apple game profiling across frame pacing, stutter, CPU/GPU overlap, Game Performance and Game Memory templates, Metal Performance HUD routing, `xctrace`, trace evidence, and handoffs to rendering or shader work.
+
+## Proposed Follow-Up Skill Inventory
+
+- `game-dev-skills:metal-game-rendering-workflow`
+- `game-dev-skills:game-asset-pipeline-workflow`
+- `game-dev-skills:gamekit-game-center-workflow`
+- `game-dev-skills:unity-authoring-workflow`
+
+## First Slice
+
+- [x] Create `plugins/game-dev-skills/` with `.codex-plugin/plugin.json` and `AGENTS.md`.
+- [x] Add this maintainer plan.
+- [x] Add first-slice Apple game-development workflow skills.
+- [x] Add `gameplaykit-simulation-workflow` and `xcode-game-profiling-workflow` as the second Apple game-development skill slice.
+- [x] Wire `game-dev-skills` into the root Socket marketplace as installable.
+- [x] Update README and ROADMAP so users understand the new plugin surface.
+- [x] Run skill-folder validation and plugin-manifest validation for the new child plugin.
+- [x] Run root metadata validation with `uv run scripts/validate_socket_metadata.py`.
+
+## Open Questions
+
+- What concrete scope should `metal-game-rendering-workflow` own beyond profiling triage: shader code, render-pass architecture, command encoding, resource layout, Metal debugger workflow, GPU counters, or all of those?
+- Should Unity authoring live in this plugin, or should a later engine-specific plugin own Unity once the authoring scope is concrete?
diff --git a/plugins/agent-portability-skills/.codex-plugin/plugin.json b/plugins/agent-portability-skills/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "agent-portability-skills",
-  "version": "7.8.0",
+  "version": "7.9.0",
   "description": "Maintainer skills for Socket-owned agent skill portability, Codex plugin surfaces, and host adapter guidance.",
   "author": {
     "name": "Gale",

diff --git a/plugins/agent-portability-skills/pyproject.toml b/plugins/agent-portability-skills/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "agent-portability-skills-maintenance"
-version = "7.8.0"
+version = "7.9.0"
 description = "Maintainer-only Python tooling baseline for Agent Portability Skills."
 requires-python = ">=3.11"
 dependencies = []

diff --git a/plugins/agent-portability-skills/uv.lock b/plugins/agent-portability-skills/uv.lock
diff --git a/plugins/android-dev-skills/.codex-plugin/plugin.json b/plugins/android-dev-skills/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "android-dev-skills",
-  "version": "7.8.0",
+  "version": "7.9.0",
   "description": "Android, Kotlin, Java, Gradle, Android Gradle Plugin, testing, lint, UI implementation, and release-readiness workflow skills.",
   "author": {
     "name": "Gale",

diff --git a/plugins/apple-dev-skills/.codex-plugin/plugin.json b/plugins/apple-dev-skills/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "apple-dev-skills",
-  "version": "7.8.0",
+  "version": "7.9.0",
   "description": "Apple development workflows for Codex, including media and audio repair, Xcode coding intelligence, SwiftUI animation and architecture, Core Animation, Apple typography, SF Symbols, AppKit architecture, Icon Composer app icons, Safari extensions, DeviceCheck/App Attest, Swift OpenAPI clients, and DocC authoring guidance.",
   "author": {
     "name": "Gale",

diff --git a/plugins/apple-dev-skills/pyproject.toml b/plugins/apple-dev-skills/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "apple-dev-skills-maintainer"
-version = "7.8.0"
+version = "7.9.0"
 description = "Maintainer tooling for the apple-dev-skills repository"
 requires-python = ">=3.10"
 dependencies = []

diff --git a/plugins/apple-dev-skills/uv.lock b/plugins/apple-dev-skills/uv.lock
diff --git a/plugins/cardhop-app/.codex-plugin/plugin.json b/plugins/cardhop-app/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "cardhop-app",
-  "version": "7.8.0",
+  "version": "7.9.0",
   "description": "Cardhop.app workflow guidance plus a bundled local MCP server for contact capture and updates on macOS.",
   "author": {
     "name": "Gale",

diff --git a/plugins/cardhop-app/mcp/pyproject.toml b/plugins/cardhop-app/mcp/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "cardhop-app-mcp"
-version = "7.8.0"
+version = "7.9.0"
 requires-python = ">=3.13"
 dependencies = [
     "fastmcp>=3.0.2",

diff --git a/plugins/cardhop-app/mcp/uv.lock b/plugins/cardhop-app/mcp/uv.lock
diff --git a/plugins/codex-utilities/.codex-plugin/plugin.json b/plugins/codex-utilities/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "codex-utilities",
-  "version": "7.8.0",
+  "version": "7.9.0",
   "description": "Local Codex runtime utilities for thread, hook, and app-server workflows.",
   "author": {
     "name": "Gale",

diff --git a/plugins/dotnet-skills/.codex-plugin/plugin.json b/plugins/dotnet-skills/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "dotnet-skills",
-  "version": "7.8.0",
+  "version": "7.9.0",
   "description": "Codex skills for choosing, bootstrapping, building, testing, packaging, diagnosing, and maintaining .NET projects with F# and C# as equal first-party languages.",
   "author": {
     "name": "Gale",

diff --git a/plugins/game-dev-skills/.codex-plugin/plugin.json b/plugins/game-dev-skills/.codex-plugin/plugin.json
@@ -0,0 +1,54 @@
+{
+  "name": "game-dev-skills",
+  "version": "7.9.0",
+  "description": "Apple platform game development workflow skills for SpriteKit, SceneKit, GameplayKit, controller input, haptics, profiling, and game-stack routing.",
+  "author": {
+    "name": "Gale",
+    "email": "mail@galewilliams.com",
+    "url": "https://github.com/gaelic-ghost"
+  },
+  "homepage": "https://github.com/gaelic-ghost/socket/tree/main/plugins/game-dev-skills",
+  "repository": "https://github.com/gaelic-ghost/socket",
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "keywords": [
+    "game-development",
+    "apple",
+    "spritekit",
+    "scenekit",
+    "gameplaykit",
+    "game-controller",
+    "core-haptics",
+    "realitykit",
+    "metal",
+    "instruments",
+    "xctrace",
+    "profiling",
+    "xcode",
+    "codex",
+    "plugin",
+    "skills"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Game Dev Skills",
+    "shortDescription": "Apple game development workflow skills for Codex.",
+    "longDescription": "Guide Codex agents through Apple platform game development decisions and implementation work across SpriteKit, SceneKit, GameplayKit simulation, Game Controller input, Core Haptics game feedback, Xcode game profiling, RealityKit and Metal routing, assets, and device-aware validation.",
+    "developerName": "Gale",
+    "category": "Developer Tools",
+    "capabilities": [
+      "Read",
+      "Write"
+    ],
+    "websiteURL": "https://github.com/gaelic-ghost/socket/tree/main/plugins/game-dev-skills",
+    "defaultPrompt": [
+      "Choose the right Apple game stack before we start implementing.",
+      "Build or repair this SpriteKit scene, game loop, physics, or resource flow.",
+      "Build or repair this SceneKit scene, node graph, camera, lighting, or asset flow.",
+      "Design or repair this GameplayKit entity, component, state-machine, pathfinding, or agent system.",
+      "Wire game controller, keyboard, mouse, or virtual-controller input for this Apple game.",
+      "Design or debug Core Haptics feedback for a game while keeping device validation honest.",
+      "Profile this Apple game for frame pacing, stutter, CPU/GPU overlap, memory pressure, or trace evidence without turning profiling into shader architecture."
+    ],
+    "brandColor": "#28D7FF"
+  }
+}