Agent skill

swift-docc

Official Swift DocC documentation markup and syntax reference

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/swift-docc

SKILL.md

docc

Produce rich API reference documentation and interactive tutorials for your Swift framework or package.

Documentation Structure

Essentials

  • Documenting a Swift Framework or Package (documenting-a-swift-framework-or-package.md): Create developer documentation from in-source comments, add articles with code snippets,

Documentation Content

  • Writing Symbol Documentation in Your Source Files (writing-symbol-documentation-in-your-source-files.md): Add reference documentation to your symbols that explains how to use them.
  • Adding Supplemental Content to a Documentation Catalog (adding-supplemental-content-to-a-documentation-catalog.md): Include articles and extension files to extend your source documentation comments or provide supporting conceptual content.
  • Linking to Symbols and Other Content (linking-to-symbols-and-other-content.md): Facilitate navigation between pages using links.
  • Adding Code Snippets to your Content (adding-code-snippets-to-your-content.md): Create and include code snippets to illustrate and provide examples of how to use your API.
  • Documenting API with Different Language Representations ([Documenting API with different language representations/documenting-api-with-different-language-representations.md](Documenting API with different language representations/documenting-api-with-different-language-representations.md)): Create documentation for API that's callable from more than one source language.

Structure and Formatting

  • Formatting Your Documentation Content (formatting-your-documentation-content.md): Enhance your content's presentation with special formatting and styling for text and lists.
  • Adding Tables of Data (adding-tables-of-data.md): Arrange information into rows and columns.
  • Other Formatting Options (other-formatting-options.md): Improve the presentation and structure of your content by incorporating special page elements.
  • Adding Images to Your Content (adding-images.md): Elevate your content's visual appeal by adding images.
  • Adding Structure to Your Documentation Pages (adding-structure-to-your-documentation-pages.md): Make symbols easier to find by arranging them into groups and collections.
  • Customizing the Appearance of Your Documentation Pages (customizing-the-appearance-of-your-documentation-pages.md): Customize the look and feel of your documentation webpages.

Distribution

  • Distributing Documentation to Other Developers (distributing-documentation-to-other-developers.md): Share your documentation by hosting it on a web server.

Documentation Types

  • API Documentation ([Reference Syntax/API Reference Syntax/api-reference-syntax.md](Reference Syntax/API Reference Syntax/api-reference-syntax.md)): Teach your APIs through reference documentation you create from code comments and extension files, or create detailed articles and conceptual guides.
  • Interactive Tutorials ([Reference Syntax/Tutorials Syntax/tutorial-syntax.md](Reference Syntax/Tutorials Syntax/tutorial-syntax.md)): Teach developers your Swift APIs through step-by-step, interactive content.

Shared Syntax

Usage Notes

  • Documentation is organized progressively from getting started to advanced topics
  • Start with the Introduction or Getting Started section
  • Consult specific guides for detailed information

License & Attribution

This skill contains content converted from DocC documentation format.

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results