gaelic-ghost · gaelic-ghost · May 9, 2026 · May 9, 2026 · May 9, 2026 · May 9, 2026
diff --git a/README.md b/README.md
@@ -1,10 +1,10 @@
 # socket
 
-Gale's Codex plugin marketplace for macOS users and Apple/Swift devs. Includes companion plugins for my other packages, like SwiftASB.
+*The macOS Marketplace for Codex*
 
 ![Codex plugin directory filtered to the Socket marketplace, showing Productivity Skills featured above installable Socket child plugins.](./docs/media/codex-plugin-directory-socket-productivity-skills.png)
 
-`Socket` is the "marketplace", or catalog, of available plugins. Add `socket` to Codex, then use Codex to choose which individual plugins you wanna install.
+Promo audio: [Socket Codex Marketplace Promo](./docs/media/socket-codex-marketplace-promo.mp3)
 
 ## Table of Contents
 
@@ -21,15 +21,15 @@ Gale's Codex plugin marketplace for macOS users and Apple/Swift devs. Includes c
 
 ### Status
 
-`socket` is active, maintained, and used by Gale daily.
+`socket` is maintained and supported by Gale.
 
 ### What This Project Is
 
-Socket is a monorepo of Codex Plugins I've built while beginning to use coding agents to assist in my projects. It includes a variety of plugins, from productivity tools to apple dev workflow systems, docs access to a local TTS system. 
+Socket is a Marketplace of Plugins, Hooks, and MCP servers for Apple Platform Devs
 
 ### Motivation
 
-It became obvious to me that these things needed specialized tooling to do specialized work. Not seeing much of what I wanted on offer, I set out to build that myself. Eventually, I moved all my individual plugin repos to this monorepo for easier maintenance, updates, releases, etc.
+Agents are great, but to do specialized work, they need specialized tools. As I continued building skills for my workflows, I needed a place to distribute them from. Socket is that place. I hope you find these as useful as I have.
 
 ## Quick Start
 
@@ -39,13 +39,15 @@ Add the `socket` marketplace to Codex with:
 codex plugin marketplace add gaelic-ghost/socket
 ```
 
+After adding `socket`, restart your Codex, open the plugin directory, select `Socket`, and then install your choice of plugins.
+
 When the marketplace changes, refresh it with:
 
 ```bash
 codex plugin marketplace upgrade socket
 ```
 
-After adding or upgrading `socket`, restart your Codex, open the plugin directory, select `Socket`, and then install or enable whichever plugins you want.
+Newly added plugins can be installed from the same plugin directory inside Codex.
 
 ## Usage
 
@@ -68,16 +70,16 @@ Apple Dev Skills keeps its own roadmap because it is the remaining subtree-manag
 
 Current Socket catalog shape:
 
-- `agent-plugin-skills`: active maintainer skills for skills-export and plugin-export repositories
-- `apple-dev-skills`: active Apple, Swift, SwiftUI, Xcode, and DocC workflows with its own roadmap
-- `cardhop-app`: active mixed skill plus bundled MCP server for Cardhop.app contact workflows
-- `productivity-skills`: active general-purpose maintainer and documentation workflow baseline
-- `python-skills`: active Python, `uv`, FastAPI, FastMCP, and pytest workflow plugin
-- `speak-swiftly`: active Git-backed Speak Swiftly plugin from the standalone SpeakSwiftlyServer repository
-- `swiftasb-skills`: active SwiftASB companion guidance
-- `things-app`: active mixed skill plus bundled MCP server for Things.app workflows
+- `agent-plugin-skills`: maintainer skills for skills-export and plugin-export repositories
+- `apple-dev-skills`: Apple, Swift, SwiftUI, Xcode, and DocC workflows with its own roadmap
+- `cardhop-app`: mixed skill plus bundled MCP server for Cardhop.app contact workflows
+- `productivity-skills`: general-purpose maintainer and documentation workflow baseline
+- `python-skills`: Python, `uv`, FastAPI, FastMCP, and pytest workflow plugin
+- `speak-swiftly`: Git-backed Speak Swiftly plugin from the standalone SpeakSwiftlyServer repository
+- `swiftasb-skills`: SwiftASB companion guidance
+- `things-app`: mixed skill plus bundled MCP server for Things.app workflows
 
-Placeholder plugin directories are intentionally visible but not installable until real skill or workflow content exists:
+Placeholder directories for future plugins (not available for install):
 
 - `dotnet-skills`
 - `rust-skills`
@@ -111,4 +113,4 @@ Use GitHub releases and Git history for root `socket` changes. Child plugins may
 
 ## License
 
-The `socket` superproject is licensed under the Apache License 2.0. See [LICENSE](./LICENSE) and [NOTICE](./NOTICE).
+The `socket` superproject, and all nested projects, are licensed under the Apache License 2.0. See [LICENSE](./LICENSE) and [NOTICE](./NOTICE).
diff --git a/docs/media/socket-codex-marketplace-promo.mp3 b/docs/media/socket-codex-marketplace-promo.mp3
diff --git a/plugins/agent-plugin-skills/.codex-plugin/plugin.json b/plugins/agent-plugin-skills/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "agent-plugin-skills",
-  "version": "6.7.21",
+  "version": "6.7.22",
   "description": "Installable maintainer skills for skills-export repositories.",
   "author": {
     "name": "Gale",

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

diff --git a/plugins/agent-plugin-skills/uv.lock b/plugins/agent-plugin-skills/uv.lock
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": "6.7.21",
+  "version": "6.7.22",
   "description": "Apple development workflows for Codex, including SwiftUI architecture and DocC authoring guidance.",
   "author": {
     "name": "Gale",

diff --git a/plugins/apple-dev-skills/README.md b/plugins/apple-dev-skills/README.md
@@ -1,10 +1,12 @@
 # apple-dev-skills
 
-Apple, Swift, SwiftUI, Xcode, and DocC workflow skills for Codex.
+Apple, Swift, SwiftUI, Xcode, DocC, and `Dash.app` workflows for Codex.
 
 ![Codex plugin directory filtered to the Socket marketplace, showing Apple Dev Skills listed alongside companion plugins below a Productivity Skills suggestion.](./docs/media/codex-plugin-directory-socket-apple-dev-skills.png)
 
-The Socket marketplace is the easiest way to install Apple Dev Skills alongside the companion Productivity Skills workflows that Apple bootstrap and guidance-sync skills can use.
+Promo audio: [Apple Dev Skills Codex Workflows Promo](./docs/media/apple-dev-skills-codex-workflows-promo.mp3)
+
+The Socket marketplace is the easiest way to install Apple Dev Skills alongside the companion Productivity Skills workflows.
 
 ## Table of Contents
 
@@ -21,15 +23,17 @@ The Socket marketplace is the easiest way to install Apple Dev Skills alongside
 
 ### Status
 
-`apple-dev-skills` is active and usable as a Codex plugin.
+`apple-dev-skills` is maintained and supported by Gale as a key component of the Socket Marketplace.
 
 ### What This Project Is
 
-This repository is the canonical source of truth for Gale's Apple, Swift, and Xcode workflow skills. It gives agents focused workflows for reading Apple docs first, working with Swift and SwiftUI, using Xcode safely, building and testing Swift packages or Xcode projects, writing DocC, and keeping Apple repo guidance aligned.
+Apple development work has sharp edges around framework behavior, Xcode project state, documentation, accessibility, and build tooling. This plugin keeps helps agents move *swiftly* through a challenging landscape, instead of fumbling over mountains of implicit behavior.
+
+This repository is the canonical source of truth for Gale's Apple, Swift, and Xcode workflow skills.
 
 ### Motivation
 
-Apple development work has sharp edges around framework behavior, Xcode project state, documentation, accessibility, and build tooling. This plugin keeps those rules in one place so agents can move carefully without turning every Swift or Xcode task into guesswork.
+I wanted to build stuff faster, but agents were struggling with Swift, declarative frameworks, Xcode and `.pbxproj`, the `swift build` `xcodebuild` split, etc. I figured I could improve that a bit. it's gone pretty well, so far~
-Apple development work has sharp edges around framework behavior, Xcode project state, documentation, accessibility, and build tooling. This plugin keeps helps agents move *swiftly* through a challenging landscape, instead of fumbling over mountains of implicit behavior.
-
-This repository is the canonical source of truth for Gale's Apple, Swift, and Xcode workflow skills.
-
-### Motivation
-
-Apple development work has sharp edges around framework behavior, Xcode project state, documentation, accessibility, and build tooling. This plugin keeps those rules in one place so agents can move carefully without turning every Swift or Xcode task into guesswork.
-I wanted to build stuff faster, but agents were struggling with Swift, declarative frameworks, Xcode and `.pbxproj`, the `swift build` `xcodebuild` split, etc. I figured I could improve that a bit. it's gone pretty well, so far~
+Apple development work has sharp edges around framework behavior, Xcode project state, documentation, accessibility, and build tooling. This plugin helps agents move *swiftly* through a challenging landscape instead of fumbling over mountains of implicit behavior.
+
+This repository is the canonical source of truth for Gale's Apple, Swift, and Xcode workflow skills.
+
+### Motivation
+
+I wanted to build stuff faster, but agents were struggling with Swift, declarative frameworks, Xcode and `.pbxproj`, and the `swift build` vs `xcodebuild` split. I figured I could improve that a bit. It's gone pretty well so far.
-Apple development work has sharp edges around framework behavior, Xcode project state, documentation, accessibility, and build tooling. This plugin keeps helps agents move *swiftly* through a challenging landscape, instead of fumbling over mountains of implicit behavior.
-
-This repository is the canonical source of truth for Gale's Apple, Swift, and Xcode workflow skills.
-
-### Motivation
-
-Apple development work has sharp edges around framework behavior, Xcode project state, documentation, accessibility, and build tooling. This plugin keeps those rules in one place so agents can move carefully without turning every Swift or Xcode task into guesswork.
-I wanted to build stuff faster, but agents were struggling with Swift, declarative frameworks, Xcode and `.pbxproj`, the `swift build` `xcodebuild` split, etc. I figured I could improve that a bit. it's gone pretty well, so far~
+Apple development work has sharp edges around framework behavior, Xcode project state, documentation, accessibility, and build tooling. This plugin helps agents move *swiftly* through a challenging landscape instead of fumbling over mountains of implicit behavior.
+
+This repository is the canonical source of truth for Gale's Apple, Swift, and Xcode workflow skills.
+
+### Motivation
+
+I wanted to build stuff faster, but agents were struggling with Swift, declarative frameworks, Xcode and `.pbxproj`, and the `swift build` vs `xcodebuild` split. I figured I could improve that a bit. It's gone pretty well so far.
 
 ## Quick Start
 
@@ -39,14 +43,14 @@ The easiest way to install Apple Dev Skills with its companion workflows is thro
 codex plugin marketplace add gaelic-ghost/socket
 ```
 
+Restart Codex, open the plugin directory, choose `Socket`, and install or enable `apple-dev-skills`. Install `productivity-skills` from the same marketplace too if you want the Apple bootstrap and guidance-sync workflows.
+
 When the Socket marketplace changes, refresh it:
 
 ```bash
 codex plugin marketplace upgrade socket
 ```
 
-Restart Codex, open the plugin directory, choose `Socket`, and install or enable `apple-dev-skills`. Install `productivity-skills` from the same marketplace too if you want the Apple bootstrap and guidance-sync workflows.
-
 ## Usage
 
 Use Apple Dev Skills when an agent is helping with:

diff --git a/plugins/apple-dev-skills/docs/media/apple-dev-skills-codex-workflows-promo.mp3 b/plugins/apple-dev-skills/docs/media/apple-dev-skills-codex-workflows-promo.mp3
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 = "6.7.21"
+version = "6.7.22"
 description = "Maintainer tooling for the apple-dev-skills repository"
 requires-python = ">=3.9"
 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": "6.7.21",
+  "version": "6.7.22",
   "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 = "6.7.21"
+version = "6.7.22"
 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/dotnet-skills/.codex-plugin/plugin.json b/plugins/dotnet-skills/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "dotnet-skills",
-  "version": "6.7.21",
+  "version": "6.7.22",
   "description": "Standalone plugin repository for future .NET-focused Codex skills.",
   "author": {
     "name": "Gale",

diff --git a/plugins/productivity-skills/.codex-plugin/plugin.json b/plugins/productivity-skills/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "productivity-skills",
-  "version": "6.7.21",
+  "version": "6.7.22",
   "description": "Broadly useful productivity workflows for Codex.",
   "author": {
     "name": "Gale",

diff --git a/plugins/productivity-skills/pyproject.toml b/plugins/productivity-skills/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "productivity-skills-maintenance"
-version = "6.7.21"
+version = "6.7.22"
 description = "Maintainer-only Python tooling baseline for productivity-skills."
 requires-python = ">=3.11"
 dependencies = []

diff --git a/plugins/productivity-skills/uv.lock b/plugins/productivity-skills/uv.lock
diff --git a/plugins/python-skills/.codex-plugin/plugin.json b/plugins/python-skills/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "python-skills",
-  "version": "6.7.21",
+  "version": "6.7.22",
   "description": "Bundled Python-focused Codex skills for uv bootstrapping, FastAPI and FastMCP scaffolding, FastAPI/FastMCP integration, and pytest workflows.",
   "author": {
     "name": "Gale",

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

diff --git a/plugins/python-skills/uv.lock b/plugins/python-skills/uv.lock
diff --git a/plugins/rust-skills/.codex-plugin/plugin.json b/plugins/rust-skills/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "rust-skills",
-  "version": "6.7.21",
+  "version": "6.7.22",
   "description": "Standalone plugin repository for future Rust-focused Codex skills.",
   "author": {
     "name": "Gale",

diff --git a/plugins/spotify/.codex-plugin/plugin.json b/plugins/spotify/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "spotify",
-  "version": "6.7.21",
+  "version": "6.7.22",
   "description": "Placeholder plugin repository for future Spotify-focused Codex workflows.",
   "author": {
     "name": "Gale",

diff --git a/plugins/swiftasb-skills/.codex-plugin/plugin.json b/plugins/swiftasb-skills/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "swiftasb-skills",
-  "version": "6.7.21",
+  "version": "6.7.22",
   "description": "Codex skills for explaining SwiftASB and building SwiftUI, AppKit, and Swift package integrations on top of it.",
   "author": {
     "name": "Gale",

diff --git a/plugins/things-app/.codex-plugin/plugin.json b/plugins/things-app/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "things-app",
-  "version": "6.7.21",
+  "version": "6.7.22",
   "description": "Things.app skills and a bundled local MCP server for reminders, planning digests, and structured task workflows.",
   "author": {
     "name": "Gale",

diff --git a/plugins/things-app/mcp/pyproject.toml b/plugins/things-app/mcp/pyproject.toml
@@ -7,7 +7,7 @@ packages = ["app"]
 
 [project]
 name = "things-mcp"
-version = "6.7.21"
+version = "6.7.22"
 requires-python = ">=3.13"
 dependencies = [
     "fastmcp>=3.0.2",

diff --git a/plugins/things-app/mcp/uv.lock b/plugins/things-app/mcp/uv.lock
diff --git a/plugins/things-app/pyproject.toml b/plugins/things-app/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "things-app-maintenance"
-version = "6.7.21"
+version = "6.7.22"
 description = "Maintainer-only Python tooling baseline for things-app skills and plugin packaging."
 requires-python = ">=3.11"
 dependencies = []

diff --git a/plugins/things-app/uv.lock b/plugins/things-app/uv.lock
diff --git a/plugins/web-dev-skills/.codex-plugin/plugin.json b/plugins/web-dev-skills/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "web-dev-skills",
-  "version": "6.7.21",
+  "version": "6.7.22",
   "description": "Standalone plugin repository for future web-focused Codex skills.",
   "author": {
     "name": "Gale",

diff --git a/pyproject.toml b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "socket-maintenance"
-version = "6.7.21"
+version = "6.7.22"
 description = "Root uv tooling baseline for the socket superproject."
 requires-python = ">=3.11"
 dependencies = []

diff --git a/uv.lock b/uv.lock