Skip to content

AgentSquad Swift Framework Guide

Guides building Swift apps on the AgentSquad on-device multi-agent framework (orchestrator, agents, tools, voice).

Stars
7,795
Licence
Apache-2.0
Files
2 files

What it does

This skill gives an AI coding agent a map of the AgentSquad Swift framework, a library for building iOS and macOS apps that run several AI assistants on the device. Once installed, the agent knows when to use a single agent versus several specialists with routing, when to use grounded answers that stay tied to tool results, and how to wire tools, chat storage, tracing and realtime voice. It points the agent to the framework source and documentation for exact signatures rather than acting as an API reference.

Great for

  • Swift developers building an iOS 16+ or macOS 14+ app with AgentSquad
  • Teams adding multi-agent chat, tool calling, or realtime voice to an existing Swift app
  • Developers who want an AI coding assistant to write correct AgentSquad integration code

Skip it if

  • Non-Swift projects, since the guidance only covers the Swift framework (wrong stack)
  • Apps that must not send data to external LLM or memory services without review, because the framework can be pointed at remote endpoints such as OpenAI, Azure or a self-hosted Dakera server (privacy risk depends on configuration)
  • Readers looking for complete API signatures, since the skill explicitly defers to the source code and docs

Try asking

  • “Set up an orchestrator with a classifier that routes questions to three specialist agents in my iOS app”
  • “Add a GroundedAgent so that prices and stock figures come only from my tool results”
  • “Wire VoiceProcessedAudioIO into a realtime voice assistant with AgentSquad”
  • “Add a TransformingChatStorage that redacts personal data before messages are saved”
Step-by-step guide: how to use AgentSquad Swift Framework GuideInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 2 original files, the Apache-2.0 licence and an attribution note.

    swift.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip swift.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip swift.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Point the agent at the actual source in swift/Sources/AgentSquad/ and the docs recipes so it reads real signatures instead of guessing
  • Keep API keys out of source code and load them from the environment or Keychain when the agent writes configuration
  • Review any PII-handling, tracing, or external endpoint code the agent generates before shipping to users

What's inside

  • README.md
  • SKILL.md

Redistributed unmodified from 2FastLabs/agent-squad under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.