asset-catalog-optimizer

Analyze Xcode asset catalogs for unused assets and missing resolutions.

2|Updated Jun 25, 2023
One-click install
npx skills add https://github.com/paleoterra/PaleoRose --skill asset-catalog-optimizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: asset-catalog-optimizer
Source: https://github.com/paleoterra/PaleoRose/tree/main/.claude/skills/asset-catalog-optimizer
Command: npx skills add https://github.com/paleoterra/PaleoRose --skill asset-catalog-optimizer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill tackles the problem of bloated app bundles caused by unoptimized or unused image assets, leading to slower download times and increased storage usage for users.

Core Features & Use Cases

  • Asset Audit: Find unused images, check for missing @2x/@3x resolutions, and detect duplicate assets.
  • Image Compression: Losslessly compress PNGs and optimize JPEGs to reduce file sizes without quality loss.
  • Use Case: Before submitting your app to the App Store, automatically scan your Assets.xcassets to identify and compress all PNG images, remove unused assets, and flag any missing resolution variants, significantly reducing app size.

Quick Start

Analyze the 'PaleoRose/Assets.xcassets' folder to find unused assets, checking against the 'PaleoRose' source directory.

Frequently Asked Questions about asset-catalog-optimizer

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

FAQPage Schema
How do I reduce app size by optimizing Xcode asset catalogs?

Asset catalog optimization identifies unused images, detects missing resolution variants (@2x/@3x), and compresses PNGs and JPEGs losslessly. Scan your .xcassets folder against your source code to remove bloat and prepare for App Store submission without quality loss.

Can I automatically find unused images in my iOS project?

Yes. The Skill analyzes your .xcassets and traces references across your Swift/ObjC codebase to flag images that aren't referenced, helping you identify candidates for removal before building your app bundle.

What happens if my PNG images are missing @2x or @3x resolutions?

Missing resolution variants cause Xcode to scale assets at runtime, increasing memory usage and degrading performance. The Skill detects these gaps so you can provide properly scaled versions for all required densities.

How much can lossless image compression reduce my app size?

Lossless compression for PNGs and JPEG optimization typically reduce asset file sizes by 10-30% without visible quality loss. The exact savings depend on your image composition and compression ratios applied during the audit.

Does this tool work with macOS projects or only iOS?

The Skill supports both iOS and macOS projects using .xcassets. It analyzes asset catalogs and source code reference patterns across both platforms, making it applicable to any Swift or Objective-C project with bundled image assets.

Can I detect duplicate assets across my catalog?

Yes. The Skill flags duplicate images with different names or across different asset sets, helping you consolidate redundant files and reduce unnecessary bloat in your app bundle.