App Creator Skill

Creates production-ready iOS/macOS app projects.

Requirements

Before creating a project, collect from the user:

1. •App Name (required) - Display name (e.g., "My Awesome App")
2. •App Identifier (required) - Bundle ID (e.g., "com.mycompany.myapp")

Optional parameters with defaults:

• •Organization Name (defaults to App Name)
• •Development Team ID (optional) - Apple Developer Team ID for code signing
• •iOS Deployment Target (default: "17.0")
• •macOS Deployment Target (default: "14.0")
• •Output directory (default: current directory)

How to Find Your Development Team ID

The Development Team ID is required for deploying to physical devices. Users can find it by:

1. •

   From Apple Developer Portal:

   • •Go to https://developer.apple.com/account
   • •Sign in with your Apple ID
   • •Look for "Membership Details" → Team ID (10-character alphanumeric, e.g., "ABCDE12345")
2. •

   From Xcode:

   • •Open Xcode → Settings (⌘,) → Accounts tab
   • •Select your Apple ID → Click your team
   • •The Team ID is shown in the details
3. •

   From Terminal:

   bash

   # List all available signing identities and teams
   security find-identity -v -p codesigning
   

If the user doesn't have an Apple Developer account or doesn't know their Team ID, they can leave it empty and add it later in Project.swift.

Workflow

1. •Ask user for App Name and App Identifier
2. •Ask user for optional Development Team ID (explain how to find it if they don't know)
3. •Run the creation script: scripts/create_app.py (from the desired root directory)
4. •Navigate to the project subfolder and run tuist generate to create the Xcode workspace
5. •Show the user the README.md with manual setup steps

Note: AGENTS.md and CLAUDE.md are created in the current working directory where the skill is invoked. All source code is generated inside a subfolder named after the project (e.g., ./MyApp/).

Script Usage

python3 scripts/create_app.py \
  --name "My App" \
  --identifier "com.example.myapp" \
  --team-id "ABCDE12345" \
  --output "."

All parameters:

• •--name / -n (required): App display name
• •--identifier / -i (required): Bundle identifier
• •--team-id / -t (optional): Apple Developer Team ID for automatic signing
• •--output / -o (optional): Output directory, defaults to current directory
• •--organization (optional): Organization name, defaults to app name
• •--ios-target (optional): iOS deployment target, defaults to "17.0"
• •--macos-target (optional): macOS deployment target, defaults to "14.0"

Project Structure

The generated project is created in the current working directory where the skill is invoked:

./                          # Current working directory (root)
├── AGENTS.md               # AI agent instructions
├── CLAUDE.md -> AGENTS.md  # Symlink for Claude Code
└── {AppName}/              # Project subfolder with source code
    ├── Project.swift           # Tuist project definition
    ├── Tuist.swift             # Tuist configuration
    ├── README.md               # Setup guide with TODOs
    ├── .swiftformat            # Code formatting rules
    ├── .gitignore              # Git ignore patterns
    ├── Sources/
    │   ├── App/                # Thin app shell (DI only)
    │   │   ├── {AppName}App.swift
    │   │   ├── AppDependencies.swift
    │   │   └── ContentView.swift
    │   ├── Core/               # Domain logic, models, protocols
    │   │   └── Core.swift
    │   ├── UI/                 # Reusable UI components
    │   │   └── UI.swift
    │   └── Features/           # Feature modules with views/viewmodels
    │       └── Features.swift
    ├── Resources/
    │   └── .gitkeep
    ├── Tests/
    │   ├── AppTests/           # App integration tests
    │   ├── AppUITests/         # End-to-end UI tests
    │   ├── CoreTests/          # Core module unit tests
    │   ├── UITests/            # UI component tests
    │   ├── FeaturesTests/      # Feature module tests
    │   └── SnapshotTests/      # Visual regression tests
    ├── fastlane/
    │   ├── Appfile             # App Store Connect config
    │   ├── Fastfile            # Lane definitions
    │   ├── Deliverfile         # Deliver settings
    │   ├── Pluginfile          # Fastlane plugins
    │   └── metadata/           # App Store metadata
    └── scripts/ci/
        ├── run_tests.sh        # iOS unit tests
        ├── run_tests_macos.sh  # macOS unit tests
        ├── run_ui_tests.sh     # UI tests with simulator
        ├── verify_build.sh     # iOS build verification
        ├── verify_build_macos.sh
        ├── verify_format.sh    # SwiftFormat check
        └── verify_tuist_generate.sh

Architecture Principles

The generated project enforces:

1. •Thin App Shell: App target only contains dependency injection
2. •Module Separation: Core (logic) → UI (components) → Features (screens)
3. •Protocol-Based Dependencies: All services have protocols for testability
4. •MVVM Pattern: ViewModels in Features, Views use @StateObject/@ObservedObject

Post-Creation Setup

The generated README.md (inside the project subfolder) includes these manual steps:

Required Steps

• • Navigate to project subfolder: cd {AppName}
• • Run tuist generate to create workspace
• • Update DEVELOPMENT_TEAM in {AppName}/Project.swift (if not set during creation)

Code Signing

Automatic signing is pre-configured for all targets. Once you set your DEVELOPMENT_TEAM, you can deploy directly to physical devices without additional Xcode configuration.

Optional Steps

• • Set up Xcode Cloud workflow
• • Create App Store Connect app record
• • Configure Fastlane App Store Connect API key
• • Add app icons to Resources/Assets.xcassets

Axiom Skills Reference

The AGENTS.md file (created in the current working directory) references these Axiom skills for AI agents: