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
- 01Standard Library API references
- 02Concurrency API references
- 03Protocols and generics references
- 04Observation API references
- 05Task-to-category navigation
Use cases
- 01Checking Swift collection or type APIs
- 02Looking up async and actor APIs
- 03Implementing generic protocols
- 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-swiftAfter installing, type/apple-swiftin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/concurrency/actor.mdasyncsequence.mdasyncstream.mdasyncthrowingstream.mdcheckedcontinuation.mdclock.mdcontinuation.mdcontinuousclock.mddiscardingtaskgroup.mdduration.mdexecutor.mdexecutorjob.mdglobalactor.mdglobalconcurrentexecutor.mdinstantprotocol.mdjobpriority.mdmainactor.mdREADME.mdsendable.mdserialexecutor.mdsuspendingclock.mdtask.mdtaskexecutor.mdtaskgroup.mdtasklocal.mdtaskpriority.mdthrowingdiscardingtaskgroup.mdthrowingtaskgroup.mdunownedjob.mdunownedserialexecutor.mdDetails
From the project READMEApple 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 で目的のページを特定する:
- 下記マッピング表でタスクに対応するカテゴリを探す
- そのカテゴリの
references/{category}/README.mdを参照して目的のページを特定する - 該当ページの
.mdを Read して詳細を確認する
タスク → カテゴリ マッピング
| タスク | カテゴリ | 参照 README |
|---|---|---|
| Int / Double / Float / Bool の数値型を使いたい | standard-library | references/standard-library/README.md |
| String / Character / Substring / Unicode を扱いたい | standard-library | references/standard-library/README.md |
| Array / Dictionary / Set / Range / ContiguousArray を使いたい | standard-library | references/standard-library/README.md |
| Optional / Result / KeyPath の API を確認したい | standard-library | references/standard-library/README.md |
| async / await / Task で非同期処理を書きたい | concurrency | references/concurrency/README.md |
| actor / MainActor / GlobalActor でデータ競合を防ぎたい | concurrency | references/concurrency/README.md |
| TaskGroup / withTaskGroup で並列処理を構造化したい | concurrency | references/concurrency/README.md |
| AsyncSequence / AsyncStream / for await in を使いたい | concurrency | references/concurrency/README.md |
| Sendable 準拠・コールバック API を async に橋渡ししたい | concurrency | references/concurrency/README.md |
| TaskLocal / TaskPriority を使いたい | concurrency | references/concurrency/README.md |
| DiscardingTaskGroup / withDiscardingTaskGroup で結果を破棄する子タスクを構造化したい | concurrency | references/concurrency/README.md |
| Clock / Duration / InstantProtocol / ContinuousClock / SuspendingClock で時間計測・スリープを扱いたい | concurrency | references/concurrency/README.md |
| TaskExecutor でタスクの実行先を指定したい | concurrency | references/concurrency/README.md |
| Continuation (noncopyable) / UnsafeContinuation / withContinuation でコールバック API を橋渡ししたい | concurrency | references/concurrency/README.md |
| Executor / SerialExecutor / ExecutorJob / withTaskExecutorPreference でカスタム executor を使いたい | concurrency | references/concurrency/README.md |
| UnsafeCurrentTask / タスクキャンセルのシールド / 優先度エスカレーション (JobPriority) を扱いたい | concurrency | references/concurrency/README.md |
| Span / MutableSpan / RawSpan / OutputSpan / UTF8Span で連続メモリへ安全にアクセスしたい | standard-library | references/standard-library/README.md |
| InlineArray / RangeSet / DiscontiguousSlice を使いたい | standard-library | references/standard-library/README.md |
| Equatable / Hashable / Comparable を型に準拠させたい | protocols-generics | references/protocols-generics/README.md |
| Codable / Encodable / Decodable で JSON シリアライズしたい | protocols-generics | references/protocols-generics/README.md |
| Identifiable / CaseIterable / RawRepresentable を使いたい | protocols-generics | references/protocols-generics/README.md |
| Sequence / Collection / IteratorProtocol を実装したい | protocols-generics | references/protocols-generics/README.md |
| ジェネリクス関数・型・associatedtype・where 句を書きたい | protocols-generics | references/protocols-generics/README.md |
| some / any opaque types・existential を使いたい | protocols-generics | references/protocols-generics/README.md |
| Error プロトコルでカスタムエラーを定義したい | protocols-generics | references/protocols-generics/README.md |
| @Observable マクロで SwiftUI / UIKit と状態を連携したい | observation | references/observation/README.md |
| Observable プロトコルを手動で準拠したい | observation | references/observation/README.md |
| @ObservationIgnored で追跡対象外プロパティを設定したい | observation | references/observation/README.md |
| withObservationTracking で変更通知を受け取りたい | observation | references/observation/README.md |
| Observations / withContinuousObservation で継続的な変更を async sequence として観測したい | observation | references/observation/README.md |