Individual skill
agent-squad-swift
Use when building or modifying a Swift app that uses the AgentSquad Swift framework — on-device multi-agent orchestration for iOS 16+ / macOS 14+: orchestrator, agents (Agent, GroundedAgent), classifier routing, LLM clients (OpenAI-compatible), tools (native + MCP), tool UIs/widgets, on-device storage, tracing, and realtime voice — built-in types and custom implementations.
swift/SKILL.md
Source commit 729d5f52869c8280f599a9fa5cf27fc1df445602
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- Yes
- Observed behavior
- Network or broad shell
- Last checked
- Nov 2, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 7,800
- Repository last updated
- Oct 8, 2026
- License
- Apache-2.0
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- aws Repository topic
- aws-bedrock Repository topic
- anthropic-claude Repository topic
- aws-cdk Repository topic
- aws-lambda Repository topic
- chatbot Repository topic
- generative-ai Repository topic
- machine-learning Repository topic
- openai Repository topic
- serverless Repository topic
- engineering Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
.gitignoreasset · 206 bytesREADME.mddoc · 17,748 bytesSKILL.mdcore · 13,969 bytesSources/AgentSquad/Agents/Agent.swiftasset · 9,532 bytesSources/AgentSquad/Agents/GroundedAgent.swiftasset · 6,741 bytesSources/AgentSquad/Core/AgentProtocol.swiftasset · 2,719 bytesSources/AgentSquad/Core/Classifier/Classifier.swiftasset · 1,481 bytesSources/AgentSquad/Core/Classifier/LLMClassifier.swiftasset · 6,741 bytesSources/AgentSquad/Core/JSONValue.swiftasset · 5,190 bytesSources/AgentSquad/Core/LLM/ChatCompletionsClient.swiftasset · 7,784 bytesSources/AgentSquad/Core/LLM/ChatCompletionsTransport.swiftasset · 1,833 bytesSources/AgentSquad/Core/LLM/ChatCompletionsWire.swiftasset · 6,556 bytesSources/AgentSquad/Core/LLMClient.swiftasset · 1,870 bytesSources/AgentSquad/Core/Message.swiftasset · 1,731 bytesSources/AgentSquad/Core/Presenter/Grounding.swiftasset · 1,546 bytesSources/AgentSquad/Core/Presenter/PresenterPrompt.swiftasset · 1,674 bytesSources/AgentSquad/Core/Presenter/ToolOutputCurator.swiftasset · 3,742 bytesSources/AgentSquad/Core/Slugify.swiftasset · 390 bytesSources/AgentSquad/Core/Storage/ChatStorage.swiftasset · 3,279 bytesSources/AgentSquad/Core/Tooling/AgentTool.swiftasset · 1,630 bytesSources/AgentSquad/Core/Tooling/AggregateToolProvider.swiftasset · 2,890 bytesSources/AgentSquad/Core/Tooling/CapturingToolProvider.swiftasset · 777 bytesSources/AgentSquad/Core/Tooling/HTTPToolGroup.swiftasset · 8,396 bytesSources/AgentSquad/Core/Tooling/HTTPToolSpec.swiftasset · 14,674 bytesSources/AgentSquad/Core/Tooling/Tool.swiftasset · 1,415 bytesSources/AgentSquad/Core/Tooling/ToolKit.swiftasset · 1,393 bytesSources/AgentSquad/Core/Tooling/ToolParameter.swiftasset · 3,201 bytesSources/AgentSquad/Core/Tooling/ToolProvider.swiftasset · 2,093 bytesSources/AgentSquad/Core/Tracing/BatchSpanProcessor.swiftasset · 7,704 bytesSources/AgentSquad/Core/Tracing/OSLogTracer.swiftasset · 2,791 bytesSources/AgentSquad/Core/Tracing/OTLP/OTLPExporter.swiftasset · 2,865 bytesSources/AgentSquad/Core/Tracing/OTLP/OTLPModel.swiftasset · 8,622 bytesSources/AgentSquad/Core/Tracing/ProcessingTracer.swiftasset · 3,894 bytesSources/AgentSquad/Core/Tracing/Redaction.swiftasset · 2,775 bytesSources/AgentSquad/Core/Tracing/TraceEvent.swiftasset · 2,899 bytesSources/AgentSquad/Core/Tracing/Tracing.swiftasset · 6,854 bytesSources/AgentSquad/Core/UIPayload.swiftasset · 2,688 bytesSources/AgentSquad/Core/Version.swiftasset · 228 bytesSources/AgentSquad/Orchestrator.swiftasset · 6,005 bytesSources/AgentSquad/Retrieval/DakeraRetriever.swiftasset · 11,109 bytesSources/AgentSquad/Runtimes/Realtime/AudioIO.swiftasset · 1,552 bytesSources/AgentSquad/Runtimes/Realtime/AudioTruncation.swiftasset · 2,286 bytesSources/AgentSquad/Runtimes/Realtime/OpenAIGroundedVoiceAssistant.swiftasset · 20,716 bytesSources/AgentSquad/Runtimes/Realtime/OpenAIRealtimeSession.swiftasset · 11,601 bytesSources/AgentSquad/Runtimes/Realtime/OpenAIVoiceAssistant.swiftasset · 18,131 bytesSources/AgentSquad/Runtimes/Realtime/RealtimeRuntime.swiftasset · 5,005 bytesSources/AgentSquad/Runtimes/Realtime/RealtimeSessionError.swiftasset · 1,518 bytesSources/AgentSquad/Runtimes/Realtime/RealtimeTransport.swiftasset · 1,392 bytesSources/AgentSquad/Runtimes/Realtime/RealtimeWire.swiftasset · 21,256 bytesSources/AgentSquad/Runtimes/Realtime/URLSessionWebSocketTransport.swiftasset · 3,687 bytesSources/AgentSquad/Runtimes/Realtime/VoiceAssistant.swiftasset · 6,393 bytesSources/AgentSquad/Storage/DeviceChatStorage.swiftasset · 9,561 bytesSources/AgentSquad/Storage/FileChatStorage.swiftasset · 5,554 bytesSources/AgentSquad/Storage/InMemoryChatStorage.swiftasset · 2,597 bytesSources/AgentSquad/Storage/SummarizingChatStorage.swiftasset · 6,178 bytesSources/AgentSquad/Storage/TransformingChatStorage.swiftasset · 3,616 bytesSources/AgentSquadAudio/AudioConfiguration.swiftasset · 2,020 bytesSources/AgentSquadAudio/AudioPlayback.swiftasset · 4,617 bytesSources/AgentSquadAudio/MicCapture.swiftasset · 6,249 bytesSources/AgentSquadAudio/PCM16.swiftasset · 2,499 bytesSources/AgentSquadAudio/PlaybackClock.swiftasset · 2,753 bytesSources/AgentSquadAudio/VoiceAudioSession.swiftasset · 838 bytesSources/AgentSquadAudio/VoiceProcessedAudioIO.swiftasset · 8,200 bytesSources/AgentSquadMCP/Bridging.swiftasset · 4,039 bytesSources/AgentSquadMCP/MCPClient.swiftasset · 2,958 bytesSources/AgentSquadMCP/MCPToolProvider+SDK.swiftasset · 2,698 bytesSources/AgentSquadMCP/MCPToolProvider.swiftasset · 8,052 bytesSources/AgentSquadMCP/SDKMCPClient.swiftasset · 6,060 bytesTests/AgentSquadAudioTests/AudioIOSmokeTests.swiftasset · 7,197 bytesTests/AgentSquadMCPTests/BridgingTests.swiftasset · 2,914 bytesTests/AgentSquadMCPTests/MCPToolProviderTests.swiftasset · 18,687 bytesTests/AgentSquadTests/AgentContractsTests.swiftasset · 2,223 bytesTests/AgentSquadTests/AgentTests.swiftasset · 8,975 bytesTests/AgentSquadTests/AggregateToolProviderTests.swiftasset · 4,078 bytesTests/AgentSquadTests/ChatCompletionsClientTests.swiftasset · 14,143 bytesTests/AgentSquadTests/ChatStorageTests.swiftasset · 2,794 bytesTests/AgentSquadTests/ClassifierTests.swiftasset · 2,081 bytesTests/AgentSquadTests/DakeraRetrieverTests.swiftasset · 7,714 bytesTests/AgentSquadTests/DeviceChatStorageTests.swiftasset · 5,742 bytesTests/AgentSquadTests/FileChatStorageTests.swiftasset · 8,523 bytesTests/AgentSquadTests/GroundedAgentTests.swiftasset · 15,703 bytesTests/AgentSquadTests/GroundedComponentContractsTests.swiftasset · 6,534 bytesTests/AgentSquadTests/HTTPToolTests.swiftasset · 7,821 bytesTests/AgentSquadTests/InMemoryChatStorageTests.swiftasset · 5,272 bytesTests/AgentSquadTests/JSONValueTests.swiftasset · 3,539 bytesTests/AgentSquadTests/LLMClassifierTests.swiftasset · 10,440 bytesTests/AgentSquadTests/MessageTests.swiftasset · 2,486 bytesTests/AgentSquadTests/MockLLMClient.swiftasset · 1,226 bytesTests/AgentSquadTests/OSLogTracerTests.swiftasset · 1,159 bytesTests/AgentSquadTests/OTLPExporterTests.swiftasset · 15,936 bytesTests/AgentSquadTests/OpenAIGroundedVoiceAssistantTests.swiftasset · 35,652 bytesTests/AgentSquadTests/OpenAIVoiceAssistantTests.swiftasset · 36,777 bytesTests/AgentSquadTests/OrchestratorTests.swiftasset · 11,954 bytesTests/AgentSquadTests/ProcessingTracerTests.swiftasset · 21,345 bytesTests/AgentSquadTests/RealtimeRuntimeTests.swiftasset · 9,811 bytesTests/AgentSquadTests/RealtimeTestSupport.swiftasset · 13,955 bytesTests/AgentSquadTests/RealtimeWireTests.swiftasset · 17,942 bytesTests/AgentSquadTests/SummarizingChatStorageTests.swiftasset · 12,450 bytesTests/AgentSquadTests/TestSupport.swiftasset · 3,254 bytesTests/AgentSquadTests/ToolBuilderTests.swiftasset · 4,908 bytesTests/AgentSquadTests/ToolKitTests.swiftasset · 2,021 bytesTests/AgentSquadTests/ToolingTests.swiftasset · 2,546 bytesTests/AgentSquadTests/TracingTests.swiftasset · 2,932 bytesTests/AgentSquadTests/TransformingChatStorageTests.swiftasset · 7,407 bytesTests/AgentSquadTests/URLSessionWebSocketTransportTests.swiftasset · 936 bytesTests/AgentSquadTests/VoiceAssistantContractTests.swiftasset · 2,632 bytes
Read excerpt
# AgentSquad Swift — assistant guide
Protocol-driven, on-device multi-agent framework (Swift 6.2, iOS 16+ / macOS 14+; persistence via
`FileChatStorage` on iOS 16+, `DeviceChatStorage` on iOS 17+). This is guidance and
a map — **not an API reference**. Read the exact signatures from the source (`swift/Sources/AgentSquad/`)
and the worked recipes from the docs site sources (`docs/src/content/docs/swift/`); this file tells
you *what to use, when, and what to watch out for*.
## When to use what
- **One assistant** → an `Agent` (or `GroundedAgent`) + an `Orchestrator` with no classifier. No routing hop.
- **Several specialists** → multiple agents + an `LLMClassifier`; the orchestrator routes each turn.
- **Answers must not drift from data** (prices, stock, balances) → `GroundedAgent`: a Brain calls
tools, an isolated Presenter speaks only from the curated results (it can be a smaller/local model).