xcode-makefiles

Name: xcode-makefiles
Author: robertguss/claude-code-toolkit

$npx mdskill add robertguss/claude-code-toolkit/xcode-makefiles

Install strict Xcode Makefile tooling for reproducible iOS/macOS CLI builds.

Provides reproducible local CLI builds without full app scaffolding.
Depends on Xcode command-line tools and Make.
Uses AGENT_NAME env var for per-agent isolation under build/.
Installs Makefile and scripts for build, run, test, and clean.

SKILL.md

.github/skills/xcode-makefilesView on GitHub ↗

---
name: xcode-makefiles
description: Install strict Xcode Makefile tooling for iOS/macOS projects, including build/run/test scripts with AGENT_NAME-based per-agent isolation under build/. Use when a project needs reproducible local CLI builds without full app scaffolding.
---

# Xcode Makefiles

## Overview

Paul Solt
[email protected]
Version: 0.9.8

Install a focused Makefile + scripts toolkit into an existing or newly scaffolded Xcode project.

Canonical conventions:
- `AGENT_NAME` is the only agent env var.
- Per-agent paths live under `build/`:
  - `build/DerivedData/<AGENT_NAME>`
  - `build/logs/<AGENT_NAME>`
  - `build/cache/<AGENT_NAME>`
  - `build/tmp/<AGENT_NAME>`

## Install

```bash
skills/xcode-makefiles/scripts/install.sh \
  --project-dir /path/to/project \
  --app-name WalkTrack \
  --platform ios
```

Common flags:
- `--project-dir PATH` required
- `--mode install|upgrade` default `install`
- `--dry-run` preview changes only

Toolkit flags:
- `--app-name NAME` required
- `--platform ios|macos` required
- `--sim-name NAME` optional, defaults to `auto` for iOS
- `--namespace NAME` optional, installs `Makefile.NAME` and `scripts/NAME/`

Installed scripts include:
- `scripts/atomic_commit.sh`
- `scripts/xcbuild.sh`
- `scripts/resolve_agent_name.sh`
- `scripts/resolve_sim_destination.sh`
- `scripts/diagnose.sh`
- `scripts/run_app_macos.sh`
- `scripts/run_app_ios_sim.sh`
- `scripts/clean.sh`
- `scripts/move_to_trash.sh`

## Targets

Installed Make targets are intentionally minimal:
- `make diagnose`
- `make build`
- `make test`
- `make run`
- `make build-and-run`
- `make build-and-run-background`
- `make clean`
- `make agent-verify`

More from robertguss/claude-code-toolkit

Skill	Description
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.
app-growth-playbook	Gather the following before selecting channels:
app-review-analyzer	- Chrome browser with Claude in Chrome extension (for reading store reviews) - No API keys required — all analysis is done through live browser interaction - Supports iOS App Store and Google Play Store
app-store-listing-optimizer	Craft high-converting, keyword-optimized App Store and Google Play listings through competitive research, strategic keyword selection, and data-driven screenshot planning.
app-store-opportunity-research	- Browser tools for App Store browsing and research - Web search for Reddit, Google Trends, and indie revenue research - No API keys required — all research is done through browser and web search
book-architect	Design the reader's journey and create a comprehensive structural blueprint for nonfiction books. Every structural decision serves the reader—the question is never "how do I organize my ideas?" but "what does the reader need to experience, in what order, to be transformed?"
book-idea-validator	Stress-test core ideas from a Book Concept Document against existing research, surfacing weaknesses early before significant investment in architecture and drafting.
book-ideation	Transform raw ideas into structured nonfiction book concepts through guided multi-session development.
book-market-research	Determine if a book is worth writing from a business perspective, specifically for Amazon KDP self-publishing.
book-research-assistant	Plan, orchestrate, and validate deep research for nonfiction books. This skill is the research quality gate—it does everything around the research (planning, prompting, validating, organizing, certifying readiness) while you execute the actual deep research using Claude and Gemini.