Review and improve software comments and documentation quality.
npx skills add https://github.com/codybrom/clairvoyance --skill comments-docs
Please help me install this Agent Skill. Skill: comments-docs Source: https://github.com/codybrom/clairvoyance/tree/main/skills/comments-docs Command: npx skills add https://github.com/codybrom/clairvoyance --skill comments-docs
This Skill helps developers identify missing, misleading, or redundant comments and improve documentation so interfaces communicate intent, constraints, and design decisions clearly.
Ask the comments-docs skill to review the comments and documentation quality in the specified file or module.
High-intent search queries and answers about installing and using this skill.
Identify stale or redundant explanations by evaluating whether comments align with current code behavior and abstraction quality, detecting leaky abstractions and misleading documentation that fail to communicate design decisions.
Apply comment quality review during a code review to find undocumented public methods, detect stale explanations, and identify comments that should be replaced by clearer abstractions rather than patching poor design with text.
When comments are difficult to write because the underlying design is too complex, it signals that the interface design itself needs improvement rather than additional explanatory documentation to compensate for poor abstraction quality.
The audit detects comments that repeat code, expose leaky abstractions, or fail to clarify design decisions, providing actionable feedback to improve documentation structure and align explanations with actual software architecture.
calcomEvaluate HTML, CSS, and JS code against Web Interface Guidelines.
mostafa-ismail-2004Writes rationale-focused code comments explaining intent, constraints, and non-obvious decisions.
JylhisDetect Go vulnerabilities using govulncheck, static analysis, and DREAD scoring.
sjunglingReview and structure Markdown technical documentation for accuracy and accessibility.
