PlugWiki

python-code-style Skill: Ruff, mypy and Docstring Standards for Python

Makes your agent follow one Python style: ruff for linting and formatting, strict mypy, PEP 8 names and Google-style docstrings.

Installs
16.8K
on skills.sh
Stars
42.1K
on GitHub
Updated
Oct 2026
last repo commit

The skill loads when you write new Python, review style, configure linters, write docstrings or set team standards. It gives the agent seven patterns: ruff as the single linter and formatter, strict mypy or pyright, naming, import order, Google-style docstrings, line length and project documentation.

It is guidance only and bundles no scripts. It sets a 120-character line length and recommends Python 3.12 or later for new projects, so change those if your project differs. Its quick start shows pip install ruff mypy.

Good for

  • Python developers starting a project who want linting and typing set up
  • Reviewers who want a fixed checklist for style comments
  • Teams writing down coding standards

Install python-code-style

Claude Code

  1. 1

    Copy this prompt.

    Install the python-code-style skill in Claude Code. Run this command:

npx skills add https://github.com/wshobson/agents --skill python-code-style

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Python code style, linting, formatting, naming conventions, and documentation standards. Use when writing new code, reviewing style, configuring linters, writing docstrings, or establishing project standards.

Sections in SKILL.md

  1. When to Use This Skill
  2. Core Concepts
  3. 1. Automated Formatting
  4. 2. Consistent Naming
  5. 3. Documentation as Code
  6. 4. Type Annotations
  7. Quick Start
  8. Fundamental Patterns
  9. Pattern 1: Modern Python Tooling
  10. Pattern 2: Type Checking Configuration
  11. Pattern 3: Naming Conventions
  12. Pattern 4: Import Organization
  13. Advanced Patterns
  14. Pattern 5: Google-Style Docstrings
  15. Pattern 6: Line Length and Formatting
  16. Pattern 7: Project Documentation

Key facts

Author
wshobson
Installs on skills.sh
16,827 (Nov 2, 2026)
GitHub stars
42,081 (Nov 2, 2026), whole repo
Files
1 file including SKILL.md
Last commit
Oct 30, 2026 (repo)
Part of
The python-development plugin in wshobson/agents
Defaults it sets
Line length 120, target Python 3.12, strict mypy

What it includes

  • ruff for lint and format

    Config for pyproject.toml with rules E, W, F, I, B, C4, UP and SIM; run ruff check --fix and ruff format.

    Runs code · Pattern 1: Tooling

  • Strict mypy, or pyright as an alternative

    Settings for strict mode, unused ignores and test overrides.

    Write · Pattern 2: Type checking

  • snake_case, PascalCase, SCREAMING_SNAKE_CASE

    Descriptive names over abbreviations; acronyms stay uppercase in class names.

    Pattern 3: Naming

  • Standard library, third party, local; absolute imports

    Avoid relative imports.

    Pattern 4: Imports

  • Google style for every public item

    Examples for a function and a class, with Args, Returns, Raises and Example.

    Pattern 5: Docstrings

  • 120 characters, clear breaks

    Examples of readable breaks and chained calls.

    Pattern 6: Line length

  • README structure and Keep a Changelog

    Templates for README and CHANGELOG.

    Pattern 7: Project docs

From the official docs

Permissions

Low risk

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • Its quick start installs packages and edits config

    It shows pip install ruff mypy and pyproject.toml settings. Review the diff before you commit. github.com

Questions

What does the python-code-style skill do?

It gives your agent a fixed Python style guide. That covers ruff, strict mypy, naming, import order, Google-style docstrings and README and changelog layout.

How do I install it?

Use the install box above. It is a single SKILL.md with no scripts. The wshobson/agents README documents npx skills add wshobson/agents --skill <skill-name> for one skill (here, python-code-style) and gh skill install, both without the plugin's agents and commands. Its Claude Code route is the python-development plugin, which per the repo tree holds 16 skills, 3 agents and 1 command; its plugin.json lists no hooks or MCP servers.

Does it need ruff or mypy installed?

The skill tells the agent how to configure them and shows pip install ruff mypy. Install them yourself first, or approve the agent's pip command.

Is it safe?

It is text guidance. If you accept its quick start, the agent may run pip install and edit pyproject.toml. Check the line length and Python version it writes.

Can I use black or flake8 instead?

The skill picks ruff and says it replaces flake8, isort and black. If your team uses those, tell the agent so before it rewrites your config.

Does it work in Codex or Cursor?

The wshobson/agents README documents Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot and Pi, each through its own route. For a single skill it points to the skills-only installers.

Information

updated Nov 2, 2026

Repository
wshobson/agents
Folder
plugins/python-development/skills/python-code-style

wshobson/agentsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 2
  1. python-code-style SKILL.md · github.com
  2. wshobson/agents README · github.com

Updated Nov 2, 2026.