apple-dev-skills

apple-dev-skills

A curated catalog of Swift / Apple-platform skills for AI coding agents (Claude Code). It ships original first-party skills for one project's hard-won patterns and for public-standard topics, plus aggregated best-of-breed external skill plugins referenced from their original repos and credited to their authors — not copied.

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

The repo is two things at once:

• A Claude Code plugin (apple-dev-skills) — 30 first-party SKILL.md files under skills/, namespaced apple-dev-skills:<skill>. These were distilled from a real shipping project's own experience and from public Apple / WCAG / Swift documentation.
• A marketplace catalog that also lists best-of-breed external skill plugins. Those install from their authors' repos (full attribution); nothing here is a copy or re-implementation of someone else's skill.

This README is the single source of truth (SSOT) for the library.

---

Roadmap (agenda)

Phase	What	Status
1 — Extract	Pull one project's portable skills out, genericize, ship as a submodule-consumable plugin	✅ done
2 — Standalone library	README as SSOT · an npx skills add install path · a marketplace catalog that can aggregate other repos (mechanism in claude-skill-plugin-packaging)	✅ done
3 — Curate & aggregate	Surveyed high-star Swift/Apple skill repos and aggregated the best-of-breed MIT plugins by reference (credited to their authors — see below), rather than re-implementing them. First-party skills were written only for genuine gaps with no aggregatable plugin (accessibility, dependency injection, performance). Decisions: CURATION.md	✅ done

Detailed status, spec→impl alignment, and future phases: ROADMAP.md.

---

Install

Claude Code discovers shared skills through the plugin system, not by a bare folder under .claude/skills/. This repo is both a plugin and a marketplace.

Option A — marketplace (simplest)

/plugin marketplace add wei18/apple-dev-skills
/plugin install apple-dev-skills@apple-dev-skills

Our skills load as apple-dev-skills:<skill-name>. The same marketplace also offers the aggregated external plugins — install any of them from their authors' repos, e.g. /plugin install swiftui-expert@apple-dev-skills.

Option B — vendored submodule, pinned per repo

Vendor the first-party plugin into one repo and pin its version, then register it as a local-path marketplace at project scope so it loads from the pinned submodule:

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

Then commit this to the repo's .claude/settings.json (collaborators are prompted to trust the workspace, after which it auto-registers):

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

A bare git submodule add alone will not surface the skills — the marketplace registration above is what makes Claude Code load them.

Option C — npx skills (flat skills, no plugin)

Copy chosen first-party SKILL.md files into your agent's skills directory with the open skills CLI, flat and un-namespaced:

npx skills add wei18/apple-dev-skills --list                       # browse the full index
npx skills add wei18/apple-dev-skills --skill swift6-concurrency   # one skill
npx skills add wei18/apple-dev-skills --all -a claude-code         # everything

---

First-party skill index (30)

Platform defaults (10)