justbecauselabs/agent-skills

ios-xcodegen

Create, edit, and troubleshoot XcodeGen project specs (project.yml/json) for iOS apps. Use when Codex needs to add or update targets, build settings, Info.plist/entitlements generation, dependencies, schemes, or run xcodegen to regenerate the .xcodeproj.

First seen Aug 16, 2026

Installation

$ npx skills add justbecauselabs/agent-skills --skill ios-xcodegen

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from justbecauselabs/agent-skills.

npx skills add justbecauselabs/agent-skills

Browse all from justbecauselabs/agent-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,936 B
  • docs SUMMARY.md 274 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 2 installs

SKILL.md

iOS XcodeGen

Overview

Use this skill to safely edit XcodeGen specs, regenerate the Xcode project, and verify the resulting build settings/targets.

Workflow (default)

  1. Locate the spec (project.yml or custom --spec).
  2. Edit targets/settings/dependencies/schemes in the spec.
  3. Regenerate with xcodegen.
  4. Validate the generated .xcodeproj/build settings.

Quick Commands

  • Regenerate in repo root: xcodegen
  • Custom spec path: xcodegen --spec path/to/spec.yml
  • Only plists: xcodegen --only-plists

Editing Guidance

  • Treat project.yml as source of truth. Avoid manual edits in .xcodeproj unless explicitly requested; if you must, sync changes back into the spec.
  • When adding targets, define type, platform, sources, and explicit settings.base.PRODUCTBUNDLEIDENTIFIER when needed.
  • For Info.plist/entitlements, prefer info: / entitlements: blocks so XcodeGen writes files deterministically. Be aware info generation can overwrite existing plist contents.
  • For dependencies, use target: entries with embed: true only when embedding is required (apps, extensions).
  • For schemes, use targets:<name>: all in schemes: when you need explicit control.

Reference

  • For full spec syntax, property definitions, and examples, read references/spec.md.

Validation Checklist

  • After regeneration, confirm target product types, bundle IDs, build settings, and embedded targets.
  • If build fails due to missing plist/entitlements, check info and entitlements paths in the spec.
  • If Xcode UI changes were made, reconcile and move them into the spec before regenerating again.