{"id":45897374,"url":"https://github.com/gaelic-ghost/apple-dev-skills","last_synced_at":"2026-05-05T04:12:30.961Z","repository":{"id":341063277,"uuid":"1168735743","full_name":"gaelic-ghost/apple-dev-skills","owner":"gaelic-ghost","description":"Codex skills for Apple dev workflows: Xcode MCP-first execution, automatic xcodebuild/xcrun/SwiftPM fallback, swiftly+toolchain guidance, and Dash local-docset docs.","archived":false,"fork":false,"pushed_at":"2026-04-29T00:18:05.000Z","size":2001,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-29T01:02:15.229Z","etag":null,"topics":["agent-skills","apple-development","apple-docs","apple-docs-mcp","codex","codex-app","codex-cli","codex-skills","dash-docsets","ios","macos","swift","swift-package-manager","swift-toolchain","swiftly","swiftpm","xcode","xcode-mcp","xcodebuild","xcrun"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gaelic-ghost.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"gaelic-ghost","patreon":null,"open_collective":null,"ko_fi":"gaelicghost","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":null}},"created_at":"2026-02-27T18:30:41.000Z","updated_at":"2026-04-29T00:16:53.000Z","dependencies_parsed_at":"2026-04-29T01:00:47.441Z","dependency_job_id":null,"html_url":"https://github.com/gaelic-ghost/apple-dev-skills","commit_stats":null,"previous_names":["gaelic-ghost/apple-dev-skills"],"tags_count":71,"template":false,"template_full_name":null,"purl":"pkg:github/gaelic-ghost/apple-dev-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaelic-ghost%2Fapple-dev-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaelic-ghost%2Fapple-dev-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaelic-ghost%2Fapple-dev-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaelic-ghost%2Fapple-dev-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gaelic-ghost","download_url":"https://codeload.github.com/gaelic-ghost/apple-dev-skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gaelic-ghost%2Fapple-dev-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32634833,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-04T10:08:07.713Z","status":"online","status_checked_at":"2026-05-05T02:00:06.033Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","apple-development","apple-docs","apple-docs-mcp","codex","codex-app","codex-cli","codex-skills","dash-docsets","ios","macos","swift","swift-package-manager","swift-toolchain","swiftly","swiftpm","xcode","xcode-mcp","xcodebuild","xcrun"],"created_at":"2026-02-27T21:17:28.583Z","updated_at":"2026-05-05T04:12:30.956Z","avatar_url":"https://github.com/gaelic-ghost.png","language":"Python","funding_links":["https://github.com/sponsors/gaelic-ghost","https://ko-fi.com/gaelicghost"],"categories":[],"sub_categories":[],"readme":"# apple-dev-skills\n\nApple, Swift, and Xcode workflow skills for Codex and Claude Code.\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Quick Start](#quick-start)\n- [Usage](#usage)\n- [Development](#development)\n- [Repo Structure](#repo-structure)\n- [Active Skills](#active-skills)\n- [Release Notes](#release-notes)\n- [License](#license)\n\n## Overview\n\n### Status\n\nThis repository is active and available for maintainer use.\n\n### What This Project Is\n\nThis repository is the canonical source of truth for Gale's Apple, Swift, and Xcode workflow skills. Treat `productivity-skills` as the default baseline layer for general repo-doc and maintenance work, and use `apple-dev-skills` when Apple-specific assumptions should actively shape the workflow.\n\n### Motivation\n\nIt exists to keep Apple-platform workflow guidance in one dedicated repository with explicit requirements around Apple documentation, Xcode-safe workflows, and clear source-of-truth boundaries.\n\n## Quick Start\n\nThis repository is primarily the authored source tree for the shipped Apple workflow skills rather than an end-user app with a separate getting-started path. If you want to understand what the repo currently ships, start with [Active Skills](#active-skills) and [`docs/maintainers/workflow-atlas.md`](./docs/maintainers/workflow-atlas.md). If you want to modify the repository, go to [Development](#development) and use [`CONTRIBUTING.md`](./CONTRIBUTING.md) for the maintainer workflow.\n\n## Usage\n\nUse this repository's skills when the work is about:\n\n- Swift or SwiftUI implementation\n- Apple UI accessibility implementation or review\n- SwiftUI app structure, focus design, scene ownership, or command architecture\n- Xcode build, run, or test workflows\n- DocC symbol comments, articles, catalog structure, or DocC-oriented review\n- Swift source cleanup, file-header normalization, or source-organization policy\n- Swift package bootstrap or validation\n- Apple-project guidance sync\n- Apple-platform documentation routing\n\nWhen installed as a Codex plugin, this repository 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.\n\n### Codex Plugin Install\n\nThis repository can be installed on its own through Codex's Git-backed marketplace flow. The repo-local Codex marketplace lives at [`.agents/plugins/marketplace.json`](./.agents/plugins/marketplace.json), and its single plugin entry points at this repository root with `source.path` set to `./` because the root directory is also the plugin root.\n\nPrefer the official Git-backed install and update path:\n\n```bash\ncodex plugin marketplace add gaelic-ghost/apple-dev-skills\ncodex plugin marketplace upgrade apple-dev-skills\n```\n\nAfter Codex adds or upgrades the marketplace, restart Codex, open the plugin directory in the Codex GUI, choose the `Apple Dev Skills` marketplace, and install or enable `apple-dev-skills` there. Manual local clone marketplaces and personal copied-payload entries are development, unpublished-testing, and fallback paths rather than the default user install story.\n\n### Companion Plugin Requirements\n\nMost Apple Dev Skills workflows are useful as a standalone plugin. The bootstrap and repo-guidance sync workflows that install or refresh `scripts/repo-maintenance/` also need the companion [`productivity-skills`](https://github.com/gaelic-ghost/productivity-skills) plugin installed alongside this plugin, because `productivity-skills` owns the reusable `maintain-project-repo` implementation while Apple Dev Skills chooses the Apple-specific `swift-package` or `xcode-app` profile.\n\nIf an agent has only `apple-dev-skills` installed, it can still use the documentation lookup, SwiftUI architecture, Xcode build/run/test, DocC, formatting, source-structure, and accessibility workflows. It should install `productivity-skills` before running `bootstrap-swift-package`, `bootstrap-xcode-app-project`, `sync-swift-package-guidance`, or `sync-xcode-project-guidance` in mutating mode.\n\nThe [`socket`](https://github.com/gaelic-ghost/socket) repository is Gale's plugin superproject and marketplace catalog. Installing from the Git-backed socket marketplace is useful when you want Apple Dev Skills plus Gale's other Codex plugins available from one marketplace instead of wiring each plugin one by one:\n\n```bash\ncodex plugin marketplace add gaelic-ghost/socket\ncodex plugin marketplace upgrade socket\n```\n\nAfter adding `socket`, restart Codex, open the plugin directory in the Codex GUI, choose the `Socket` marketplace, and install or enable `apple-dev-skills` plus any companion plugins you want. Standalone Git-backed installs from this repository remain supported for Apple-only workflows that do not call `maintain-project-repo`. Use an explicit ref such as `gaelic-ghost/apple-dev-skills@vX.Y.Z` only when you want a pinned reproducible install rather than the release-aligned default branch.\n\nUse [`CONTRIBUTING.md`](./CONTRIBUTING.md) for maintainer workflow details, and use [`ROADMAP.md`](./ROADMAP.md) for planned and completed milestone-level work.\n\n## Development\n\n### Setup\n\nSync the maintainer environment before editing skills, tests, or maintainer docs:\n\n```bash\nuv sync --dev\n```\n\n### Workflow\n\nTreat root [`skills/`](./skills/) as the canonical authored surface. Keep shared reusable assets in [`shared/`](./shared/), maintainer docs in [`docs/`](./docs/), and install metadata in [`.codex-plugin/plugin.json`](./.codex-plugin/plugin.json), [`.mcp.json`](./.mcp.json), [`.agents/plugins/marketplace.json`](./.agents/plugins/marketplace.json), and [`.claude-plugin/marketplace.json`](./.claude-plugin/marketplace.json).\n\nKeep the repo honest about its Apple docs-first policy. When a skill changes, update the relevant tests and maintainer guidance in the same pass rather than letting the packaging or guidance drift. Use [`CONTRIBUTING.md`](./CONTRIBUTING.md) for the normal contributor workflow and review expectations.\n\n### Validation\n\nRun the repository test suite for skill and metadata changes:\n\n```bash\nbash .github/scripts/validate_repo_docs.sh\nuv run pytest\n```\n\n## Repo Structure\n\n```text\n.\n├── .codex-plugin/\n├── .claude-plugin/\n├── .mcp.json\n├── AGENTS.md\n├── CONTRIBUTING.md\n├── README.md\n├── ROADMAP.md\n├── docs/maintainers/\n├── shared/\n├── skills/\n└── tests/\n```\n\n## Active Skills\n\n- `bootstrap-swift-package`\n- `bootstrap-xcode-app-project`\n- `author-swift-docc-docs`\n- `explore-apple-swift-docs`\n- `apple-ui-accessibility-workflow`\n- `format-swift-sources`\n- `structure-swift-sources`\n- `swiftui-app-architecture-workflow`\n- `swift-package-build-run-workflow`\n- `swift-package-testing-workflow`\n- `swift-package-workflow`\n- `sync-swift-package-guidance`\n- `sync-xcode-project-guidance`\n- `xcode-app-project-workflow`\n- `xcode-build-run-workflow`\n- `xcode-testing-workflow`\n\n## Release Notes\n\nUse Git history and GitHub releases to track shipped changes for this repository.\n\n## License\n\nSee [LICENSE](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgaelic-ghost%2Fapple-dev-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgaelic-ghost%2Fapple-dev-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgaelic-ghost%2Fapple-dev-skills/lists"}