# Comment Conventions

> Language-agnostic code commenting and docblock conventions — present-tense comments, dev-focused content, mandatory docblocks on new functions/methods/components, a 3-source-line descending-length cap on docblock prose, and a no-chatter rule for inline comments (no prose walls, no business-logic essays, no step-by-step narration in the code path). Auto-fixes non-compliant docblocks and inline-comment walls on existing functions in the file being edited, leaving unusually long deliberate docblock

## Facts
- Page: https://tashan.sh/capability/plugin-rvanbaalen-skills-comment-conventions
- tashan id: plugin:rvanbaalen/skills/comment-conventions
- Source: https://github.com/rvanbaalen/skills
- Type: plugin
- Category: productivity
- tashan score: 37.0 / 100
- Adoption: 7.0
- Upkeep: 64.0
- Freshness: 99.0
- Evidence coverage: 84% of the inputs this score can use
- Health: active
- Instruction depth: not yet graded
- Official: no

## Install

```sh
/plugin marketplace add rvanbaalen/skills
/plugin install comment-conventions@rvanbaalen
```

## Security audit
Not scanned. We audit npm-published capabilities; this one has no npm package we can resolve, or has not reached the queue. This is not a clean bill of health.

---
Measured 2026-08-05 by tashan (https://tashan.sh) from public evidence. Scorer s5.