ESLint Disable Governance
Governs eslint-disable usage by classifying justified versus unjustified suppressions, requiring technical justification, and cleaning up unnecessary rule disables without changing behavior.
SKILL.mdskills/quality/eslint/eslint-disable-governance/SKILL.md
GitHubESLint Disable Governance
Purpose
Use this skill to control eslint-disable and similar suppressions.
Suppressions are debt. They may be justified, but they must be visible, explained, and periodically re-evaluated.
The core rule is simple:
Every suppression needs a reason and an expiry path.
When to Use
Use this skill when:
- the repo has many lint suppressions
eslint-disableis hiding debtts-ignoreorts-expect-errorneeds triage- a cleanup pass is needed before harder lint rules
Do
Locate:
eslint-disableeslint-disable-next-linets-ignorets-expect-error
Classify each suppression:
- justified
- temporary
- unnecessary
- suspicious
Require a technical reason for keeping it.
Do Not
Avoid removing suppressions blindly when they protect a known issue.
Avoid allowing suppressions with no comment or ticket path when governance expects one.
Avoid changing behavior accidentally while removing a disable.
Review Checklist
- Suppressions are found and classified.
- Justifications are technical, not cosmetic.
- Unnecessary suppressions are removed.
- Behavior is preserved.
Expected Output
- Inventory suppressions.
- Classify their legitimacy.
- Remove unnecessary disables.
- Preserve behavior.
- Record remaining suppressions clearly.