apple-dev-skills

Apple, Swift, SwiftUI, Safari, Xcode, DocC, and Dash.app workflows for Codex.

Promo audio: Apple Dev Skills Codex Workflows Promo

The Socket marketplace is the easiest way to install Apple Dev Skills alongside the companion Productivity Skills workflows.

Table of Contents

• Overview
• Quick Start
• Usage
• Development
• Repo Structure
• Active Skills
• Release Notes
• License

Overview

Status

apple-dev-skills is maintained and supported by Gale as a key component of the Socket Marketplace.

What This Project Is

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

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~

Quick Start

The easiest way to install Apple Dev Skills with its companion workflows is through Gale's Socket marketplace:

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:

codex plugin marketplace upgrade socket

Usage

Use Apple Dev Skills when an agent is helping with:

• Swift and SwiftUI implementation
• Xcode build, run, test, and project workflows
• Safari extension and SafariServices integration choices
• Swift package bootstrap, build, and testing
• Apple UI accessibility work
• DocC comments, articles, and documentation catalogs
• Swift source formatting and file organization
• Apple docs lookup before design or code changes
• Apple-specific repo guidance setup or refresh

Most Apple Dev Skills workflows are useful as a standalone plugin. Bootstrap and guidance-sync workflows also need productivity-skills, because that companion plugin owns the reusable repo-maintenance workflow that Apple Dev Skills applies to Swift packages and Xcode apps.

Treat productivity-skills as the default baseline layer for general repo-doc and maintenance work, and use Apple Dev Skills when Apple-specific behavior should shape the workflow.

The socket repository is Gale's plugin superproject and marketplace catalog.

If you only want the Apple plugin without the rest of Socket, the standalone marketplace remains supported:

codex plugin marketplace add gaelic-ghost/apple-dev-skills
codex plugin marketplace upgrade apple-dev-skills

When installed as a Codex plugin, Apple Dev Skills also registers Xcode's built-in MCP bridge through xcrun mcpbridge. Users still need to allow external agents in Xcode's Intelligence settings and keep the relevant project open in Xcode before external Codex sessions can use Xcode-provided tools.

Development

Treat root skills/ as the canonical authored surface. Keep shared reusable assets in shared/ and tests in tests/.

Use CONTRIBUTING.md for maintainer workflow details, and use AGENTS.md for agent-facing repo rules.

Run the repository test suite for skill and metadata changes:

bash .github/scripts/validate_repo_docs.sh
uv run pytest

Repo Structure

.
├── .codex-plugin/
├── .mcp.json
├── docs/
├── shared/
├── skills/
├── tests/
├── AGENTS.md
├── CONTRIBUTING.md
├── README.md
└── ROADMAP.md

Active Skills

• apple-ui-accessibility-workflow
• author-swift-docc-docs
• bootstrap-swift-package
• bootstrap-xcode-app-project
• explore-apple-swift-docs
• format-swift-sources
• safari-extension-control-workflow
• structure-swift-sources
• swift-package-build-run-workflow
• swift-package-testing-workflow
• swift-package-workflow
• swiftui-app-architecture-workflow
• sync-swift-package-guidance
• sync-xcode-project-guidance
• xcode-app-project-workflow
• xcode-build-run-workflow
• xcode-testing-workflow

Release Notes

Use GitHub releases and Git history to track shipped changes for this repository.

License

This repository is licensed under Apache 2.0. See LICENSE.