Skip to content

docs: add promo audio and refresh marketplace readmes#50

Merged
gaelic-ghost merged 4 commits intomainfrom
docs/promo-audio-media
May 9, 2026
Merged

docs: add promo audio and refresh marketplace readmes#50
gaelic-ghost merged 4 commits intomainfrom
docs/promo-audio-media

Conversation

@gaelic-ghost
Copy link
Copy Markdown
Owner

@gaelic-ghost gaelic-ghost commented May 9, 2026

Summary

  • add Socket and Apple Dev Skills promo audio to their README files
  • refresh the Socket and Apple Dev Skills README intro copy
  • bump shared Socket version surfaces to 6.7.22

Verification

  • uv run scripts/validate_socket_metadata.py
  • bash .github/scripts/validate_repo_docs.sh

Summary by CodeRabbit

Release Notes - Version 6.7.22

  • Documentation
    • Refined Quick Start instructions with clearer steps, including explicit guidance on restarting Codex before installing plugins.
    • Updated Socket product description and support status information across documentation.
    • Enhanced catalog and plugin documentation with improved positioning language and installation clarity.

Review Change Stack

@gaelic-ghost gaelic-ghost added the documentation Improvements or additions to documentation label May 9, 2026
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 9, 2026

📝 Walkthrough

Walkthrough

This PR releases version 6.7.22 across the socket superproject and all nested plugins. Documentation is updated to clarify that socket is maintained by Gale and to refine installation guidance. All plugin manifests and project metadata are version-bumped for consistency.

Changes

Version Release 6.7.22 Coordination

Layer / File(s) Summary
Documentation Updates
README.md, plugins/apple-dev-skills/README.md
Root README clarifies socket maintenance by Gale, installation workflow, and licensing scope. Apple Dev Skills README adds promo audio link and rewrites Status, motivation, and Quick Start sections to direct users through socket marketplace setup.
Root Project Version
pyproject.toml
Root project version incremented to 6.7.22.
Apple Dev Skills Metadata
plugins/apple-dev-skills/.codex-plugin/plugin.json, plugins/apple-dev-skills/pyproject.toml
Apple Dev Skills plugin manifest and project version synced to 6.7.22.
Plugin Manifests
plugins/*/\.codex-plugin/plugin.json
All 10 plugin manifests bumped to 6.7.22: agent-plugin-skills, cardhop-app, dotnet-skills, productivity-skills, python-skills, rust-skills, spotify, swiftasb-skills, things-app, web-dev-skills.
Plugin Project Versions
plugins/*/pyproject.toml
All plugin project versions updated to 6.7.22: agent-plugin-skills, cardhop-app/mcp, productivity-skills, python-skills, things-app, things-app/mcp.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

  • gaelic-ghost/socket#48: Earlier version bump PR that modified similar plugin manifest and pyproject.toml files across the same plugins.

Poem

🐰 A hop through versions, neat and clean,
From 6.7.21 to 6.7.22 seen,
All plugins aligned, from core to spare,
Socket maintains its marketplace care!
~Codex Bunny 🎉

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately reflects the main changes: adding promo audio and refreshing READMEs, though it doesn't explicitly mention the version bump also included in the PR.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/promo-audio-media

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@plugins/apple-dev-skills/README.md`:
- Around line 30-36: Fix the user-facing copy in the README intro: replace the
incorrect phrase "keeps helps" with "helps" (so the sentence reads "This plugin
helps agents..."), capitalize the sentence-starting "it's" to "It's", and remove
the trailing tilde "~" from the final sentence; update the motivation paragraph
accordingly to ensure clean, grammatical text.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 3895c646-10a9-4fa8-b66e-fdb03a0f730f

📥 Commits

Reviewing files that changed from the base of the PR and between abd5b4e and 21bd1a1.

⛔ Files ignored due to path filters (10)
  • docs/media/socket-codex-marketplace-promo.mp3 is excluded by !**/*.mp3
  • plugins/agent-plugin-skills/uv.lock is excluded by !**/*.lock
  • plugins/apple-dev-skills/docs/media/apple-dev-skills-codex-workflows-promo.mp3 is excluded by !**/*.mp3
  • plugins/apple-dev-skills/uv.lock is excluded by !**/*.lock
  • plugins/cardhop-app/mcp/uv.lock is excluded by !**/*.lock
  • plugins/productivity-skills/uv.lock is excluded by !**/*.lock
  • plugins/python-skills/uv.lock is excluded by !**/*.lock
  • plugins/things-app/mcp/uv.lock is excluded by !**/*.lock
  • plugins/things-app/uv.lock is excluded by !**/*.lock
  • uv.lock is excluded by !**/*.lock
📒 Files selected for processing (21)
  • README.md
  • plugins/agent-plugin-skills/.codex-plugin/plugin.json
  • plugins/agent-plugin-skills/pyproject.toml
  • plugins/apple-dev-skills/.codex-plugin/plugin.json
  • plugins/apple-dev-skills/README.md
  • plugins/apple-dev-skills/pyproject.toml
  • plugins/cardhop-app/.codex-plugin/plugin.json
  • plugins/cardhop-app/mcp/pyproject.toml
  • plugins/dotnet-skills/.codex-plugin/plugin.json
  • plugins/productivity-skills/.codex-plugin/plugin.json
  • plugins/productivity-skills/pyproject.toml
  • plugins/python-skills/.codex-plugin/plugin.json
  • plugins/python-skills/pyproject.toml
  • plugins/rust-skills/.codex-plugin/plugin.json
  • plugins/spotify/.codex-plugin/plugin.json
  • plugins/swiftasb-skills/.codex-plugin/plugin.json
  • plugins/things-app/.codex-plugin/plugin.json
  • plugins/things-app/mcp/pyproject.toml
  • plugins/things-app/pyproject.toml
  • plugins/web-dev-skills/.codex-plugin/plugin.json
  • pyproject.toml

Comment on lines +30 to +36
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~
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Fix user-facing copy errors in the new intro/motivation text.

There are visible wording issues in the changed text ("keeps helps", lowercase sentence start in "it's", and trailing ~), which reduces README quality.

Proposed edit
-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.
+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.

-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~
+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.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
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.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/apple-dev-skills/README.md` around lines 30 - 36, Fix the user-facing
copy in the README intro: replace the incorrect phrase "keeps helps" with
"helps" (so the sentence reads "This plugin helps agents..."), capitalize the
sentence-starting "it's" to "It's", and remove the trailing tilde "~" from the
final sentence; update the motivation paragraph accordingly to ensure clean,
grammatical text.

@gaelic-ghost gaelic-ghost merged commit 84488c2 into main May 9, 2026
2 checks passed
@gaelic-ghost gaelic-ghost deleted the docs/promo-audio-media branch May 9, 2026 22:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant