Claude-code-toolkit app-creator

Orchestrate iOS/macOS app scaffolding and optional skill adoption for existing projects. Use when users want a guided wizard that can scaffold with XcodeGen and optionally install xcode-makefiles and simple-tasks.

install
source · Clone the upstream repo
git clone https://github.com/robertguss/claude-code-toolkit
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/robertguss/claude-code-toolkit "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/mobile-app-dev/ios-mac-app-creator/app-creator" ~/.claude/skills/robertguss-claude-code-toolkit-app-creator && rm -rf "$T"
manifest: skills/mobile-app-dev/ios-mac-app-creator/app-creator/SKILL.md
source content

App Creator

Overview

Paul Solt Paul@SuperEasyApps.com Version: 0.9.8

app-creator
is now an orchestrator skill.

Responsibilities:

  1. Scaffold new projects with XcodeGen templates.
  2. Adopt existing projects non-destructively.
  3. Optionally install subskills:
    • xcode-makefiles
    • simple-tasks

Workflow

  1. Collect inputs.
  2. Run doctor checks.
  3. Choose mode:
    new
    or
    adopt
    .
  4. In
    new
    mode, scaffold app templates and run XcodeGen.
  5. Install selected subskills (default: both).
  6. Optionally initialize git and create a baseline commit.
  7. Print exact next commands.

Modes

New Project

Run:

skills/app-creator/scripts/init.sh --project-mode new

Required fields in new mode:

  • App name
  • Bundle id
  • Platform (
    ios
    or
    macos
    )
  • UI framework (
    swiftui
    ,
    uikit
    ,
    appkit
    )
  • Output directory

Adopt Existing Project

Run:

skills/app-creator/scripts/init.sh --project-mode adopt

Behavior:

  • No scaffolding/regeneration.
  • Only installs selected subskills into the existing project.

Subskill install defaults

Wizard defaults to installing both:

  • xcode-makefiles
  • simple-tasks

You can opt out with:

  • --skip-xcode-makefiles
  • --skip-simple-tasks

Dry run

Use

--dry-run
to preview actions without mutating files.

Git onboarding

init.sh
/
scaffold_app.sh
support:

  • --git-init auto|never
  • --git-commit prompt|always|never

Defaults:

  • --git-init auto
  • --git-commit prompt

Safety behavior:

  • If the target repo is already dirty before app-creator runs, auto-commit is skipped.
  • If there are no staged/unstaged changes after install/scaffold, no commit is created.

Resources

Use these files when you need details beyond the workflow:

  • references/workflow.md
  • references/placeholders.md