# Send Xcode to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "xcode",
    "name": "Xcode",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/xcode",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/xcode",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/xcode",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=xcode",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "xcode",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-11T06:58:47.316Z",
      "expiresAt": "2026-05-18T06:58:47.316Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=xcode",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=xcode",
        "contentDisposition": "attachment; filename=\"xcode-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "xcode"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/xcode"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/xcode",
    "downloadUrl": "https://openagent3.xyz/downloads/xcode",
    "agentUrl": "https://openagent3.xyz/skills/xcode/agent",
    "manifestUrl": "https://openagent3.xyz/skills/xcode/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/xcode/agent.md"
  }
}
```
## Documentation

### Signing Issues

"Automatic" signing still needs team selected — set in Signing & Capabilities
Provisioning profile mismatch — bundle ID must match exactly, including case
"No signing certificate" — open Keychain, check certificate is valid and not expired
Device not registered — add UDID in developer portal, regenerate profile
CI/CD needs manual signing — automatic doesn't work in headless builds

### Derived Data Corruption

Random build failures after Xcode update — delete ~/Library/Developer/Xcode/DerivedData
"Module not found" but it exists — clean Derived Data, restart Xcode
Stale cache symptoms — builds work, then fail, then work again
xcodebuild clean not enough — sometimes must delete DerivedData manually

### Build Settings Hierarchy

Project → Target → xcconfig → command line — later overrides earlier
$(inherited) to append not replace — forgetting it removes parent settings
SWIFT_ACTIVE_COMPILATION_CONDITIONS for Swift flags — not OTHER_SWIFT_FLAGS
GCC_PREPROCESSOR_DEFINITIONS for Obj-C — add to existing, don't replace

### Archive vs Build

Archive uses Release config by default — build uses Debug
"Works in simulator, fails in archive" — check Release build settings
Archive requires valid signing — build doesn't for simulator
SKIP_INSTALL = YES for frameworks — or archive includes them incorrectly

### Capabilities and Entitlements

Capability in Xcode must match entitlements file — out of sync causes crashes
Push notifications need both — App ID capability AND provisioning profile
Associated domains needs apple-app-site-association file — hosted on your server
Keychain sharing needs explicit group — default is just your app

### Dependencies

SPM and CocoaPods can conflict — watch for duplicate symbols
Pod update vs install — install uses Podfile.lock, update ignores it
"Framework not found" — check Framework Search Paths, embed vs link
SPM package resolution fails — delete Package.resolved, reset package caches

### Common Fixes

Build fails with no clear error — check Report Navigator for details
Simulator stuck — xcrun simctl shutdown all, then xcrun simctl erase all
Indexing stuck — delete Index folder in DerivedData
Autocomplete broken — restart Xcode, if persists delete DerivedData

### CLI Builds

xcodebuild -showBuildSettings to debug — see resolved values
-allowProvisioningUpdates for CI with auto-signing — needs keychain access
-destination must be exact — platform=iOS Simulator,name=iPhone 15
xcrun altool deprecated — use xcrun notarytool for notarization
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-11T06:58:47.316Z
- Expires at: 2026-05-18T06:58:47.316Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/xcode)
- [Send to Agent page](https://openagent3.xyz/skills/xcode/agent)
- [JSON manifest](https://openagent3.xyz/skills/xcode/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/xcode/agent.md)
- [Download page](https://openagent3.xyz/downloads/xcode)