comment-checker

Resolve comment-checker warnings after edit-like tool calls in Codex workflows.

5|Updated May 17, 2026
One-click install
npx skills add https://github.com/islee23520/lfg --skill comment-checker-islee23520
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comment-checker
Source: https://github.com/islee23520/lfg/tree/main/skills/comment-checker
Command: npx skills add https://github.com/islee23520/lfg --skill comment-checker-islee23520

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you interpret automatic comment-checker warnings that appear after edit-like tool actions, so you know when to fix a flagged comment or explain why it is acceptable.

Core Features & Use Cases

  • Blocking feedback handling: Treats warning output from the PostToolUse hook as actionable guidance after apply_patch, write, edit, multi_edit, or multiedit calls.
  • Focused scope: Ignores non-edit tools and does not expose an MCP tool, keeping behavior narrow and predictable.
  • Failure-tolerant behavior: Continues normal work when the checker binary is missing because the hook emits no output in that case.
  • Use case: After changing code, a warning appears about a comment that may be confusing or unnecessary; use this Skill to decide whether to revise the comment or justify keeping it.

Quick Start

Use the comment-checker skill to review the latest blocking warning and tell me whether I should fix the comment or explain why it is correct.

Frequently Asked Questions about comment-checker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resolve PostToolUse hook warnings for code comments after apply_patch?

To resolve PostToolUse hook warnings for code comments after apply_patch, review the blocking feedback emitted by the comment-checker and decide whether to revise the flagged comment or justify why it is acceptable.

Does the comment-checker hook block work for non-edit tool calls?

No, the comment-checker hook does not block work for non-edit tool calls. It specifically ignores non-edit tools and only applies to apply_patch, write, edit, multi_edit, and multiedit operations.

What happens when the comment-checker binary is missing during a Codex workflow?

When the comment-checker binary is missing during a Codex workflow, the hook emits no output, allowing normal work to continue without interruption or failure.

How do I handle automatic comment-checker feedback after editing code?

To handle automatic comment-checker feedback after editing code, treat the warning output as actionable guidance to either fix the flagged comment or explain why the current comment is correct.

Does the comment-checker skill expose an MCP tool for patch validation?

No, the comment-checker skill does not expose an MCP tool for patch validation. It keeps behavior narrow and predictable by operating only within PostToolUse hooks for edit operations.

When should I use a PostToolUse hook for comment validation?

You should use a PostToolUse hook for comment validation when you need to automatically catch and block on confusing or unnecessary comments immediately after apply_patch, write, or edit operations.