---
name: app-creator
description: 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.
---
# App Creator
## Overview
Paul Solt
[email protected]
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:
```bash
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:
```bash
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`