go-linting — Skillopedia

Go Linting Core Principle More important than any "blessed" set of linters: lint consistently across a codebase . Consistent linting helps catch common issues and establishes a high bar for code quality without being unnecessarily prescriptive. Resource Routing - - Run when generating a , validating the first lint pass, or producing JSON metadata. - - Use as the v2 golangci-lint baseline for established projects. Setup Procedure 1. Create with or copy 2. Run 3. If errors appear, fix them category by category (formatting first, then vet, then style) 4. Re-run until clean After generating , run…

\\t'/\\\\t}\"\n s=\"${s//

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\r'/}\"\n s=\"${s//

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\n'/\\\\n}\"\n printf '%s' \"$s\"\n}\n\nJSON_OUTPUT=false\nFORCE=false\nDRY_RUN=false\nLIMIT=50\nLOCAL_PREFIX=\"\"\n\nwhile [[ $# -gt 0 ]]; do\n case \"$1\" in\n -h|--help) usage; exit 0 ;;\n -v|--version) echo \"$SCRIPT_NAME v$VERSION\"; exit 0 ;;\n --json) JSON_OUTPUT=true; shift ;;\n --force) FORCE=true; shift ;;\n --dry-run) DRY_RUN=true; shift ;;\n --limit)\n if [[ $# -lt 2 ]]; then\n echo \"error: --limit requires a number\" >&2\n exit 2\n fi\n LIMIT=\"$2\"\n shift 2\n ;;\n -*) echo \"error: unknown option: $1\" >&2; usage >&2; exit 2 ;;\n *) LOCAL_PREFIX=\"$1\"; shift ;;\n esac\ndone\n\nif ! [[ \"$LIMIT\" =~ ^[0-9]+$ ]]; then\n echo \"error: --limit must be a non-negative integer, got: $LIMIT\" >&2\n exit 2\nfi\n\ngenerate_config() {\n cat \u003c\u003c'YAML'\nversion: \"2\"\nlinters:\n enable:\n # Minimum recommended\n - errcheck\n - govet\n - revive\n - staticcheck\n # Additional recommended\n - bodyclose\n - gocyclo\n - gosec\n - ineffassign\n - misspell\n settings:\n revive:\n rules:\n - name: exported\n gocyclo:\n min-complexity: 15\n exclusions:\n generated: lax\n paths:\n - third_party$\n - builtin$\n - examples$\n\nissues:\n max-issues-per-linter: 0\n max-same-issues: 0\n\nformatters:\n enable:\n - goimports\n exclusions:\n generated: lax\n paths:\n - third_party$\n - builtin$\n - examples$\nYAML\n\n if [[ -n \"$LOCAL_PREFIX\" ]]; then\n cat \u003c\u003cYAML\n settings:\n goimports:\n local-prefixes:\n - ${LOCAL_PREFIX}\nYAML\n fi\n}\n\nif $DRY_RUN; then\n generate_config\n exit 0\nfi\n\nCONFIG_PATH=\".golangci.yml\"\n\nif [[ -f \"$CONFIG_PATH\" ]] && ! $FORCE; then\n echo \"error: $CONFIG_PATH already exists (use --force to overwrite)\" >&2\n exit 2\nfi\n\ngenerate_config > \"$CONFIG_PATH\"\n\nLINT_OUTPUT=\"\"\nLINT_EXIT=0\nif ! command -v golangci-lint &>/dev/null; then\n echo \"error: golangci-lint is not installed\" >&2\n exit 2\nfi\n\nLINT_OUTPUT=$(golangci-lint run ./... 2>&1) || LINT_EXIT=$?\n\nif $JSON_OUTPUT; then\n LINT_TRUNCATED=false\n LINT_DISPLAY=\"$LINT_OUTPUT\"\n if [[ $LIMIT -gt 0 && -n \"$LINT_OUTPUT\" ]]; then\n LINT_ARR=()\n while IFS= read -r line; do\n LINT_ARR+=(\"$line\")\n done \u003c\u003c\u003c \"$LINT_OUTPUT\"\n if [[ ${#LINT_ARR[@]} -gt $LIMIT ]]; then\n LINT_DISPLAY=\"\"\n for (( i=0; i\u003cLIMIT; i++ )); do\n [[ -n \"$LINT_DISPLAY\" ]] && LINT_DISPLAY+=

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

\\n'\n LINT_DISPLAY+=\"${LINT_ARR[$i]}\"\n done\n LINT_TRUNCATED=true\n fi\n fi\n LINT_ESC=\"$(json_escape \"$LINT_DISPLAY\")\"\n CONFIG_ESC=\"$(json_escape \"$CONFIG_PATH\")\"\n PREFIX_ESC=\"$(json_escape \"$LOCAL_PREFIX\")\"\n CREATED=true\n HAS_ISSUES=$( [[ $LINT_EXIT -ne 0 ]] && echo true || echo false )\n TRUNC_FIELD=\"\"\n $LINT_TRUNCATED && TRUNC_FIELD=',\"truncated\":true'\n cat \u003c\u003cEOF\n{\"config_path\":\"$CONFIG_ESC\",\"local_prefix\":\"$PREFIX_ESC\",\"created\":$CREATED,\"lint_issues\":$HAS_ISSUES,\"lint_output\":\"$LINT_ESC\"$TRUNC_FIELD}\nEOF\nelse\n echo \"Created $CONFIG_PATH\"\n if [[ $LINT_EXIT -ne 0 ]]; then\n echo \"\"\n echo \"$LINT_OUTPUT\"\n echo \"\"\n echo \"Lint issues found — fix them category by category (formatting first, then vet, then style).\"\n else\n echo \"golangci-lint: all clean.\"\n fi\nfi\n\nif [[ $LINT_EXIT -ne 0 ]]; then\n exit 1\nfi\nexit 0\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":4912,"content_sha256":"8e235839873d2638fc345c1f0ba0f0ed90133b45a61fb72716cdc56adca640f6"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Go Linting","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Core Principle","type":"text"}]},{"type":"paragraph","content":[{"text":"More important than any \"blessed\" set of linters: ","type":"text"},{"text":"lint consistently across a codebase","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Consistent linting helps catch common issues and establishes a high bar for code quality without being unnecessarily prescriptive.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Resource Routing","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"scripts/setup-lint.sh","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Run when generating a ","type":"text"},{"text":".golangci.yml","type":"text","marks":[{"type":"code_inline"}]},{"text":", validating the first lint pass, or producing JSON metadata.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"assets/golangci.yml","type":"text","marks":[{"type":"code_inline"}]},{"text":" - Use as the v2 golangci-lint baseline for established projects.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Setup Procedure","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Create ","type":"text"},{"text":".golangci.yml","type":"text","marks":[{"type":"code_inline"}]},{"text":" with ","type":"text"},{"text":"scripts/setup-lint.sh","type":"text","marks":[{"type":"code_inline"}]},{"text":" or copy ","type":"text"},{"text":"assets/golangci.yml","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Run ","type":"text"},{"text":"golangci-lint run ./...","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"If errors appear, fix them category by category (formatting first, then vet, then style)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Re-run until clean","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"After generating ","type":"text"},{"text":".golangci.yml","type":"text","marks":[{"type":"code_inline"}]},{"text":", run ","type":"text"},{"text":"golangci-lint config verify --config .golangci.yml","type":"text","marks":[{"type":"code_inline"}]},{"text":" to verify the configuration schema before relying on lint results.","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Minimum Recommended Linters","type":"text"}]},{"type":"paragraph","content":[{"text":"These linters catch the most common issues while maintaining a high quality bar:","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Linter","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Purpose","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"errcheck","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/kisielk/errcheck","title":null}}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Ensure errors are handled","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"goimports","type":"text","marks":[{"type":"link","attrs":{"href":"https://pkg.go.dev/golang.org/x/tools/cmd/goimports","title":null}}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Format code and manage imports","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"revive","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/mgechev/revive","title":null}}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Common style mistakes (modern replacement for golint)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"govet","type":"text","marks":[{"type":"link","attrs":{"href":"https://pkg.go.dev/cmd/vet","title":null}}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Analyze code for common mistakes","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"staticcheck","type":"text","marks":[{"type":"link","attrs":{"href":"https://staticcheck.dev","title":null}}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Various static analysis checks","type":"text"}]}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Note","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"revive","type":"text","marks":[{"type":"code_inline"}]},{"text":" is the modern, faster successor to the now-deprecated ","type":"text"},{"text":"golint","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Lint Runner: golangci-lint","type":"text"}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"golangci-lint","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/golangci/golangci-lint","title":null}}]},{"text":" as your lint runner. See the ","type":"text"},{"text":"example .golangci.yml","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/uber-go/guide/blob/master/.golangci.yml","title":null}}]},{"text":" from uber-go/guide.","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"assets/golangci.yml","type":"text","marks":[{"type":"code_inline"}]},{"text":" as the maintained example. It targets golangci-lint v2 (verified with 2.10.1 on 2026-06-19), keeps ","type":"text"},{"text":"goimports","type":"text","marks":[{"type":"code_inline"}]},{"text":" under ","type":"text"},{"text":"formatters","type":"text","marks":[{"type":"code_inline"}]},{"text":", and enables the core linters plus common production additions.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Running","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# Install the version this skill's config is verified against\ngo install github.com/golangci/golangci-lint/v2/cmd/[email protected]\n\n# Run all linters\ngolangci-lint run\n\n# Run on specific paths\ngolangci-lint run ./pkg/...","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Additional Recommended Linters","type":"text"}]},{"type":"paragraph","content":[{"text":"Beyond the minimum set, consider these for production projects:","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Linter","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Purpose","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"When to enable","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"gosec","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/securego/gosec","title":null}}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Security vulnerability detection","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Always for services handling user input","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"ineffassign","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/gordonklaus/ineffassign","title":null}}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Detect ineffectual assignments","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Always — catches dead code","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"misspell","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/client9/misspell","title":null}}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Correct common misspellings in comments/strings","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Always","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"gocyclo","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/fzipp/gocyclo","title":null}}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Cyclomatic complexity threshold","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"When functions exceed ~15 complexity","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"exhaustive","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/nishanths/exhaustive","title":null}}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Ensure switch covers all enum values","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"When using iota enums","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"bodyclose","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/timakin/bodyclose","title":null}}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Detect unclosed HTTP response bodies","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Always for HTTP client code","type":"text"}]}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Nolint Directives","type":"text"}]},{"type":"paragraph","content":[{"text":"When suppressing a lint finding, always explain why:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"go"},"content":[{"text":"//nolint:errcheck // fire-and-forget logging; error is not actionable\n_ = logger.Sync()","type":"text"}]},{"type":"paragraph","content":[{"text":"Rules:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"//nolint:lintername","type":"text","marks":[{"type":"code_inline"}]},{"text":" — never bare ","type":"text"},{"text":"//nolint","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Place the comment on the same line as the finding","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Include a justification after ","type":"text"},{"text":"//","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"CI/CD Integration","type":"text"}]},{"type":"paragraph","content":[{"text":"Run ","type":"text"},{"text":"golangci-lint run ./...","type":"text","marks":[{"type":"code_inline"}]},{"text":" in CI after tests. Pin the golangci-lint version used by CI so local and release behavior do not drift.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Pre-commit Hook","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"#!/bin/sh\n# .git/hooks/pre-commit\ngolangci-lint run --new-from-rev=HEAD~1","type":"text"}]},{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"--new-from-rev","type":"text","marks":[{"type":"code_inline"}]},{"text":" to lint only changed code, keeping the feedback loop fast.","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Quick Reference","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Task","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Command/Action","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Install golangci-lint","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"go install github.com/golangci/golangci-lint/v2/cmd/[email protected]","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Run linters","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"golangci-lint run","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Run on path","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"golangci-lint run ./pkg/...","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Config file","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":".golangci.yml","type":"text","marks":[{"type":"code_inline"}]},{"text":" in project root","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"CI integration","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Run ","type":"text"},{"text":"golangci-lint run","type":"text","marks":[{"type":"code_inline"}]},{"text":" in pipeline","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Nolint directives","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"//nolint:name // reason","type":"text","marks":[{"type":"code_inline"}]},{"text":" — never bare ","type":"text"},{"text":"//nolint","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"CI integration","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Use ","type":"text"},{"text":"golangci/golangci-lint-action","type":"text","marks":[{"type":"code_inline"}]},{"text":" for GitHub Actions","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Pre-commit","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"golangci-lint run --new-from-rev=HEAD~1","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Linter Selection Guidelines","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"When you need...","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Use","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Error handling coverage","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"errcheck","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Import formatting","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"goimports","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Style consistency","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"revive","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Bug detection","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"govet, staticcheck","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"All of the above","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"golangci-lint with config","type":"text"}]}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Related Skills","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Style foundations","type":"text","marks":[{"type":"strong"}]},{"text":": See ","type":"text"},{"text":"go-style-core","type":"text","marks":[{"type":"link","attrs":{"href":"../go-style-core/SKILL.md","title":null}}]},{"text":" when resolving style questions that linters enforce (formatting, nesting, naming)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Code review","type":"text","marks":[{"type":"strong"}]},{"text":": See ","type":"text"},{"text":"go-code-review","type":"text","marks":[{"type":"link","attrs":{"href":"../go-code-review/SKILL.md","title":null}}]},{"text":" when combining linter output with a manual review checklist","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Error handling","type":"text","marks":[{"type":"strong"}]},{"text":": See ","type":"text"},{"text":"go-error-handling","type":"text","marks":[{"type":"link","attrs":{"href":"../go-error-handling/SKILL.md","title":null}}]},{"text":" when errcheck flags unhandled errors and you need to decide how to handle them","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Testing","type":"text","marks":[{"type":"strong"}]},{"text":": See ","type":"text"},{"text":"go-testing","type":"text","marks":[{"type":"link","attrs":{"href":"../go-testing/SKILL.md","title":null}}]},{"text":" when running linters alongside tests in CI pipelines","type":"text"}]}]}]}]},"metadata":{"date":"2026-11-02","name":"go-linting","author":"@skillopedia","source":{"stars":188,"repo_name":"golang-skills","origin_url":"https://github.com/cxuu/golang-skills/blob/HEAD/skills/go-linting/SKILL.md","repo_owner":"cxuu","body_sha256":"94777a4a67f1e5eb8a7cde810965e9feb8bb540af2170c55093a250ddd739f5b","cluster_key":"8feb7489a14da16520759b97cf570e8707abc75002a5e66b2fd2aa02cba32c60","clean_bundle":{"format":"clean-skill-bundle-v1","source":"cxuu/golang-skills/skills/go-linting/SKILL.md","text_bytes":5528,"source_commit":"91f0c2eef559a3168f9d3c38f5f99936d472b508","skills_sh_rank":10760,"attachment_count":2,"text_attachments":2,"attachment_storage":"skill_attachments","binary_attachments":0},"cluster_size":1,"skill_md_path":"skills/go-linting/SKILL.md","import_metadata":{"date":"2026-11-02","author":"@skillopedia","version":"v1","category":"software-engineering","category_label":"Engineering"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"software-engineering","import_tag":"skills-sh-top20k-2026-11","description":"Use when setting up linting for a Go project, configuring golangci-lint, or adding Go checks to a CI/CD pipeline. Also use when starting a new Go project and deciding which linters to enable, even if the user only asks about \"code quality\" or \"static analysis\" without mentioning specific linter names. Does not cover code review process (see go-code-review).","allowed-tools":"Bash(bash:*)"}},"renderedAt":1793666619452}

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.