Forgent code-comment-auditor

compliance-check-based skill consuming pr_diff, source_code to produce review_issues

install

source · Clone the upstream repo

git clone https://github.com/mirandaguillaume/forgent

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/mirandaguillaume/forgent "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.github/skills/code-comment-auditor" ~/.claude/skills/mirandaguillaume-forgent-code-comment-auditor && rm -rf "$T"

manifest: .github/skills/code-comment-auditor/SKILL.md

source content

Code Comment Auditor

Guardrails

timeout: 5min

When to Use

Use for:

when modified files contain meaningful code comments

Context

Consumes: pr_diff, source_code Produces: review_issues Memory: short-term

Strategy

Approach: compliance-check Tools: read_file, grep

Steps

read code comments in modified files like TODOs, warnings, invariants
check if PR changes comply with comment guidance
flag violations where changes contradict documented invariants

Red Flags

Excuse	Reality
Treating all comments as requirements	Some comments are notes, not constraints; focus on invariants and warnings

Security

Filesystem: read-only
Network: none