skills.rest
gaelic-ghost
gaelic-ghostCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

sync-swift-package-guidance

Sync AGENTS.md and repo-maintenance guidance for existing Swift Package repositories.

9|1|Updated Feb 27, 2026
Search Tags:#automation#swift#sync#xcode#agents.md#swiftpm#repo-maintenance
One-click install
npx skills add https://github.com/gaelic-ghost/apple-dev-skills --skill sync-swift-package-guidance
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-swift-package-guidance
Source: https://github.com/gaelic-ghost/apple-dev-skills/tree/main/skills/sync-swift-package-guidance
Command: npx skills add https://github.com/gaelic-ghost/apple-dev-skills --skill sync-swift-package-guidance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML>=6.0.2,<7, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Bring an existing Swift Package Manager repository's maintainer guidance and AGENTS.md up to a shared baseline so contributors and automation have a consistent, documented workflow without accidentally bootstrapping or overwriting app-focused guidance.

Core Features & Use Cases

  • Deterministic AGENTS.md management: create AGENTS.md from a managed template, append a bounded Swift package guidance section, or leave an already-managed file unchanged.
  • Repo classification and guards: detect Package.swift and Xcode markers, block ambiguous roots, and enforce file-type and write-mode safety checks before mutating files.
  • Tooling refresh and validation: refresh the swift-package repo-maintenance toolkit files, validate the synced guidance contains required anchors, and surface clear next steps for handoff to package build or testing workflows.
  • Use Case: When a mono-repo or legacy Swift package drifts from the shared policy, run the skill to merge in guidance and keep the repo-maintenance scripts aligned.

Quick Start

Run the sync wrapper on the existing repository root to create or merge AGENTS.md, refresh the swift-package maintenance toolkit, and validate the guidance in one pass.

Frequently Asked Questions about sync-swift-package-guidance

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

FAQPage Schema
How do I add AGENTS.md to an existing Swift Package repository?▼

To add AGENTS.md to an existing Swift Package, the skill copies a managed template or appends a bounded Swift package section, detecting Package.swift markers to ensure correct placement without bootstrapping a new package.

What is the best way to sync repo-maintenance guidance for a SwiftPM project?▼

Syncing repo-maintenance guidance for a SwiftPM project involves refreshing the swift-package maintenance toolkit files and validating that the synced output contains required guidance anchors for consistent contributor workflows.

Can I use this to align Xcode app project guidance instead of Swift Package guidance?▼

You cannot use this to align Xcode app project guidance because the skill enforces file-type guards and specifically blocks ambiguous roots, operating only on Swift Package repositories where Package.swift exists.

Does the AGENTS.md sync process overwrite existing repository guidance?▼

The AGENTS.md sync process does not overwrite existing repository guidance, as it enforces write-mode safety checks and leaves an already-managed file unchanged to prevent accidental data loss.

Why does my mono-repo Swift package fail the ambiguity and file-type guards?▼

A mono-repo Swift package fails the ambiguity and file-type guards when the root directory contains conflicting Xcode markers, which the skill blocks to prevent accidentally overwriting app-focused guidance.

What happens after refreshing the swift-package repo-maintenance toolkit?▼

After refreshing the swift-package repo-maintenance toolkit, the skill validates the synced guidance contains required anchors and surfaces clear next steps for handoff to package build or testing workflows.

Related Skills

Explore More Software Engineering Skills→
gaelic-ghostgaelic-ghost
6

swift-package-build-run-workflow

Build and run Swift packages using SwiftPM commands.

Community
Advanced
gaelic-ghostgaelic-ghost
9

bootstrap-xcode-app-project

Generate XcodeGen project.yml and source files for SwiftUI Apple app repositories.

Community
Advanced
guhans6guhans6

ios-macos-repo-workflow

Generate and maintain workflow contracts for iOS/macOS repositories.

Community
Advanced
gaelic-ghostgaelic-ghost
6

bootstrap-swift-package

Bootstrap Swift packages with consistent defaults and immediate validation.

Community
Advanced