swiftship/internal/skills/data/features/asset-management/SKILL.md
Manage Xcode project assets including app icons, images, and asset catalogs. Use when handling app icon installation, image asset creation, or asset catalog modifications.
npx skillsauth add abdullah4ai/apple-developer-toolkit asset-managementInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Xcode projects use .xcassets bundles containing named asset sets:
Assets.xcassets/
Contents.json # Root catalog manifest
AppIcon.appiconset/
Contents.json # Icon set manifest with image references
AppIcon.png # The actual icon file
AccentColor.colorset/
Contents.json # Color set manifest
All platforms require a single high-resolution icon. Xcode generates all needed sizes automatically.
| Platform | Size | Idiom | Platform Key | |----------|------|-------|-------------| | iOS | 1024x1024 | universal | ios | | watchOS | 1024x1024 | universal | watchos | | tvOS | 1280x768 | tv | tvos | | macOS | 1024x1024 | mac | (none) | | visionOS | 1024x1024 | universal | xros |
iOS example:
{
"images": [
{
"filename": "AppIcon.png",
"idiom": "universal",
"platform": "ios",
"size": "1024x1024"
}
],
"info": {
"version": 1,
"author": "xcode"
}
}
macOS uses "idiom": "mac" with "scale": "1x" and no "platform" key.
macOS includes sips (scriptable image processing system) for image manipulation:
# Query dimensions
sips -g pixelWidth -g pixelHeight image.png
# Resize to exact dimensions
sips -z 1024 1024 image.png
# Convert format to PNG
sips --setProperty format png image.jpg --out image.png
# Resize and convert in one step
sips -z 1024 1024 --setProperty format png input.jpg --out output.png
To verify an icon is correctly installed:
AppIcon.appiconset/Contents.json has a filename entrysips -g pixelWidth -g pixelHeightSearch for the asset catalog in the project:
find . -name "AppIcon.appiconset" -not -path "*/DerivedData/*" -not -path "*/.build/*"
Or use Glob: **/AppIcon.appiconset/
testing
Use for 3D games: racing, 3D sports, board games, marble maze, tower defense, bowling. SceneKit + SceneView architecture, 3D scene hierarchy, physics, game loop, primitives, materials, cameras, particles, audio.
documentation
Game UI patterns: SwiftUI HUD overlays on SpriteKit, menus (main/pause/game-over), virtual joystick/d-pad, score displays, health bars, tutorial onboarding.
tools
Download free game sprites/textures/3D models and generate procedural assets. Covers nw_download_asset tool, texture factories, sprite atlas organization, 3D model loading, and programmatic asset creation.
testing
Use for 2D games: arcade, puzzle, sports, ping pong, platformer, shooter, 2D racing. SpriteKit + SpriteView architecture, scene hierarchy, physics, game loop, audio, particles, game feel.