Skills DirectoryCurated open-source Skills from GitHub
English

python-code-stylecommit cbb6049SKILL.md · Code Standards

Python Code Style

Covers Python linting and formatting setup with ruff and mypy, PEP 8 naming, import order, type hints and Google-style docstrings.

npx skills add wshobson/agents --skill python-code-style
Permissions
  • read-repo
  • write-files
  • shell
  • network
Compatible with
Claude Code, Codex, Cursor, Copilot, OpenCode
GitHub
42.1k
Source
Community · Seth Hobson
Status
Scan passed
License
MIT
Category
Code Standards
Repository
github.com/wshobson/agents/plugins/python-development/skills/python-code-style

Core rule

Let tools handle formatting debates: configure once, enforce automatically.

Execution Phases

  1. Phase 01Configure tooling

    Configure ruff in pyproject.toml for linting and formatting, and enable mypy or pyright in strict mode.

  2. Phase 02Naming and imports

    Follow PEP 8 with clarity over brevity; group imports as standard library, third-party, local, and use absolute imports only.

  3. Phase 03Types and docstrings

    Add type hints and Google-style docstrings to every public API, with Args, Returns, Raises and examples.

  4. Phase 04Format and document

    Use 120-character lines with clear breaks, keep a README and a Keep a Changelog CHANGELOG, and run linters in CI.

Permissions (summarised from SKILL.md)

CapabilityNeededDetails
File writesRequiredEdits config such as pyproject.toml, adds types and docstrings to code, and writes project docs.
Command executionLimitedRuns ruff check --fix, ruff format, and commands to install tools such as ruff and mypy.
Network outboundLimitedOnly the package index, when installing tools such as ruff and mypy with pip.

SKILL.md frontmatter (YAML)

SKILL.md frontmatter (YAML)commit cbb6049
---
name: python-code-style
description: 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.
---

Related skills

A rule scan cannot catch every risk. Read this skill's SKILL.md and check its permissions before installing.
Markdown version GitHub