name: lint-cleanup description: Fix lint, ESLint, and static-analysis diagnostics properly. Use when Codex needs to run lint commands, resolve ESLint errors or warnings, remove unnecessary disable comments, or replace suppressions with root-cause code, type, config, or test fixes.
Lint Cleanup
Use this skill for lint failures and lint hygiene tasks where the goal is a clean rerun without weakening the gate.
Workflow
- Inspect the repo's package manager, lint scripts, lint config, typed-lint project boundaries, and any user-provided diagnostics.
- Run the relevant lint command unless the user already supplied exact current output.
- Use autofix commands only as a starting point when the project provides them.
- Manually review remaining diagnostics and fix root causes.
- Prefer code, type, config, docs, or test fixes over suppressions.
- Do not add blanket disables, broad ignores, unsafe casts, mass exceptions, or rule downgrades unless the user explicitly approves.
- If behavior changes, run targeted tests as well as lint.
- Rerun lint after each logical batch.
ESLint Disable Cleanup
Use unused-disable reporting when available. For every remaining disable, identify the exact rule and diagnostic, try to remove it by improving the code locally, keep only narrowly scoped justified disables, and add or improve reason comments when a disable must remain.
Output
Finish only when lint is clean or every remaining issue has a concrete blocker. Report diagnostics fixed, suppressions removed or retained with rationale, commands run, and validation results.