← All skills

clean-comments-review

100 / 100 · Low risk

Fine to try.

By DavidSouther/ailly (GitHub) · coding · 16 stars · scanned at commit 3b72cbd

Use when reviewing the comments and DocBlocks in code for their audience and longevity, not the code's correctness. Applies when a public DocBlock enumerates current callers or describes how a symbol is used today (detail that rots when usage changes) instead of why the symbol exists, when a comment's audience is unclear (an external-reader DocBlock versus an internal line comment), or when over-documentation should be cut back to intent. Produces a critique document, not edits to the code.

Works with any agent that supports SKILL.md skills.

What this skill can do

We found nothing in the files we read that matches our rules. That does not prove the skill is safe: see the limits of static scanning.

Other copies in this repository

DavidSouther/ailly has 1 more folder with a skill named clean-comments-review. This page shows the lowest-scoring copy.

• developer/skills/clean-comments-review 100/100 · Low risk

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'clean-comments-review' ] || [ -L ~/.agents/skills/'clean-comments-review' ]; then echo 'A skill folder named clean-comments-review already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/DavidSouther/ailly' "$d" && git -C "$d" checkout --quiet '3b72cbd7d7d6d933ac8e173639b08c833d2a844a' -- 'harness/skills/clean-comments-review' && mkdir -p ~/.agents/skills && cp -R "$d"/'harness/skills/clean-comments-review' ~/.agents/skills/'clean-comments-review' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'clean-comments-review' ~/.claude/skills/'clean-comments-review' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for DavidSouther/ailly shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/DavidSouther/ailly.svg)](https://zalavijaysinh.github.io/skilltrust/repos/DavidSouther/ailly/)

Score history