author-swift-docc-docs
Installation
SKILL.md
Author Swift DocC Docs
Purpose
Provide the canonical DocC authoring-and-review workflow for Swift package and Xcode app or framework repositories. scripts/run_workflow.py is the runtime wrapper for repo-shape detection, task classification, tutorial-depth boundaries, and clean handoffs to the Apple docs and execution skills the documentation must be in English.
When To Use
- Use this skill for in-source symbol documentation work that is meant to compile into DocC output.
- Use this skill for DocC article writing and review.
- Use this skill for DocC extension-file, landing-page, topic-group, and catalog-structure work.
- Use this skill when the user wants a DocC-oriented review pass for clarity, content accuracy, or DocC-specific structure quality.
- Use this skill when the user wants help deciding whether content belongs in source comments, articles, extension files, or landing pages.
- Use this skill for tutorial-aware DocC review when the user clearly wants DocC tutorial help but the task is still mainly about authoring shape and conceptual flow rather than directive-deep mechanics.
- Recommend
explore-apple-swift-docswhen the user really needs broader Apple or Swift documentation lookup, WWDC-material lookup, or directive-reference lookup instead of DocC authoring or review work. - Recommend
swift-package-build-run-workflowwhen a Swift package repo needsswift packageor build-oriented DocC follow-through such as generation, export, archive inspection, or package-shape execution work. - Recommend
xcode-build-run-workflowwhen an Xcode app or framework repo needsProduct > Build Documentation,xcodebuild docbuild, export, archive, or project-integrity follow-through.