wemake-python-styleguide

SkillDev tools

Lets your agent find and fix WPS style violations in Python code using the wemake-python-styleguide linter.

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

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

Then ask your AI: use the wemake-python-styleguide skill

About this capability

wemake-python-styleguide (WPS) linting. Use when fixing flake8 `WPS` violations, or writing/reviewing Python in a repo where `wemake-python-styleguide` runs.

What this skill tells your AI

The instructions your AI receives, as published by wemake-services/wemake-python-styleguide in .agents/skills/wps/SKILL.md and read by ahel’s review.

Always write Python code that will pass all rules from violations index. Edit existing Python code until flake8 --select=WPS,E999 reports nothing. Fix the code, not the config.

Loop

  1. Run flake8 --select=WPS,E999 --format=default <paths> with the project's flake8 config (setup.cfg, .flake8, or [tool.flake8] in pyproject.toml); pass --isolated only when the repo has none.
  2. For each violation, edit the code so its cause is gone — the message names the rule and line; make the smallest change that satisfies it. When a rule's intent is unclear, read its page under the violation index, or call explain_violation('WPS###') if the WPS MCP server is running.
  3. Re-run step 1. Done when it exits 0.

Guardrails

  • Suppress with # noqa: WPS### (the code, never bare # noqa) only when the user asks, or per-file-ignores already covers the line. Otherwise fix the code.
  • Leave flake8 config untouched unless the user approves the edit. When one rule fires across many files and fixing each is wrong, propose a config change and wait.
  • Delete a # noqa: WPS### once flake8 --disable-noqa shows its code no longer fires.

The explain_violation tool comes from the WPS MCP server: pip install 'wemake-python-styleguide[mcp]', then register mcp run wemake_python_styleguide/mcp.py:mcp as a stdio server.

Signals

GitHub stars
3k
Forks
430
Last commit
Sep 2026

ahel review

  • K1binfo
    installs-packages

Automated review, not a security audit. Ruleset v1+k2.

Advanced
Catalog kind
skill
Gateway key
wps
Source
github.com/wemake-services/wemake-python-styleguide