axiom-camera-capture-diag

Diagnose AVFoundation camera issues in iOS and macOS apps.

Updated Dec 23, 2025
One-click install
npx skills add https://github.com/pradeepmouli/swift-template --skill axiom-camera-capture-diag-pradeepmouli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-camera-capture-diag
Source: https://github.com/pradeepmouli/swift-template/tree/main/.agents/skills/axiom-camera-capture-diag
Command: npx skills add https://github.com/pradeepmouli/swift-template --skill axiom-camera-capture-diag-pradeepmouli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Camera Capture Diagnostics helps developers systematically troubleshoot AVFoundation camera issues across iOS and macOS apps, reducing debugging time and user impact.

Core Features & Use Cases

  • Systematic checks for session state, inputs/outputs, and rotation handling
  • Guidance for permissions, interruptions, and platform-specific edge cases
  • Use Case: A developer uses these steps to diagnose a frozen preview or a rotated live view during recording

Quick Start

Follow these steps to reproduce and resolve common AVFoundation camera failures in your project.

Frequently Asked Questions about axiom-camera-capture-diag

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix a frozen AVFoundation camera preview in my iOS app?

Diagnose frozen AVFoundation camera previews by checking session state, verifying inputs/outputs, and validating threading patterns. Systematic checks identify whether the AVCaptureSession is interrupted or incorrectly configured, providing actionable fixes and code samples to restore the live preview.

Why does my macOS camera capture fail after a device rotation?

Camera capture rotation errors occur when AVFoundation session orientation handling is mismatched. Diagnose rotation handling by verifying preview layer connection settings and session reconfiguration logic, applying specified patterns and fixes to ensure correct orientation tracking across iPhone, iPad, and Mac apps.

How do I handle AVFoundation camera interruptions and permissions on iOS?

Handle AVFoundation camera interruptions and permissions by applying systematic checks for session state and authorization status. Diagnose permission problems and interruption management using specific guidance and code samples to properly resume session functionality after interruptions.

What is the best way to troubleshoot slow AVFoundation camera captures?

Troubleshoot slow AVFoundation camera captures by systematically checking session configuration, output settings, and threading patterns. Diagnose performance bottlenecks using actionable guidance to optimize capture pipeline settings and ensure efficient session state management across iOS and macOS apps.

Can I use this AVFoundation diagnostic approach for both iOS and macOS apps?

Yes, AVFoundation camera diagnostics apply across iPhone, iPad, and Mac apps. The approach specifies checks, patterns, and fixes for session state, threading, rotation handling, permissions, and interruption management tailored to platform-specific edge cases on both iOS and macOS.

AVFoundation camera session not working, what threading checks should I perform?

For AVFoundation camera sessions not working, perform threading checks to verify session configuration occurs on a dedicated background queue. Diagnose threading issues using specified patterns that prevent main-thread blocking and ensure proper session state transitions during capture operations.