Apple Documentation Research
When to Use This Skill
✅ Use this skill when:
- Researching Apple frameworks or APIs (WidgetKit, SwiftUI, etc.)
- Need full WWDC session transcripts with code samples
- Looking for Apple Developer documentation
- Want to extract code examples from WWDC presentations
- Building comprehensive skills based on Apple technologies
❌ Do NOT use this skill for:
- Third-party framework documentation
- General web research
- Questions already answered in existing skills
- Basic Swift language questions (use Swift documentation)
Related Skills
- Use superpowers-chrome:browsing for interactive browser control
- Use writing-skills when creating new skills from Apple documentation
- Use reviewing-reference-skills to validate Apple documentation skills
Core Philosophy
Apple Developer video pages contain full verbatim transcripts with timestamps and complete code samples. Chrome's auto-capture feature makes this content instantly accessible without manual copying.
Key insight: Don't manually transcribe or copy code from WWDC videos. The transcripts are already on the page, fully timestamped and formatted.
WWDC Session Transcripts via Chrome
The Technique
Apple Developer video pages (developer.apple.com/videos/play/wwdc20XX/XXXXX/) contain complete transcripts that Chrome auto-captures.
Step-by-Step Process
-
Navigate using Chrome browser MCP tool:
{
"action": "navigate",
"payload": "https://developer.apple.com/videos/play/wwdc2025/278/"
}
Tool name: mcp__plugin_superpowers-chrome_chrome__use_browser
Complete invocation:
Use the mcp__plugin_superpowers-chrome_chrome__use_browser tool with:
- action: "navigate"
- payload: "https://developer.apple.com/videos/play/wwdc2025/278/"
-
Locate the auto-captured file:
- Chrome saves to:
~/.../superpowers/browser/YYYY-MM-DD/session-TIMESTAMP/
- Session directory uses Unix timestamp in milliseconds (e.g.,
session-1765217804099)
- Filename pattern:
NNN-navigate.md (e.g., 001-navigate.md)
Finding the latest session:
ls -lt ~/Library/Caches/superpowers/browser/*/session-* | head -5
-
Read the captured transcript:
- Full spoken content with timestamps (e.g.,
[0:07], [1:23])
- Descriptions of code and API usage (spoken, not formatted)
- Chapter markers and resource links
What You Get
✅ WWDC transcripts contain:
- Full spoken content with timestamps (e.g.,
[0:07], [1:23])
- API names mentioned by speakers (e.g.,
widgetRenderingMode, supportedMountingStyles)
- Descriptions of what code does ("I'll add the widgetRenderingMode environment variable")
- Step-by-step explanations of implementations
- Chapter markers and resource links
❌ WWDC transcripts do NOT contain:
- Formatted Swift code blocks ready to copy-paste
- Complete implementations
- Structured code examples
Critical Understanding: Transcripts are spoken word, not code. You'll read sentences like "I'll add the widgetRenderingMode environment variable to my widget view" and need to reconstruct the code yourself from these descriptions.
When Code Isn't Clear from Transcript
If the transcript's code descriptions aren't detailed enough, follow this fallback workflow:
-
Check Resources Tab
- Navigate back to the WWDC session page
- Click "Resources" tab
- Look for "Download Sample Code" or "View on GitHub"
- Download Xcode project with complete working implementation
-
Use sosumi.ai for API Details
- Look up specific APIs mentioned in transcript
- Example: Transcript says "widgetAccentedRenderingMode" → look up
sosumi.ai/documentation/swiftui/widgetaccentedrenderingmode
- Get exact signature, parameters, usage
-
Jump to Timestamp in Video
- Use transcript timestamp to jump directly to code explanation in video
- Example: Transcript says code at
[4:23] → watch that specific 30-second segment
- Faster than watching entire 45-minute session
-
Combine Sources
- Transcript = conceptual understanding + workflow
- Resources = complete code
- sosumi.ai = API details
- Result: Full picture without manually reconstructing everything
Example transcript structure:
# Session Title - WWDC## - Videos - Apple Developer
## Chapters
- 0:00 - Introduction
- 1:23 - Key Topic 1
## Transcript
0:00
Speaker: Welcome to this session...
[timestamp]
Now I'll add the widgetAccentedRenderingMode modifier...
Example Session
WWDC 2025-278 "What's new in widgets":
- Navigate:
https://developer.apple.com/videos/play/wwdc2025/278/
- Captured:
001-navigate.md
- Contains: ~15 minutes of full transcript with API references and code concepts
Apple Documentation via sosumi.ai
Why sosumi.ai
Developer.apple.com documentation is HTML-heavy and difficult to parse. sosumi.ai provides the same content in clean markdown format.
URL Pattern
Instead of:
https://developer.apple.com/documentation/widgetkit
Use:
https://sosumi.ai/documentation/widgetkit
URL Pattern Rules
Format: https://sosumi.ai/documentation/[framework]
Rules for framework name:
- Lowercase - Use lowercase even if framework is capitalized (SwiftUI → swiftui)
- No spaces - Remove all spaces (Core Data → coredata)
- No hyphens - Remove all hyphens (App Intents → appintents, NOT app-intents)
- Case-insensitive - Both
SwiftUI and swiftui work, but lowercase is recommended
Common mistakes:
- ❌
app-intents → ✅ appintents
- ❌
axiom-core-data → ✅ coredata
- ❌
AVFoundation → ✅ avfoundation
Examples:
| Framework Name |
sosumi.ai URL |
| SwiftUI |
sosumi.ai/documentation/swiftui |
| App Intents |
sosumi.ai/documentation/appintents |
| Core Data |
sosumi.ai/documentation/coredata |
| AVFoundation |
sosumi.ai/documentation/avfoundation |
| UIKit |
sosumi.ai/documentation/uikit |
Using with WebFetch or Read Tools
WebFetch:
url: https://sosumi.ai/documentation/widgetkit/widget
prompt: "Extract information about Widget protocol"
Result: Clean markdown with API signatures, descriptions, examples
Framework Examples
| Framework |
sosumi.ai URL |
| WidgetKit |
https://sosumi.ai/documentation/widgetkit |
| SwiftUI |
https://sosumi.ai/documentation/swiftui |
| ActivityKit |
https://sosumi.ai/documentation/activitykit |
| App Intents |
https://sosumi.ai/documentation/appintents |
| Foundation |
https://sosumi.ai/documentation/foundation |
Common Research Workflows
Workflow 1: New iOS Feature Research
Goal: Create a comprehensive skill for a new iOS 26 feature.
- Find WWDC sessions — Search "WWDC 2025 [feature name]"
- Get transcripts — Navigate with Chrome to each session
- Read transcripts — Extract key concepts, code patterns, gotchas
- Get API docs — Use sosumi.ai for framework reference
- Cross-reference — Verify code samples match documentation
- Create skill — Combine transcript insights + API reference
Time saved: 3-4 hours vs. watching videos and manual transcription
Workflow 2: API Deep Dive
Goal: Understand a specific API or protocol.
- sosumi.ai docs — Get protocol/class definition
- WWDC sessions — Search for sessions mentioning the API
- Code samples — Extract from transcript code blocks
- Verify patterns — Ensure examples match latest API
Workflow 3: Multiple Sessions Research
Goal: Comprehensive coverage across multiple years (e.g., widgets evolution).
- Parallel navigation — Use Chrome to visit 3-6 sessions
- Read all transcripts — Compare how APIs evolved
- Extract timeline — iOS 14 → 17 → 18 → 26 changes
- Consolidate — Create unified skill with version annotations
Example: Extensions & Widgets skill used 6 WWDC sessions (2023-2025)
Anti-Patterns
❌ DON'T: Manual Video Watching
BAD:
1. Play WWDC video
2. Pause and take notes
3. Rewind to capture code
4. Type out examples manually
Result: 45 minutes per session
✅ DO: Chrome Auto-Capture
GOOD:
1. Navigate with Chrome
2. Read captured .md file
3. Copy code blocks directly
4. Reference timestamps for context
Result: 5 minutes per session
❌ DON'T: Scrape developer.apple.com HTML
BAD:
Use WebFetch on developer.apple.com/documentation
Result: Complex HTML parsing required
✅ DO: Use sosumi.ai
GOOD:
Use WebFetch on sosumi.ai/documentation
Result: Clean markdown, instant access
Troubleshooting
Chrome Session Directory Not Found
Symptom: Can't locate 001-navigate.md file
Solution:
- Check Chrome actually navigated (look for URL confirmation)
- Find latest session:
ls -lt ~/Library/Caches/superpowers/browser/*/
- Session directory format:
YYYY-MM-DD/session-TIMESTAMP/
Transcript Incomplete
Symptom: File exists but missing transcript
Solution:
- Page may still be loading - wait 2-3 seconds
- Try navigating again
- Some sessions require scrolling to load full content
sosumi.ai Returns Error
Symptom: 404 or invalid URL
Solution:
- Verify framework name spelling
- Check sosumi.ai format:
/documentation/[frameworkname]
- Fallback: Use developer.apple.com but expect HTML
Verification Checklist
Before using captured content:
- ☐ Transcript includes timestamps
- ☐ Code samples are complete (not truncated)
- ☐ Speaker names and chapter markers present
- ☐ Multiple speakers properly attributed
- ☐ Code syntax highlighting preserved
Resources
Skills: superpowers-chrome:browsing, writing-skills, reviewing-reference-skills
Time Saved: Using this technique saves 30-40 minutes per WWDC session vs. manual video watching and transcription. For comprehensive research spanning multiple sessions, savings compound to 3-4 hours per skill.
