Back to Skills

axiom-memory-debugging

verified

Use when you see memory warnings, 'retain cycle', app crashes from memory pressure, or when asking 'why is my app using so much memory', 'how do I find memory leaks', 'my deinit is never called', 'Instruments shows memory growth', 'app crashes after 10 minutes' - systematic memory leak detection and fixes for iOS/macOS

View on GitHub

Marketplace

axiom-marketplace

CharlesWiltgen/Axiom

Plugin

axiom

Repository

CharlesWiltgen/Axiom
289stars

.claude-plugin/plugins/axiom/skills/axiom-memory-debugging/SKILL.md

Last Verified

January 16, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/CharlesWiltgen/Axiom/blob/main/.claude-plugin/plugins/axiom/skills/axiom-memory-debugging/SKILL.md -a claude-code --skill axiom-memory-debugging

Installation paths:

Claude
.claude/skills/axiom-memory-debugging/
Powered by add-skill CLI

Instructions

# Memory Debugging

## Overview

Memory issues manifest as crashes after prolonged use. **Core principle** 90% of memory leaks follow 3 patterns (retain cycles, timer/observer leaks, collection growth). Diagnose systematically with Instruments, never guess.

## Example Prompts

These are real questions developers ask that this skill is designed to answer:

#### 1. "My app crashes after 10-15 minutes of use, but there are no error messages. How do I figure out what's leaking?"
→ The skill covers systematic Instruments workflows to identify memory leaks vs normal memory pressure, with real diagnostic patterns

#### 2. "I'm seeing memory jump from 50MB to 200MB+ when I perform a specific action. Is this a leak or normal caching behavior?"
→ The skill distinguishes between progressive leaks (continuous growth) and temporary spikes (caches that stabilize), with diagnostic criteria

#### 3. "View controllers don't seem to be deallocating after I dismiss them. How do I find the retain cycle causing this?"
→ The skill demonstrates Memory Graph Debugger techniques to identify objects holding strong references and common retain cycle patterns

#### 4. "I have timers/observers in my code and I think they're causing memory leaks. How do I verify and fix this?"
→ The skill covers the 5 diagnostic patterns, including specific timer and observer leak signatures with prevention strategies

#### 5. "My app uses 200MB of memory and I don't know if that's normal or if I have multiple leaks. How do I diagnose?"
→ The skill provides the Instruments decision tree to distinguish normal memory use, expected caches, and actual leaks requiring fixes

---

## Red Flags — Memory Leak Likely

If you see ANY of these, suspect memory leak not just heavy memory use:

- Progressive memory growth: 50MB → 100MB → 200MB (not plateauing)
- App crashes after 10-15 minutes with no error in Xcode console
- Memory warnings appear repeatedly in device logs
- Specific screen/operation makes memory jump (10-5

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
37462 chars