author-swift-docc-docslisted
Install: claude install-skill gaelic-ghost/socket
# Author Swift DocC Docs
## Purpose
Provide the canonical DocC authoring-and-review workflow for Swift components. `scripts/run-workflow.fsx` classifies the task and, only when execution is needed, selects SwiftPM or Xcode according to the requested generation operation.
## 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-docs` when 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-workflow` for SwiftPM DocC generation and package-oriented follow-through.
- Recommend `xcode-build-run-workflow` for `Product > Build Documentation`, `xcodebuild docbuild`, scheme, export, archive, or project-integrity follow-through.
##