| name | review-docs |
| description | Review and improve Syncpack documentation for clarity, completeness, and consistency. Use when enhancing docs or validating before publication. |
Review Docs
Review and improve Syncpack documentation against project standards.
When to Use
- Validating docs before publication
- Improving existing documentation
- Ensuring consistency across pages
- User reports documentation is unclear
Related Skills
Use with:
document-code — Reference for structure and locationssignal-over-noise — Apply to remove filler and obvious explanationsfront-loading — Ensure actionable information comes first
Your Task
Given a documentation path, review content against standards. Suggest concrete improvements.
Quality Checklist
Review Process
- Read the documentation file
- Cross-reference structure with similar docs
- Identify information gaps where users might get stuck
- Check for shared partials at
site/src/_partials/
- Apply signal-over-noise: Can you cut 20% of words without losing meaning?
Review Output
Provide structured feedback:
Current State
- Assessment of documentation quality and coverage
Issues Found
- Specific problems with locations (section names or line references)
- Prioritize by impact: clarity > completeness > polish
Recommendations
- Concrete improvements with examples
- Rewrite short sections if needed
- Flag missing content or examples
- Suggest shared partials to reuse
Priority Actions
- Top 2-3 changes to make immediately
Reference
Docs: site/src/content/docs/
Shared partials: site/src/_partials/
Source of truth: src/ (Rust implementation)
Local testing: cd site && pnpm run dev then verify at http://localhost:4321/syncpack
