---
name: lint-fix
description: Iteratively run linters, apply auto-fixes, and resolve remaining issues using Trunk.
---

# Lint & Fix with Trunk

## Purpose

This skill provides an autonomous loop for identifying, fixing, and verifying linting and formatting issues using `trunk`. Use this when you need to ensure the codebase adheres to project standards or when fixing specific lint errors.

## Loop Logic

1.  **Auto-Format**: Run `trunk fmt` (or `trunk fmt -a`) to apply automatic formatting fixes.
2.  **Discovery**: Run `trunk check -y` (or `trunk check -a -y` for all files) to list current linting issues.
3.  **Analyze**: For any remaining issues from Step 2:
    - Examine the error message and the failing code.
    - Identify the specific rule being violated (e.g., Ruff `E501`, Shellcheck `SC2086`).
4.  **Fix**: Apply the minimum necessary change to resolve the manual fix required.
5.  **Verify**: Re-run `trunk check -y` on the affected file(s).
    - If passed: Move to next issue.
    - If failed: Analyze the new failure and repeat the loop.

## Termination Criteria

- No more errors reported by `trunk check -y`.
- Reached max iteration limit (default: 5).

## Common Commands

| Task                 | Command                 |
| :------------------- | :---------------------- |
| Check changed files  | `trunk check -y`        |
| Check all files      | `trunk check -a -y`     |
| Format changed files | `trunk fmt`             |
| Format all files     | `trunk fmt -a`          |
| Check specific file  | `trunk check -y <path>` |
| Format specific file | `trunk fmt <path>`      |

## Examples

### Scenario: Fixing Python Lint Errors

1.  `trunk check -y` reports `ruff: D103` (missing docstring) in `scripts/utils.py` (after auto-fixing unused imports).
2.  Agent adds the missing docstring in `scripts/utils.py`.
3.  `trunk check -y scripts/utils.py` passes.