Lint

SkillDev tools

Lets your agent run the repository's static analysis checks and fix lint, typing, and spelling issues.

Available today. Use it from your connected AI after setup.

No other account needed.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Lint skill

About this capability

Run and fix the repository static analysis suite.

What this skill tells your AI

The instructions your AI receives, as published by ethereum/execution-specs in .agents/skills/lint/SKILL.md and read by ahel’s review.

Run the full static analysis suite and fix issues. This matches the CI check on every PR.

just static

This runs ruff, mypy, codespell, ethereum-spec-lint, and actionlint in one pass. If everything passes, you're done.

If static checks report ruff errors, run the fix recipe first — it resolves most issues automatically:

just fix

After auto-fix, re-run to see what's left:

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)

Re-run until clean:

just static

Advanced