# Fix Lint

> Fix Lint is an Agent Skill for testing & quality published in the vladmandic/sdnext repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Run the SD.Next lint workflow in phased order: execute tools in sequence first, then apply minimal fixes, while ignoring findings explicitly marked by TODO comments in code.

- Skill name: `fix-lint`
- Category: [Testing & Quality](https://www.openparable.com/skill/testing-quality/1)
- Source: https://github.com/vladmandic/sdnext/blob/HEAD/.github/skills/fix-lint/SKILL.md
- Repository: vladmandic/sdnext (7,169 GitHub stars when collected)

## SKILL.md

# Fix Lint Workflow

Run the project lint workflow in the required order, fix findings, and re-run affected tools until clean.

## When To Use

- The user asks to run lint and fix issues
- A PR requires lint-clean status before review
- Multiple files changed and style/static checks may have drifted
- You need a repeatable full-lint remediation pass

## Guidance

- Consult `.github/instructions/core.instructions.md` for relevant core runtime guidance before proceeding.

## Required Environment Step

Always start from repository root and activate virtual environment first:

- Linux: `. venv/bin/activate`
- Windows: `venv\\scripts\\activate`

If activation fails, report the blocker and stop before running Python-based tools.

## Required Tool Execution Order

Run tools in this exact sequence:

1. `pre-commit run --all-files`
2. `{PROJECT_ROOT}/node_modules/.bin/eslint . javascript/`
3. `cd extensions-builtin/sdnext-modernui && {PROJECT_ROOT}/node_modules/.bin/eslint . javascript/`
4. `ruff check`
5. `pylint *.py`
6. `pylint modules/`
7. `pylint pipelines/`
8. `pylint scripts/`
9. `pylint extensions-builtin/`

Note that `pylint` can run for considerable time, so run with no timeouts.

## Fix Policy

- Fix issues reported by each tool before moving on.
- Ignore lint issues explicitly marked by `TODO` comments in code.
- Do not suppress errors globally just to pass checks.
- Keep fixes minimal and targeted to reported findings.
- Preserve existing project conventions and avoid unrelated refactors.

## Procedure

### 1. Initialize Environment

- Confirm current directory is repository root.
- Activate venv using OS-appropriate command.

### 2. Execute And Repair Per Tool

For each tool in the required order:

- Run the command.
- Parse failures and group by file.
- Apply minimal code fixes.
- Re-run the same command until it passes or only `TODO`-marked findings remain.
- If a fix introduces new failures in earlier tools, re-run impacted earlier tools.

### 3. Cross-Check Regression

After all tools pass individually:

- Re-run the full ordered sequence once to ensure no cross-tool regressions.

### 4. Report

Return:

- Commands executed (in order)
- Files changed
- Which issues were fixed
- Any findings intentionally ignored due to `TODO` markers
- Any remaining blockers that could not be auto-fixed

## Pass Criteria

A successful run means:

- All listed tools executed in order
- No remaining fixable lint errors from those tools
- Remaining issues are only those explicitly marked with `TODO` (if any)
- Final verification pass completed

---

Source: https://www.openparable.com/skill/testing-quality/fix-lint (OpenParable). Cite the canonical URL above.
