Skill128 repo starsupdated 1mo ago

app-creator

The app-creator skill orchestrates iOS and macOS project setup by scaffolding new apps with XcodeGen templates or non-destructively adopting existing projects. It guides users through collecting project inputs, running validation checks, and optionally installing complementary subskills for build automation and task management, with support for git initialization and baseline commits.

View source Repository: claude-code-toolkit

Install in Claude Code

Copy

git clone --depth 1 https://github.com/robertguss/claude-code-toolkit /tmp/app-creator && cp -r /tmp/app-creator/skills/mobile-app-dev/ios-mac-app-creator/app-creator ~/.claude/skills/app-creator

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# 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:

```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`