sync-xcode-project-guidance

Synchronize AGENTS.md and Xcode workflow guidance for Apple app repositories.

6|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/gaelic-ghost/socket --skill sync-xcode-project-guidance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-xcode-project-guidance
Source: https://github.com/gaelic-ghost/socket/tree/main/plugins/apple-dev-skills/skills/sync-xcode-project-guidance
Command: npx skills add https://github.com/gaelic-ghost/socket --skill sync-xcode-project-guidance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Existing Xcode app repositories often drift from the recommended AGENTS.md and workflow guidance, causing inconsistencies and manual effort to keep documentation in sync.

Core Features & Use Cases

  • Detect whether the repository contains an Xcode project or workspace.
  • Create a missing AGENTS.md from a template or append a bounded Xcode workflow section when needed.
  • Validate that the guidance includes required references and refresh the Xcode‑app repo‑maintenance toolkit.
  • Ideal for macOS, iOS, or iPadOS apps that already have an .xcodeproj or .xcworkspace and need their repo guidance aligned.

Quick Start

Run sync-xcode-project-guidance on the repository root to bring AGENTS.md and Xcode guidance up to date.

Frequently Asked Questions about sync-xcode-project-guidance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync AGENTS.md with my Xcode project repository?

To sync AGENTS.md with your Xcode project repository, run a guidance synchronization process on the repository root to create or update AGENTS.md and append the bounded Xcode workflow section. This ensures your macOS or iOS app repository maintains consistent guidance documentation.

What is the best way to keep Xcode app guidance and AGENTS.md aligned?

Keeping Xcode app guidance and AGENTS.md aligned requires validating required references and refreshing the Xcode-app repo-maintenance toolkit. Using a synchronization tool prevents documentation drift and eliminates manual effort to keep workflow guidance consistent across existing Apple app repositories.

Does Xcode guidance synchronization work with existing iOS and macOS workspaces?

Xcode guidance synchronization works with existing iOS, iPadOS, and macOS apps that already contain an .xcodeproj or .xcworkspace file. It detects the project type and applies the appropriate bounded Xcode workflow section to align your repository guidance.

When do I need to update AGENTS.md for my Swift app repository?

You need to update AGENTS.md for your Swift app repository when existing documentation drifts from the recommended workflow guidance, causing inconsistencies. This synchronization process validates required references and refreshes the Xcode-app repo-maintenance toolkit to restore alignment.

Can I create a missing AGENTS.md file for my Xcode project from a template?

Yes, you can create a missing AGENTS.md file for your Xcode project from a template. The synchronization process detects if AGENTS.md is missing and generates it from a template, or appends the bounded Xcode workflow section if the file already exists but lacks the required guidance.