go-nolint-audit

Audit Go nolint directives for staleness and weak justifications.

19|3|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/dirien/yet-another-agent-harness --skill go-nolint-audit-dirien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: go-nolint-audit
Source: https://github.com/dirien/yet-another-agent-harness/tree/main/.claude/skills/go-nolint-audit
Command: npx skills add https://github.com/dirien/yet-another-agent-harness --skill go-nolint-audit-dirien

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill finds stale or lazily justified nolint directives in Go codebases and provides a safe, evidence-based path to remove or improve them, reducing hidden technical debt and noisy suppressions.

Core Features & Use Cases

  • Mechanical verification of named rule suppressions using golangci-lint to detect truly stale directives without editing source files.
  • Scoring guidance and adversarial Red/Blue/White debates on top offenders that produce concrete diffs or rewritten justifications.
  • Use cases include onboarding into inherited repositories, periodic cleanup sweeps, and preventing unchecked growth of nolint usage during code-quality initiatives.

Quick Start

Audit the repository for nolint directives, verify each with golangci-lint, and propose removals with concrete diffs or rewritten justifications.

Frequently Asked Questions about go-nolint-audit

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

FAQPage Schema
How do I find and remove stale nolint directives in a Go codebase?

You can audit Go nolint directives by mechanically verifying each suppression with golangci-lint to detect stale or weakly justified instances, then applying concrete diffs or rewritten justifications to safely remove them.

What is a stale nolint directive in golangci-lint?

A stale nolint directive is a lint suppression comment that no longer suppresses an active linting error. Mechanical verification using golangci-lint detects these directives without editing source files.

How do I clean up inherited Go repositories with growing nolint counts?

You can perform a periodic cleanup sweep or onboarding audit by scoring nolint directives, generating adversarial Red/Blue/White recommendations, and applying concrete diffs to remove hidden technical debt.

Does the Go nolint audit require golangci-lint installed locally?

Yes, auditing nolint directives requires both Go and golangci-lint installed in your environment to mechanically verify named rule suppressions and generate evidence-based removal guidance.

How do I improve weak justifications on nolint comments without breaking code?

You can improve weak nolint justifications by applying adversarial Red/Blue/White debates to top offenders, producing rewritten justifications or concrete diffs that maintain code safety while reducing noisy suppressions.

What is the best way to audit Go code quality and prevent unchecked nolint growth?

The best way to audit Go code quality is running mechanical verification on nolint directives with golangci-lint, scoring top offenders, and generating concrete diffs during code-quality initiatives to prevent unchecked suppression growth.