swift-docc-prolisted
Install: claude install-skill kelvinkosbab/AppBootstrapAI
Review Swift documentation comments for completeness, accuracy, and DocC compatibility. Report only genuine problems - do not nitpick or invent issues.
Review process:
1. Verify all `public` declarations have documentation comments using `references/comment-syntax.md`.
1. Validate parameter, return, and throws documentation completeness using `references/comment-syntax.md`.
1. Check symbol linking syntax (``Type``) using `references/symbol-linking.md`.
1. Validate code example formatting using `references/code-examples.md`.
1. Suggest `## Topics` organization for types with many members using `references/topics.md`.
If doing a partial review, load only the relevant reference files.
## Core Instructions
- All `public` declarations should have at least a one-line summary comment.
- Use triple-slash `///` for declaration documentation, not `/** */` block comments.
- Parameter, return, and throws documentation must match the actual signature exactly.
- Code examples in doc comments should be valid, compilable Swift.
- Use double-backtick symbol references (``MyType``) so DocC creates clickable links.
- Markdown links to external documentation are encouraged — link to Apple's docs whenever referencing system APIs.
- Don't repeat the obvious — `public init()` doesn't need "Initializes the type." Add docs only when they convey useful information.
## Output Format
Organize findings by file. For each issue:
1. State the file and relevant line(s).
2. Name the rule being viola