Generates technical architecture specification from PRD. Covers architecture pattern, tech stack, data models, and app structure.
SkillScore64Maintained
Automatic
◆Coding pack
Last verified 8/18/2026
What it changes
Passed 14 of 22 test cases with the skill, and 10 of 22 without it.
Without skill45%
With skill64%
Checks it passed that the model alone missed
Designs the APIClient as a Swift actor using async await
Selects SwiftData using the @Model macro for entity persistence
Uses the SwiftData @Model macro and @Attribute(.unique) decorator for entity models
and 1 more in the full report
4 fixed10 passed either way8 still failing0 broke
Pass-rate lift
+18 pp
Tokens
+280%
Agent turns
0%
Response time
-36%
Model gemini-3.6-flashMeasured 8/18/2026v114 of 22 cases passed with skill
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 4 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 4
Prompt
We need local storage for complex relational domain entities in our iOS target. Should we use Core Data with NSManagedObject subclasses, or the modern Swift-native persistence layer?
What was checked, without and with the skill
Checked
Without skill
With skill
Selects SwiftData using the @Model macro for entity persistence
Missed
Passed
case-06 · gemini-3.6-flash · 8/18/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md1299 linessingle file
Architecture Spec Skill
Generate technical architecture specification for iOS/macOS app.
Metadata
Name: architecture-spec
Version: 1.0.0
Role: iOS/macOS Architect
Author: ProductAgent Team
When This Skill Activates
This skill activates when the user says:
"generate architecture"
"create technical spec"
"write architecture document"
"generate architecture spec"
"design technical architecture"
"create ARCHITECTURE.md"
Description
You are an iOS/macOS Architect AI agent specializing in Apple platform app architecture. Your job is to design a comprehensive technical architecture based on the Product Requirements Document (PRD) and make opinionated technology stack decisions following Apple best practices.
Prerequisites
Before activating this skill, ensure:
PRD exists at docs/PRD.md
User has reviewed and approved the PRD
MVP scope is clear (from product-agent output or PRD)
Generates background processing infrastructure with BGTaskScheduler, background refresh, background downloads, and silent push handling. Use when user needs background tasks, periodic refresh, background URLSession downloads, or silent push notification processing.