Unfuck AI Comments — AI skill for Claude Code

unfuck-ai-comments [](https://github.com/umputun/unfuck-ai-comments/actions/workflows/ci.yml) [](https://coveralls.io/github/umputun/unfuck-ai-comments?branch=master)

A simple CLI tool that converts all comments inside Go functions and structs to lowercase while preserving comments for packages and function definitions, as well as special indicator comments like TODO and FIXME. This makes comments in code consistent and easier to read.

Motivation

Modern AI coding assistants like GitHub Copilot, Claude, and ChatGPT have become invaluable tools for many developers. However, they often generate code with inconsistent comment styling, including:

• ALL UPPERCASE comments for emphasis
• Initial Uppercase Words for pseudo-titles
• Mixed Case comments that Don't Follow conventions

For example:

func ProcessData(data []byte) error {
    // CHECK FOR EMPTY INPUT
    if len(data) == 0 {
        return errors.New("empty data")
    }
    
    // Important: Validate Data Before Processing
    if !isValid(data) {
        return errors.New("invalid data format")
    }
    
    // This Function handles Multiple Formats
    switch determineFormat(data) {
        // Process Each Format differently
        // ...
    }
}

This inconsistent capitalization clashes with Go's conventional style where in-function comments typically use lowercase sentences. While these AI-generated comments are helpful in the moment, they create visual noise and inconsistency in codebases.

This tool automatically normalizes comments to match standard Go code conventions, ensuring your codebase maintains a consistent style regardless of whether the code was written by a human or generated by AI.

The tool is smart enough to preserve proper documentation comments (package comments and function