{"id":"1839d59c-ab99-4a9a-a6f7-659401d02ea6","shortId":"wvp4nC","kind":"skill","title":"sync-xcode-project-guidance","tagline":"Sync repo guidance for an existing native Apple app repository managed through Xcode when the user wants to add, merge, refresh, or align AGENTS.md and project workflow guidance. Use for existing macOS, iOS, or iPadOS app repos with an .xcodeproj or .xcworkspace. Do not use for b","description":"# Sync Xcode Project Guidance\n\n## Purpose\n\nBring an existing Xcode app repository up to the expected guidance baseline without overloading the main Xcode execution skill. This skill owns repo-guidance alignment for existing Apple app repos, including deterministic `AGENTS.md` creation or bounded section append behavior, and runs `maintain-project-repo` with the `xcode-app` profile alongside that guidance. `scripts/run_workflow.py` is the runtime entrypoint, and `scripts/sync_xcode_project_guidance.py` applies the current sync behavior.\n\n## Companion Plugin Requirement\n\nThis skill can be discovered from a standalone `apple-dev-skills` install, but its mutating guidance-sync path refreshes repo-maintenance files through the companion [`productivity-skills`](https://github.com/gaelic-ghost/productivity-skills) plugin. Before giving filesystem-level fallback instructions, first check the skills exposed in the current Codex session and use the harness-discovered `productivity-skills:maintain-project-repo` workflow when it is available. If the companion skill is not exposed, tell the user to add the [`socket`](https://github.com/gaelic-ghost/socket) marketplace with `codex plugin marketplace add gaelic-ghost/socket`, then install the relevant plugins from Codex's plugin directory so future sessions expose both `apple-dev-skills` and `productivity-skills`.\n\n## When To Use\n\n- Use this skill when an existing macOS, iOS, or iPadOS app repo needs `AGENTS.md` added, refreshed, or merged with the current Xcode workflow baseline.\n- Use this skill when the repository already has an `.xcodeproj` or `.xcworkspace` and the user wants project guidance, onboarding rules, or workflow policy brought up to date.\n- Use this skill when the user wants the repo guidance for the current narrower Xcode execution skills to be made explicit in the repo itself.\n- Do not use this skill for new-project creation from nothing.\n- Do not use this skill for ordinary build, test, run, diagnostics, docs lookup, or mutation work inside an existing Xcode project.\n- Do not use this skill for plain Swift packages, libraries, or tools that are not native Apple apps.\n- Recommend `bootstrap-xcode-app-project` when the repo does not exist yet.\n- Recommend `xcode-build-run-workflow` when the task is active Xcode execution, diagnostics, docs lookup, previews, file-membership follow-through, or mutation work inside an existing Xcode project.\n- Recommend `xcode-testing-workflow` when the task is primarily about Swift Testing, XCTest, XCUITest, `.xctestplan`, or test diagnosis inside an existing Xcode project.\n- Recommend `sync-swift-package-guidance` when the repo is a plain Swift package instead of an Xcode app project.\n- After updating this plugin's Xcode-policy surfaces, recommend rerunning `sync-xcode-project-guidance` in downstream repos so their `AGENTS.md` and `maintain-project-repo` output stay aligned.\n- For maintainer notes about this repository itself, say plainly that the repo exports from top-level `skills/` today and does not ship repo-local installer workflows.\n\n## Single-Path Workflow\n\n1. Collect the required inputs:\n   - `repo_root`\n   - optional `workspace_path`\n   - optional `skip_validation`\n   - optional `dry_run`\n2. Classify the request as existing Xcode app-repo guidance sync before continuing:\n   - continue only when the repo already contains an `.xcodeproj` or `.xcworkspace`\n   - stop if the request is really new-project bootstrap or SwiftPM-only guidance sync\n3. Apply the Apple docs gate before shaping workflow guidance:\n   - read the relevant Apple documentation first\n   - prefer Dash or local Apple docs first, then official Apple web docs when needed\n   - state the documented workflow boundary being relied on before proposing repo guidance changes\n   - current documented anchors for this workflow include:\n     - Apple's Xcode project-creation guidance: [Creating an Xcode project for an app](https://developer.apple.com/documentation/xcode/creating_an_xcode_project_for_an_app)\n     - SwiftUI app lifecycle guidance through the `App` protocol: [App](https://developer.apple.com/documentation/swiftui/app)\n     - scene composition guidance through `Scene` and `WindowGroup`: [Scene](https://developer.apple.com/documentation/swiftui/scene) and [WindowGroup](https://developer.apple.com/documentation/swiftui/windowgroup)\n   - if the docs and the current guidance template conflict, stop and report that conflict\n   - if no relevant Apple docs can be found, say that explicitly before proceeding\n4. Apply the shared Xcode-project policy before making repo-guidance changes:\n   - apply the detailed local policy in `references/snippets/apple-xcode-project-core.md`\n   - preserve its simplicity-first Swift, SwiftUI, Xcode-managed project, XcodeGen-backed project, test-plan, file-membership, tracked `.pbxproj` commit, and Debug/Release guidance\n5. Run `scripts/run_workflow.py` to normalize inputs, detect whether the repo is really Xcode-managed, and shape the sync plan.\n6. Apply the sync path:\n   - if `AGENTS.md` is missing, copy `assets/AGENTS.md`\n   - if `AGENTS.md` exists and already contains the managed section, keep the file unchanged\n   - if `AGENTS.md` exists but lacks the managed section, append `assets/append-section.md` as a bounded section\n7. Validate the synced repo guidance:\n   - verify `AGENTS.md` exists\n   - verify the synced file mentions `xcode-build-run-workflow` and `xcode-testing-workflow`\n   - verify the synced file preserves the no-direct-`.pbxproj` rule and the tracked `.pbxproj` stage-and-commit rule\n   - verify the synced file preserves the XcodeGen source-of-truth rule for repos that use generated projects\n8. Refresh `maintain-project-repo`:\n   - refresh `scripts/repo-maintenance/`\n   - refresh `.github/workflows/validate-repo-maintenance.yml`\n   - preserve repo-specific extra scripts that are not part of the managed file set\n9. Verify the synced maintenance guidance still points at the expected maintainer files:\n   - `.swiftformat`\n   - `scripts/repo-maintenance/hooks/pre-commit.sample`\n   - `scripts/repo-maintenance/validate-all.sh`\n   - `scripts/repo-maintenance/sync-shared.sh`\n   - `scripts/repo-maintenance/release.sh`\n   - protected branches, when configured, require the GitHub Actions check context `validate` rather than `Validate Repo Maintenance / validate`\n10. Hand off ongoing engineering work cleanly:\n   - recommend `xcode-build-run-workflow` or `xcode-testing-workflow` for active Xcode collaboration after the repo guidance is aligned\n   - recommend `bootstrap-xcode-app-project` only when the user actually needs a fresh repo instead of guidance sync\n\n## Inputs\n\n- `repo_root`: optional absolute or relative path to the repository root; defaults to `.`\n- `workspace_path`: optional path used only to improve Xcode-project discovery when repo-root detection is ambiguous\n- `skip_validation`: optional flag to skip post-sync file validation\n- `dry_run`: optional flag to emit the planned contract without writing files\n- Defaults:\n  - runtime entrypoint: executable `scripts/run_workflow.py`\n  - `repo_root=.` when omitted\n  - `writeMode=sync-if-needed`\n  - validation runs unless `--skip-validation` is passed\n  - successful mutating runs refresh `maintain-project-repo` output in place\n\n## Outputs\n\n- `status`\n  - `success`: guidance sync completed or was already satisfied\n  - `blocked`: prerequisites, repo classification, or sync policy prevented completion\n  - `failed`: the sync path started but did not complete successfully\n- `path_type`\n  - `primary`: the documented sync path completed\n  - `fallback`: a non-mutating guided result was returned\n- `output`\n  - resolved repo root\n  - detected workspace or project markers\n  - `AGENTS.md` path\n  - actions applied or planned\n  - refreshed `maintain-project-repo` paths\n  - validation result\n  - one concise next step or handoff\n\n## Guards and Stop Conditions\n\n- Stop with `blocked` if the repo root cannot be resolved.\n- Stop with `blocked` if the repo does not contain an `.xcodeproj` or `.xcworkspace`.\n- Stop with `blocked` if the repo appears to be a SwiftPM-only package without Xcode-managed app markers.\n- Stop with `blocked` if the chosen `writeMode` does not allow the mutation the repo still needs, such as creating a missing `AGENTS.md` or appending the bounded Xcode guidance section.\n- Stop with `blocked` if the target `AGENTS.md` path exists but is not a regular file.\n\n## Fallbacks and Handoffs\n\n- The only current fallback is a non-mutating dry-run or guided result that explains what the sync would do.\n- After a successful sync, hand off ongoing build, run, diagnostics, preview, and mutation work to `xcode-build-run-workflow`.\n- After a successful sync, hand off ongoing test execution and test diagnosis work to `xcode-testing-workflow`.\n- After a successful sync, use `scripts/repo-maintenance/validate-all.sh` for local maintainer validation and `scripts/repo-maintenance/release.sh --mode standard --version vX.Y.Z` from a feature branch or worktree for protected-main releases.\n- After a successful sync, configure protected branches to require `validate` for the managed repo-maintenance workflow; GitHub exposes that job check context directly rather than the workflow title plus job string.\n- Recommend `bootstrap-xcode-app-project` when the repository still needs to be created from scratch.\n- Recommend `sync-swift-package-guidance` when the repo is a plain Swift package rather than an Xcode app project.\n\n## Customization\n\n- Use `references/customization-flow.md`.\n- `scripts/customization_config.py` stores and reports customization state.\n- `scripts/run_workflow.py` loads runtime-safe defaults from customization state before invoking the supported sync path.\n- The current runtime-enforced customization surface is one `writeMode` knob that controls whether the workflow may create missing `AGENTS.md`, append the bounded Xcode section, or stay report-only.\n- Run the Python wrapper and customization entrypoints through `uv`, because they rely on inline `PyYAML` script metadata rather than a repo-global Python environment.\n- In consuming repos, the supported path is `uv run scripts/run_workflow.py ...` and `uv run scripts/customization_config.py ...`; do not assume plain `python` or `python3` will have the needed YAML dependency installed.\n\n## References\n\n### Workflow References\n\n- `references/project-detection.md`\n\n### Contract References\n\n- `references/automation-prompts.md`\n- `references/customization-flow.md`\n\n### Support References\n\n- `assets/AGENTS.md`\n- `assets/append-section.md`\n- Recommend `references/snippets/apple-xcode-project-core.md` when an existing Xcode repo needs the reusable baseline policy content in a human-reviewable form.\n- `references/snippets/apple-xcode-project-core.md`\n\n### Script Inventory\n\n- `scripts/run_workflow.py`\n- `scripts/sync_xcode_project_guidance.py`\n- `scripts/customization_config.py`","tags":["sync","xcode","project","guidance","apple","dev","skills","gaelic-ghost","agent-skills","apple-development","apple-docs","apple-docs-mcp"],"capabilities":["skill","source-gaelic-ghost","skill-sync-xcode-project-guidance","topic-agent-skills","topic-apple-development","topic-apple-docs","topic-apple-docs-mcp","topic-codex","topic-codex-app","topic-codex-cli","topic-codex-skills","topic-dash-docsets","topic-ios","topic-macos","topic-swift"],"categories":["apple-dev-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/gaelic-ghost/apple-dev-skills/sync-xcode-project-guidance","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add gaelic-ghost/apple-dev-skills","source_repo":"https://github.com/gaelic-ghost/apple-dev-skills","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (10,948 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:13:59.224Z","embedding":null,"createdAt":"2026-05-18T13:21:11.715Z","updatedAt":"2026-05-18T19:13:59.224Z","lastSeenAt":"2026-05-18T19:13:59.224Z","tsv":"'/documentation/swiftui/app)':663 '/documentation/swiftui/scene)':674 '/documentation/swiftui/windowgroup)':679 '/documentation/xcode/creating_an_xcode_project_for_an_app)':651 '/gaelic-ghost/productivity-skills)':161 '/gaelic-ghost/socket)':214 '/socket':224 '1':528 '10':935 '2':544 '3':585 '4':707 '5':755 '6':775 '7':813 '8':875 '9':900 'absolut':986 'action':925,1128 'activ':401,954 'actual':973 'ad':265 'add':24,209,220 'agents.md':29,91,264,487,781,787,800,820,1126,1214,1228,1438 'align':28,83,495,962 'allow':1202 'alongsid':110 'alreadi':281,563,790,1079 'ambigu':1014 'anchor':630 'app':14,41,62,87,108,261,377,382,464,552,648,653,658,660,967,1191,1363,1393 'app-repo':551 'appear':1179 'append':96,807,1216,1439 'appl':13,86,137,241,376,588,598,605,610,635,697 'apple-dev-skil':136,240 'appli':120,586,708,721,776,1129 'assets/agents.md':785,1512 'assets/append-section.md':808,1513 'assum':1490 'avail':197 'b':52 'back':741 'baselin':69,274,1524 'behavior':97,124 'block':1081,1152,1162,1175,1195,1224 'bootstrap':380,578,965,1361 'bootstrap-xcode-app-project':379,964,1360 'bound':94,811,1218,1441 'boundari':619 'branch':919,1319,1333 'bring':58 'brought':298 'build':346,394,829,945,1269,1279 'cannot':1157 'chang':627,720 'check':171,926,1348 'chosen':1198 'classif':1084 'classifi':545 'clean':941 'codex':178,217,231 'collabor':956 'collect':529 'commit':751,855 'companion':125,155,200 'complet':1076,1089,1098,1107 'composit':665 'concis':1141 'condit':1149 'configur':921,1331 'conflict':688,693 'consum':1475 'contain':564,791,1168 'content':1526 'context':927,1349 'continu':557,558 'contract':1034,1506 'control':1431 'copi':784 'creat':642,1211,1372,1436 'creation':92,336,640 'current':122,177,271,314,628,685,1242,1420 'custom':1395,1402,1411,1424,1454 'dash':602 'date':301 'debug/release':753 'default':994,1038,1409 'depend':1500 'detail':723 'detect':761,1012,1121 'determinist':90 'dev':138,242 'developer.apple.com':650,662,673,678 'developer.apple.com/documentation/swiftui/app)':661 'developer.apple.com/documentation/swiftui/scene)':672 'developer.apple.com/documentation/swiftui/windowgroup)':677 'developer.apple.com/documentation/xcode/creating_an_xcode_project_for_an_app)':649 'diagnosi':440,1293 'diagnost':349,404,1271 'direct':845,1350 'directori':234 'discov':132,185 'discoveri':1007 'doc':350,405,589,606,612,682,698 'document':599,617,629,1104 'downstream':483 'dri':542,1026,1250 'dry-run':1249 'emit':1031 'enforc':1423 'engin':939 'entrypoint':117,1040,1455 'environ':1473 'execut':75,317,403,1041,1290 'exist':11,36,60,85,256,357,389,419,443,549,788,801,821,1230,1518 'expect':67,910 'explain':1256 'explicit':322,704 'export':508 'expos':174,204,238,1345 'extra':889 'fail':1090 'fallback':168,1108,1237,1243 'featur':1318 'file':152,409,747,797,825,840,860,898,912,1024,1037,1236 'file-membership':408,746 'filesystem':166 'filesystem-level':165 'first':170,600,607,732 'flag':1018,1029 'follow':412 'follow-through':411 'form':1532 'found':701 'fresh':976 'futur':236 'gaelic':222 'gaelic-ghost':221 'gate':590 'generat':873 'ghost':223 'github':924,1344 'github.com':160,213 'github.com/gaelic-ghost/productivity-skills)':159 'github.com/gaelic-ghost/socket)':212 'github/workflows/validate-repo-maintenance.yml':884 'give':164 'global':1471 'guard':1146 'guid':1113,1253 'guidanc':5,8,33,56,68,82,112,145,292,311,451,481,554,583,594,626,641,655,666,686,719,754,818,905,960,980,1074,1220,1380 'guidance-sync':144 'hand':936,1266,1286 'handoff':1145,1239 'har':184 'harness-discov':183 'human':1530 'human-review':1529 'improv':1003 'includ':89,634 'inlin':1462 'input':532,760,982 'insid':355,417,441 'instal':140,226,522,1501 'instead':460,978 'instruct':169 'inventori':1535 'invok':1414 'io':38,258 'ipado':40,260 'job':1347,1357 'keep':795 'knob':1429 'lack':803 'level':167,512 'librari':369 'lifecycl':654 'load':1405 'local':521,604,724,1307 'lookup':351,406 'maco':37,257 'made':321 'main':73,1325 'maintain':101,190,490,497,878,911,1065,1134,1308 'maintain-project-repo':100,189,489,877,1064,1133 'mainten':151,904,933,1342 'make':716 'manag':16,737,769,793,805,897,1190,1339 'marker':1125,1192 'marketplac':215,219 'may':1435 'membership':410,748 'mention':826 'merg':25,268 'metadata':1465 'miss':783,1213,1437 'mode':1312 'mutat':143,353,415,1061,1112,1204,1248,1274 'narrow':315 'nativ':12,375 'need':263,614,974,1051,1208,1369,1498,1521 'new':334,576 'new-project':333,575 'next':1142 'no-direct':843 'non':1111,1247 'non-mut':1110,1246 'normal':759 'note':498 'noth':338 'offici':609 'omit':1046 'onboard':293 'one':1140,1427 'ongo':938,1268,1288 'option':535,538,541,985,998,1017,1028 'ordinari':345 'output':493,1068,1071,1117 'overload':71 'own':79 'packag':368,450,459,1186,1379,1388 'part':894 'pass':1059 'path':147,526,537,779,989,997,999,1093,1100,1106,1127,1137,1229,1418,1479 'pbxproj':750,846,851 'place':1070 'plain':366,457,504,1386,1491 'plan':745,774,1033,1131 'plugin':126,162,218,229,233,469 'plus':1356 'point':907 'polici':297,473,714,725,1087,1525 'post':1022 'post-sync':1021 'prefer':601 'prerequisit':1082 'preserv':728,841,861,885 'prevent':1088 'preview':407,1272 'primari':1102 'primarili':431 'proceed':706 'product':157,187,246 'productivity-skil':156,186,245 'profil':109 'project':4,31,55,102,191,291,335,359,383,421,445,465,480,491,577,639,645,713,738,742,874,879,968,1006,1066,1124,1135,1364,1394 'project-cr':638 'propos':624 'protect':918,1324,1332 'protected-main':1323 'protocol':659 'purpos':57 'python':1451,1472,1492 'python3':1494 'pyyaml':1463 'rather':929,1351,1389,1466 'read':595 'realli':574,766 'recommend':378,391,422,446,475,942,963,1359,1375,1514 'refer':1502,1504,1507,1511 'references/automation-prompts.md':1508 'references/customization-flow.md':1397,1509 'references/project-detection.md':1505 'references/snippets/apple-xcode-project-core.md':727,1515,1533 'refresh':26,148,266,876,881,883,1063,1132 'regular':1235 'relat':988 'releas':1326 'relev':228,597,696 'reli':621,1460 'repo':7,42,81,88,103,150,192,262,310,325,386,454,484,492,507,520,533,553,562,625,718,764,817,870,880,887,932,959,977,983,1010,1043,1067,1083,1119,1136,1155,1165,1178,1206,1341,1383,1470,1476,1520 'repo-glob':1469 'repo-guid':80,717 'repo-loc':519 'repo-mainten':149,1340 'repo-root':1009 'repo-specif':886 'report':691,1401,1447 'report-on':1446 'repositori':15,63,280,501,992,1367 'request':547,572 'requir':127,531,922,1335 'rerun':476 'resolv':1118,1159 'result':1114,1139,1254 'return':1116 'reusabl':1523 'review':1531 'root':534,984,993,1011,1044,1120,1156 'rule':294,847,856,868 'run':99,348,395,543,756,830,946,1027,1053,1062,1251,1270,1280,1449,1482,1486 'runtim':116,1039,1407,1422 'runtime-enforc':1421 'runtime-saf':1406 'safe':1408 'satisfi':1080 'say':503,702 'scene':664,668,671 'scratch':1374 'script':890,1464,1534 'scripts/customization_config.py':1398,1487,1538 'scripts/repo-maintenance':882 'scripts/repo-maintenance/hooks/pre-commit.sample':914 'scripts/repo-maintenance/release.sh':917,1311 'scripts/repo-maintenance/sync-shared.sh':916 'scripts/repo-maintenance/validate-all.sh':915,1305 'scripts/run_workflow.py':113,757,1042,1404,1483,1536 'scripts/sync_xcode_project_guidance.py':119,1537 'section':95,794,806,812,1221,1443 'session':179,237 'set':899 'shape':592,771 'share':710 'ship':518 'simplic':731 'simplicity-first':730 'singl':525 'single-path':524 'skill':76,78,129,139,158,173,188,201,243,247,253,277,304,318,331,343,364,513 'skill-sync-xcode-project-guidance' 'skip':539,1015,1020,1056 'skip-valid':1055 'socket':211 'sourc':865 'source-gaelic-ghost' 'source-of-truth':864 'specif':888 'stage':853 'stage-and-commit':852 'standalon':135 'standard':1313 'start':1094 'state':615,1403,1412 'status':1072 'stay':494,1445 'step':1143 'still':906,1207,1368 'stop':569,689,1148,1150,1160,1173,1193,1222 'store':1399 'string':1358 'success':1060,1073,1099,1264,1284,1302,1329 'support':1416,1478,1510 'surfac':474,1425 'swift':367,433,449,458,733,1378,1387 'swiftformat':913 'swiftpm':581,1184 'swiftpm-on':580,1183 'swiftui':652,734 'sync':2,6,53,123,146,448,478,555,584,773,778,816,824,839,859,903,981,1023,1049,1075,1086,1092,1105,1259,1265,1285,1303,1330,1377,1417 'sync-if-need':1048 'sync-swift-package-guid':447,1376 'sync-xcode-project-guid':1,477 'target':1227 'task':399,429 'tell':205 'templat':687 'test':347,425,434,439,744,835,951,1289,1292,1298 'test-plan':743 'titl':1355 'today':514 'tool':371 'top':511 'top-level':510 'topic-agent-skills' 'topic-apple-development' 'topic-apple-docs' 'topic-apple-docs-mcp' 'topic-codex' 'topic-codex-app' 'topic-codex-cli' 'topic-codex-skills' 'topic-dash-docsets' 'topic-ios' 'topic-macos' 'topic-swift' 'track':749,850 'truth':867 'type':1101 'unchang':798 'unless':1054 'updat':467 'use':34,50,181,250,251,275,302,329,341,362,872,1000,1304,1396 'user':21,207,289,307,972 'uv':1457,1481,1485 'valid':540,814,928,931,934,1016,1025,1052,1057,1138,1309,1336 'verifi':819,822,837,857,901 'version':1314 'vx.y.z':1315 'want':22,290,308 'web':611 'whether':762,1432 'windowgroup':670,676 'without':70,1035,1187 'work':354,416,940,1275,1294 'workflow':32,193,273,296,396,426,523,527,593,618,633,831,836,947,952,1281,1299,1343,1354,1434,1503 'workspac':536,996,1122 'worktre':1321 'would':1260 'wrapper':1452 'write':1036 'writemod':1047,1199,1428 'xcode':3,18,54,61,74,107,272,316,358,381,393,402,420,424,444,463,472,479,550,637,644,712,736,768,828,834,944,950,955,966,1005,1189,1219,1278,1297,1362,1392,1442,1519 'xcode-app':106 'xcode-build-run-workflow':392,827,943,1277 'xcode-manag':735,767,1188 'xcode-polici':471 'xcode-project':711,1004 'xcode-testing-workflow':423,833,949,1296 'xcodegen':740,863 'xcodegen-back':739 'xcodeproj':45,284,566,1170 'xctest':435 'xctestplan':437 'xcuitest':436 'xcworkspac':47,286,568,1172 'yaml':1499 'yet':390","prices":[{"id":"014bc03e-08ba-4c9a-a95f-49f4fc6daca4","listingId":"1839d59c-ab99-4a9a-a6f7-659401d02ea6","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"gaelic-ghost","category":"apple-dev-skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:11.715Z"}],"sources":[{"listingId":"1839d59c-ab99-4a9a-a6f7-659401d02ea6","source":"github","sourceId":"gaelic-ghost/apple-dev-skills/sync-xcode-project-guidance","sourceUrl":"https://github.com/gaelic-ghost/apple-dev-skills/tree/main/skills/sync-xcode-project-guidance","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:11.715Z","lastSeenAt":"2026-05-18T19:13:59.224Z"}],"details":{"listingId":"1839d59c-ab99-4a9a-a6f7-659401d02ea6","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"gaelic-ghost","slug":"sync-xcode-project-guidance","github":{"repo":"gaelic-ghost/apple-dev-skills","stars":7,"topics":["agent-skills","apple-development","apple-docs","apple-docs-mcp","codex","codex-app","codex-cli","codex-skills","dash-docsets","ios","macos","swift","swift-package-manager","swift-toolchain","swiftly","swiftpm","xcode","xcode-mcp","xcodebuild","xcrun"],"license":"apache-2.0","html_url":"https://github.com/gaelic-ghost/apple-dev-skills","pushed_at":"2026-05-13T01:26:51Z","description":"Apple Dev Workflows for Codex | Now Available in Socket Marketplace","skill_md_sha":"043c91d538e4ac93456f0f274be3d4d9cdce75b9","skill_md_path":"skills/sync-xcode-project-guidance/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/gaelic-ghost/apple-dev-skills/tree/main/skills/sync-xcode-project-guidance"},"layout":"multi","source":"github","category":"apple-dev-skills","frontmatter":{"name":"sync-xcode-project-guidance","description":"Sync repo guidance for an existing native Apple app repository managed through Xcode when the user wants to add, merge, refresh, or align AGENTS.md and project workflow guidance. Use for existing macOS, iOS, or iPadOS app repos with an .xcodeproj or .xcworkspace. Do not use for brand-new app bootstrap or plain Swift packages."},"skills_sh_url":"https://skills.sh/gaelic-ghost/apple-dev-skills/sync-xcode-project-guidance"},"updatedAt":"2026-05-18T19:13:59.224Z"}}