author-swift-docc-docs

What problem does it solve?

Provide a focused, repo-aware workflow for writing and reviewing DocC documentation so authors can produce structurally correct symbol comments, articles, extension files, landing pages, and topic groups without accidentally drifting into unrelated Apple docs lookup or build/export work.

Core Features & Use Cases

• Repo-shape classification: Detect whether a repository is a Swift package or an Xcode app/framework and surface detected manifests, workspaces, and .docc catalogs.
• Task inference and gating: Classify requests into symbol-docs, article, structure, review, or tutorial-aware-review and enforce tutorial-depth boundaries via configurable knobs.
• Handoffs and contracts: Produce a clear JSON contract that either keeps work local to DocC authoring/review or hands off to explore-apple-swift-docs, swift-package-build-run-workflow, or xcode-build-run-workflow for lookup or execution tasks.
• Customizable behavior: Respect per-skill customization for tutorial handling and persist durable settings in a user config location.

Quick Start

Ask the skill to inspect your repository and infer the DocC task by running the workflow with your repo path and an optional task description.