CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, expert-grade reference body: fully concrete guidance, explicit error semantics, and good deferral to source and docs. The main deductions are duplicated storage/voice guidance across sections and the absence of a complete, validated quick-start construction example.

Suggestions

Deduplicate the storage guidance: TransformingChatStorage and SummarizingChatStorage are each described in full in both 'The pieces' and the Storage gotcha — keep one canonical description and cross-reference it to free tokens.

Add a minimal end-to-end quick-start snippet (SwiftPM package → Agent + Orchestrator construction → route → check that .final was persisted) so the most common first task is executable without consulting the docs site.

Move the deep voice/realtime session tuning (transcriptionModel, turnDetection, sessionOverrides, reasoning-effort escalation) into a separate reference file with a one-line pointer, keeping the overview body to the audio wiring essentials.

DimensionReasoningScore

Conciseness

The body is lean and telegraphic, assumes competence, and explains nothing Claude already knows — every line carries framework-specific facts (defaults like 'maxToolRounds … default to 20', '`.error` carries a user-facing message'). It falls short of the top anchor because of real duplication: TransformingChatStorage and SummarizingChatStorage are each fully described twice, once in 'The pieces' and again in the Storage gotcha, and AEC wiring detail is likewise spread across two sections. Not anchor 3 — the padding is confined to a couple of repeated passages, not general looseness.

4 / 5

Actionability

Guidance is concrete throughout: a copy-paste 'for try await event in orchestrator.route(…)' idiom, the SwiftPM package line, exact initializer signatures ('SummarizingChatStorage(wrapping:summarizer:triggerAt:keepLast:)', 'MicCapture(voiceProcessing: nil)'), and a seam table mapping every protocol to its source file and doc page. It misses the top anchor only because the single complete code example covers event consumption — there is no full construction snippet (Agent/Orchestrator wiring) for the most common first task. Not anchor 3 — nothing is pseudocode or abstract.

4 / 5

Workflow Clarity

The turn pipeline is explicitly sequenced ('classify? → run agent → stream → persist'), the 'When to use what' section gives a clear decision flow, and failure semantics are thorough (what throws vs. arrives as .error, barge-in truncation behavior, 'only turns ending in .final are saved'). It misses anchor 5 because there is no end-to-end setup sequence with an explicit verification checkpoint (e.g., add package → construct → route → confirm persistence). Not anchor 3 — checkpoints for error paths are largely present, just not assembled into a validated run-through.

4 / 5

Progressive Disclosure

The file is structured as a self-contained overview that defers depth to clearly signaled, one-level-deep pointers — 'Read the exact signatures from the source (swift/Sources/AgentSquad/)' and the 'Go deeper' section listing doc paths — rather than nesting references or burying them. It misses anchor 5 because dense per-component detail (voice session tuning, tracing lifecycle, storage wrappers) is inlined in this single file instead of being split out, which the anchor's 'content appropriately split' phrasing rewards. Not anchor 3 — references are explicit and the file has clean section navigation.

4 / 5

Total

16

/

20

Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: an explicit, concrete 'Use when…' trigger tied to a named framework, with comprehensive and specific coverage of the framework's component surface. Its only weakness is that the action vocabulary is thin ('building or modifying') relative to the dense component enumeration around it.

DimensionReasoningScore

Specificity

The description enumerates concrete, specific capabilities ('orchestrator, agents (Agent, GroundedAgent), classifier routing, LLM clients (OpenAI-compatible), tools (native + MCP), tool UIs/widgets, on-device storage, tracing, and realtime voice') with no vague language, but it rests on only two action verbs ('building or modifying') where the top anchor expects multiple distinct concrete actions. It sits above anchor 3 (coverage is comprehensive, not 1-2 actions) but below anchor 5 (action list is minimal even though the component enumeration is thorough).

4 / 5

Completeness

It explicitly answers both questions: the 'what' is the full on-device multi-agent orchestration component list, and the 'when' is the concrete trigger phrase 'Use when building or modifying a Swift app that uses the AgentSquad Swift framework'. This is a direct structural match for the top anchor (explicit 'Use when…' plus a clear, concrete what); it is clearly above anchor 4, where the when is present but weaker.

5 / 5

Trigger Term Quality

It covers the natural terms a user of this framework would actually say — 'Swift app', 'orchestrator', 'agents', 'LLM clients', 'MCP', 'storage', 'tracing', 'realtime voice', 'iOS 16+ / macOS 14+' — comprehensively across the framework's whole surface. There are no file extensions or further synonyms in this domain to be missing, so it matches the top anchor rather than the 'a few natural terms missing' anchor below it.

5 / 5

Distinctiveness Conflict Risk

It is pinned to a single named framework ('the AgentSquad Swift framework') with its own component vocabulary, giving it a clear niche with minimal conflict risk — a generic Swift, iOS, or LLM request would not match. Nothing in it overlaps materially with other skills, matching the 'clear niche with distinct triggers' anchor rather than the 'minor overlap risk with closely related skills' anchor below.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

2FastLabs/agent-squad

Path

swift/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.