sync comment-audit / comment-trim skills with latest content

[Timofei Larkin (lllamnyp)]

Summary

Syncs cozystack:comment-audit and cozystack:comment-trim with content updates made to the upstream working versions of these skills since they were shipped. Preserves ccp's own conventions (phase structure, does/does-not statement, genericized wording) and ports only the genuine behavior changes:

• comment-audit: adds a fifth pass that sorts every surviving comment into Keep or Tighten — catching the common case of a block whose claims are all legitimate but stated at three times the necessary length. Also adds a reading check to the duplication sweep: grep only catches copy-pasted phrasing, so surviving blocks now also get checked against nearby field docs / signatures for paraphrased duplication grep would miss. Report format gains a ## Tighten section.
• comment-trim: adds the matching Tighten cut category, an explicit rule that a pointer replaces the prose it cites rather than sitting alongside it, and a third verification check ("pointer invariant") that greps for a leftover explanation next to any pointer that was added.
• plugins/cozystack/.claude-plugin/plugin.json: updated the comment-audit / comment-trim descriptions to mention tightening and the new verification check, and bumped version to 1.17.0 (minor — new behavior, no breaking change).

scripts/comments-only.py is unchanged (verified identical to the upstream copy).

Test plan

• bash tools/check-refs.sh passes (cross-references, skill-name mentions, and the private-content scan all clean)
• jq . validates plugin.json
• Both SKILL.md files re-read cold after editing — no internal references, repo names, or PR numbers present

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 6d5644be-322c-4aca-9706-7ed0d6e54863

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}