lint
Run and fix the repository static analysis suite.
Source facts
- Repository
- ethereum/execution-specs
- Last source activity
- October 16, 2026 at 15:13
- Detected SKILL.md language
- English
- Stars
- 1,208
- Forks
- 527
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- lint
- description
- Run and fix the repository static analysis suite.
# Lint
Run the full static analysis suite and fix issues. This matches the CI check on every PR.
## Step 1: Run the Full Check
```bash
just static
```
This runs ruff (lint and format check), mypy, codespell, ethereum-spec-lint, vulture, actionlint, and a `uv.lock` freshness check in one pass. If everything passes, you're done.
## Step 2: Auto-Fix Formatting and Lint Issues
If static checks report ruff errors, run the fix recipe first — it resolves most issues automatically:
```bash
just fix
```
## Step 3: Resolve Remaining Issues Manually
After auto-fix, re-run to see what's left:
```bash
just static
```
- **Remaining ruff issues**: fix manually (auto-fix can't handle all rules)
- **mypy errors**: fix type annotations, add missing types, correct signatures
- **codespell errors**: fix typos, or add intentional words via `just whitelist <word>`
- **ethereum-spec-lint errors**: fix import isolation violations (see `/implement-eip` for import rules)
- **actionlint errors**: fix workflow YAML issues (see `/edit-workflow`)
- **vulture (deadcode) errors**: remove the dead code, or add a genuine false positive to `vulture_whitelist.py`
- **lock-check errors**: run `uv lock` and commit the updated `uv.lock`
## Step 4: Final Verification
Re-run until clean:
```bash
just static
```
View on GitHub