Claude-skill-registry asset-catalog-optimizer

Analyze and optimize Xcode asset catalogs - find unused assets, missing resolutions, compress images

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/asset-catalog-optimizer" ~/.claude/skills/majiayu000-claude-skill-registry-asset-catalog-optimizer && rm -rf "$T"

manifest: skills/data/asset-catalog-optimizer/SKILL.md

Asset Catalog Optimizer

Analyze

.xcassets

folders to optimize image assets and find issues.

Capabilities

List all assets in catalogs
Find unused images (not referenced in code)
Check for missing @2x/@3x versions
Analyze image file sizes
Compress images losslessly
Detect duplicate images
Validate asset naming
Generate asset inventory
Calculate total asset size
Suggest optimizations

Tools Included

asset_optimizer.py

Python script for asset analysis and optimization

Commands:

# Analyze asset catalog
./asset_optimizer.py PaleoRose/Assets.xcassets analyze

# Find unused assets
./asset_optimizer.py PaleoRose/Assets.xcassets find-unused --source-dir PaleoRose

# Check missing resolutions
./asset_optimizer.py PaleoRose/Assets.xcassets check-resolutions

# Compress images
./asset_optimizer.py PaleoRose/Assets.xcassets compress --quality 85

# Generate report
./asset_optimizer.py PaleoRose/Assets.xcassets report --output report.html

# Calculate sizes
./asset_optimizer.py PaleoRose/Assets.xcassets sizes

Features

Unused Asset Detection

Searches Swift/ObjC code for asset references like:

```
NSImage(named: "icon")
```
```
UIImage(named: "logo")
```
```
Image("background")
```
```
[NSImage imageNamed:@"button"]
```

Resolution Checking

Verifies all imagesets have:

@1x (universal or Mac)
@2x (required for Retina)
@3x (iOS only, warns if missing)

Compression

PNG: lossless optimization with pngquant/optipng
JPEG: quality-based compression
Preserves transparency
Maintains color profiles

Usage

Run when:

App bundle is too large
Need to audit assets
Before App Store submission
Cleaning up old/unused assets
Optimizing performance

Output Examples

Asset Catalog Analysis: Assets.xcassets
========================================

Total Assets: 47
Total Size: 12.3 MB

Missing Resolutions (5):
  - icon.imageset: Missing @2x
  - logo.imageset: Missing @3x
  - background.imageset: Missing @2x, @3x

Unused Assets (8):
  - old-button.imageset (45 KB)
  - deprecated-icon.imageset (23 KB)
  - test-image.imageset (156 KB)

Potential Savings:
  - Compression: 3.2 MB (26%)
  - Remove unused: 1.8 MB (15%)
  - Total: 5.0 MB (41%)

Recommendations:
  1. Compress 23 PNG files to save 3.2 MB
  2. Remove 8 unused assets to save 1.8 MB
  3. Add missing @2x/@3x versions for 5 assets