apple-dev-skills

A curated catalog of skills for AI coding agents (Claude Code) — built and collected from one developer's own shipping experience. First-party Apple/Swift and AI-agent-collaboration skills, plus best-of-breed external skill plugins aggregated by reference (credited to their authors, never copied).

>

繁體中文：README.zh-Hant.md

This repo is one marketplace hosting two first-party plugins and several aggregated externals.

Install

Claude Code discovers shared skills through the plugin system. This repo is both a marketplace and the home of two first-party plugins.

A — marketplace (simplest)

/plugin marketplace add wei18/apple-dev-skills
/plugin install apple-dev-skills@apple-dev-skills          # 20 Apple/Swift skills
/plugin install collaboration-skills@apple-dev-skills      # 12 agent-collaboration skills

Install either or both. Externals install the same way, e.g. /plugin install swiftui-expert@apple-dev-skills.

B — repo-level (vendored submodule, pinned)

Vendor + pin into one repo, then register a project-scope local-path marketplace so the plugins load from the pinned submodule (collaborators are prompted to trust the workspace):

git submodule add https://github.com/wei18/apple-dev-skills.git .claude/skills/apple-dev-skills
cd .claude/skills/apple-dev-skills && git checkout v1.3.1 && cd -

.claude/settings.json (committed):

{
  "extraKnownMarketplaces": {
    "apple-dev-skills": { "source": { "source": "directory", "path": "./.claude/skills/apple-dev-skills" } }
  },
  "enabledPlugins": {
    "apple-dev-skills@apple-dev-skills": true,
    "collaboration-skills@apple-dev-skills": true
  }
}

A bare submodule alone is not discovered — the marketplace registration is what loads the skills.

C — npx skills (flat, no plugin)

npx skills add wei18/apple-dev-skills --list
npx skills add wei18/apple-dev-skills --skill swift6-concurrency

Catalog

apple-dev-skills (20) — Apple/Swift

collaboration-skills (12) — AI-agent process

Aggregated external (5) — by reference, credited

Listed here but not authored here; they install from their authors' own repos (you get their latest), credited in full. Aggregate, don't appropriate: only MIT-compatible, non-duplicate plugins are listed — first-party skills are written only for genuine gaps. The externals are broad reference ("here's the API / here's how to build X"); the first-party skills sit a layer below as opinionated defaults and shipped-it war stories (use iOS 18, one Package, swift-testing + snapshot, OSLog no-third-party, runtime bugs that slipped past review). Where a topic overlaps, they differ by altitude, not duplication.

Provenance

First-party skills were distilled and genericized from wei18/Sudoku's .claude/skills/ — a spec-first, AI-Leader/Developer-built portfolio of shipping Apple-platform games — plus original write-ups of public Apple / WCAG / Swift standards. Aggregated externals remain their authors' work, surfaced by reference only. MIT — see LICENSE.