mcpField
A
apple-swift

apple-swift

github.com/fandhe-aiDevelopment466 installsUpdated 1d ago
Repository

About apple-swift

A reference skill for Swift developers, organizing official documentation across the Standard Library, concurrency, protocols and generics, and Observation. It directs tasks to category indexes and then to detailed API pages.

Key features

  1. 01Standard Library API references
  2. 02Concurrency API references
  3. 03Protocols and generics references
  4. 04Observation API references
  5. 05Task-to-category navigation

Use cases

  1. 01Checking Swift collection or type APIs
  2. 02Looking up async and actor APIs
  3. 03Implementing generic protocols
  4. 04Tracking observable state changes

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/fandhe-ai/agent-reference-skills --skill apple-swift

After installing, type/apple-swiftin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/concurrency/
actor.md
asyncsequence.md
asyncstream.md
asyncthrowingstream.md
checkedcontinuation.md
clock.md
continuation.md
continuousclock.md
discardingtaskgroup.md
duration.md
executor.md
executorjob.md
globalactor.md
globalconcurrentexecutor.md
instantprotocol.md
jobpriority.md
mainactor.md
README.md
sendable.md
serialexecutor.md
suspendingclock.md
task.md
taskexecutor.md
taskgroup.md
tasklocal.md
taskpriority.md
throwingdiscardingtaskgroup.md
throwingtaskgroup.md
unownedjob.md
unownedserialexecutor.md

Details

From the project README

Apple Swift リファレンス

Swift 公式ドキュメントの Standard Library・Concurrency・プロトコル/ジェネリクス・Observation を網羅したスキル。 ユーザーのタスクに応じて適切な README.md を読み、そこから個別ファイルへ辿ること。

Source: developer.apple.com JSON (fetched 2026-10-16, iOS/macOS 27.0 SDK, Swift 6.4 era). Availability values are the introducedAt of each JSON, written as-is. Supplementary design docs: swift-evolution pinned at commit f006bf3cf2594bdd4a972f9126f93bd1743ed524 (https://github.com/swiftlang/swift-evolution/tree/f006bf3cf2594bdd4a972f9126f93bd1743ed524, no release tags). Used only for usage examples and status, never as the source of signatures.

ディレクトリ構成

skills/apple-swift/
  SKILL.md
  references/
    standard-library/
      README.md
      int.md
      double.md
      float.md
      bool.md
      string.md
      character.md
      substring.md
      unicode.md
      array.md
      dictionary.md
      set.md
      range.md
      contiguous-array.md
      optional.md
      result.md
      keypath.md
      span.md
      mutablespan.md
      rawspan.md
      mutablerawspan.md
      outputspan.md
      utf8span.md
      inlinearray.md
      rangeset.md
      discontiguousslice.md
    concurrency/
      README.md
      task.md
      taskgroup.md
      throwingtaskgroup.md
      withtaskgroup.md
      withthrowingtaskgroup.md
      taskpriority.md
      tasklocal.md
      actor.md
      mainactor.md
      globalactor.md
      sendable.md
      asyncsequence.md
      asyncstream.md
      asyncthrowingstream.md
      checkedcontinuation.md
      withcheckedcontinuation.md
      discardingtaskgroup.md
      throwingdiscardingtaskgroup.md
      withdiscardingtaskgroup.md
      withthrowingdiscardingtaskgroup.md
      clock.md
      duration.md
      instantprotocol.md
      continuousclock.md
      suspendingclock.md
      taskexecutor.md
      continuation.md
      withcontinuation.md
      unsafecontinuation.md
      withunsafecontinuation.md
      unsafecurrenttask.md
      executor.md
      serialexecutor.md
      executorjob.md
      unownedjob.md
      jobpriority.md
      unownedserialexecutor.md
      unownedtaskexecutor.md
      globalconcurrentexecutor.md
      withtaskexecutorpreference.md
    protocols-generics/
      README.md
      equatable.md
      hashable.md
      comparable.md
      identifiable.md
      codable.md
      encodable.md
      decodable.md
      caseiterable.md
      rawrepresentable.md
      sequence.md
      collection.md
      iteratorprotocol.md
      customstringconvertible.md
      error.md
      expressiblebyliteral.md
      generics.md
      some-any-opaque-types.md
    observation/
      README.md
      observable-protocol.md
      observable-macro.md
      observationignored.md
      observationtracked.md
      observationregistrar.md
      withobservationtracking.md
      observations.md
      observationtracking.md
      withcontinuousobservation.md
      withobservationtracking-options.md

探索手順

タスクからカテゴリを引き、カテゴリの README.md で目的のページを特定する:

  1. 下記マッピング表でタスクに対応するカテゴリを探す
  2. そのカテゴリの references/{category}/README.md を参照して目的のページを特定する
  3. 該当ページの .md を Read して詳細を確認する

タスク → カテゴリ マッピング

タスクカテゴリ参照 README
Int / Double / Float / Bool の数値型を使いたいstandard-libraryreferences/standard-library/README.md
String / Character / Substring / Unicode を扱いたいstandard-libraryreferences/standard-library/README.md
Array / Dictionary / Set / Range / ContiguousArray を使いたいstandard-libraryreferences/standard-library/README.md
Optional / Result / KeyPath の API を確認したいstandard-libraryreferences/standard-library/README.md
async / await / Task で非同期処理を書きたいconcurrencyreferences/concurrency/README.md
actor / MainActor / GlobalActor でデータ競合を防ぎたいconcurrencyreferences/concurrency/README.md
TaskGroup / withTaskGroup で並列処理を構造化したいconcurrencyreferences/concurrency/README.md
AsyncSequence / AsyncStream / for await in を使いたいconcurrencyreferences/concurrency/README.md
Sendable 準拠・コールバック API を async に橋渡ししたいconcurrencyreferences/concurrency/README.md
TaskLocal / TaskPriority を使いたいconcurrencyreferences/concurrency/README.md
DiscardingTaskGroup / withDiscardingTaskGroup で結果を破棄する子タスクを構造化したいconcurrencyreferences/concurrency/README.md
Clock / Duration / InstantProtocol / ContinuousClock / SuspendingClock で時間計測・スリープを扱いたいconcurrencyreferences/concurrency/README.md
TaskExecutor でタスクの実行先を指定したいconcurrencyreferences/concurrency/README.md
Continuation (noncopyable) / UnsafeContinuation / withContinuation でコールバック API を橋渡ししたいconcurrencyreferences/concurrency/README.md
Executor / SerialExecutor / ExecutorJob / withTaskExecutorPreference でカスタム executor を使いたいconcurrencyreferences/concurrency/README.md
UnsafeCurrentTask / タスクキャンセルのシールド / 優先度エスカレーション (JobPriority) を扱いたいconcurrencyreferences/concurrency/README.md
Span / MutableSpan / RawSpan / OutputSpan / UTF8Span で連続メモリへ安全にアクセスしたいstandard-libraryreferences/standard-library/README.md
InlineArray / RangeSet / DiscontiguousSlice を使いたいstandard-libraryreferences/standard-library/README.md
Equatable / Hashable / Comparable を型に準拠させたいprotocols-genericsreferences/protocols-generics/README.md
Codable / Encodable / Decodable で JSON シリアライズしたいprotocols-genericsreferences/protocols-generics/README.md
Identifiable / CaseIterable / RawRepresentable を使いたいprotocols-genericsreferences/protocols-generics/README.md
Sequence / Collection / IteratorProtocol を実装したいprotocols-genericsreferences/protocols-generics/README.md
ジェネリクス関数・型・associatedtype・where 句を書きたいprotocols-genericsreferences/protocols-generics/README.md
some / any opaque types・existential を使いたいprotocols-genericsreferences/protocols-generics/README.md
Error プロトコルでカスタムエラーを定義したいprotocols-genericsreferences/protocols-generics/README.md
@Observable マクロで SwiftUI / UIKit と状態を連携したいobservationreferences/observation/README.md
Observable プロトコルを手動で準拠したいobservationreferences/observation/README.md
@ObservationIgnored で追跡対象外プロパティを設定したいobservationreferences/observation/README.md
withObservationTracking で変更通知を受け取りたいobservationreferences/observation/README.md
Observations / withContinuousObservation で継続的な変更を async sequence として観測したいobservationreferences/observation/README.md

Comments

Markdown supported