format_python SKILL.md skillA

format_python from theafh/ai-modules is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add theafh/ai-modules/format_python@v1.4.1

Pins v1.4.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
theafh/ai-modules
Path
plugins/ai_dev/skills/format_python/SKILL.md
Versions recorded
2
Latest version
v1.4.1, committed Sep 5, 2026
First version recorded
May 3, 2026
Size
6,944 bytes
Repository stars
38
License
MIT

Apply formatting standards, code quality rules, structure conventions, linting prevention, and best practices when generating or editing Python code (.py). Covers indentation, quoting, imports, naming, line length, type hints, error handling, logging, data structures, testing, and security practices aligned with common linters (flake8, ruff, pylint).

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# format_python

## Formatting Standards

- Use exactly 4 spaces for indentation (never tabs)
- Use double quotes for all string literals consistently
- Write one import per line, grouped stdlib → third party → first party → local, to prevent the E401 multiple-imports error
- Use absolute imports, and import from the `typing` module only when a built-in type will not do
- Import only the modules, names, and types you use, and remove unused imports immediately to prevent F401 errors
- Use `snake_case` for variables/functions, `PascalCase` for classes, `UPPER_CASE` for constants
- Keep lines under 88 characters, break long lines at logical points with proper indentation

## Code Quality Standards

- Write valid Python syntax that passes all linter checks
- Use specific exception types like `ValueError`, `FileNotFoundError`
- Assign error messages to variables before raising exceptions
- Remove unused variables, and use `_` for intentionally unused values, to prevent F841 errors
- Use modern type hints: `dict[str, Any]` instead of `Dict[str, Any]`, `str | None` instead of `Optional[str]`
- Use f-strings for general formatting, use % formatting in logging statements
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add theafh/ai-modules/format_python@sha256:823f3d67c16e180d

The line at the top of this page pins the label v1.4.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_t7yj45s2rdssitlx.svg)](https://markdownregistry.com/a/art_t7yj45s2rdssitlx)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between May 3, 2026 and Sep 5, 2026, about one every 125 days.

versioncommittedcommitsizeaudit
v1.4.1 latest2026-09-05 a750d17 6,944 BA view · diff
v1.4.02026-05-03 218abb8 7,040 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6944 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

theafh/ai-modules · 38 stars · license MIT · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_t7yj45s2rdssitlx
GET https://markdownregistry.com/api/v1/resolve?ref=theafh/ai-modules/format_python
GET https://markdownregistry.com/api/v1/blob/823f3d67c16e180dd0a26daa212d4c02b2bd422dce072287575e1b8c7f69752d

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from theafh/ai-modules

AGENTS.md AGENTS.md file
theafh/ai-modules · AGENTS.md
git:20261010.630e166 · audit A · 38 stars
CLAUDE.md CLAUDE.md file
theafh/ai-modules · CLAUDE.md
git:20261010.630e166 · audit A · 38 stars
agent_spinner SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/agent_spinner/SKILL.md · Run helper agents from an orchestrating agent under one quality contract, whatever delegation the host offers…
v1.0.1 · audit A · 38 stars
ai_instruction_formatting SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/ai_instruction_formatting/SKILL.md · Organize AI-consumed content (prompts, rules, skills, commands, agents, system instructions) into pseudo-XML by…
v3.4.3 · audit A · 38 stars
ai_instruction_writing SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/ai_instruction_writing/SKILL.md · Write AI-consumed content using positive, action-oriented language as the primary carrier of every instruction. Use…
v3.0.4 · audit A · 38 stars
format_markdown SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/format_markdown/SKILL.md · Apply markdown linting compliance and best practices when creating or editing markdown files (.md, .mdc). Covers…
v2.0.0 · audit A · 38 stars
format_rust SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/format_rust/SKILL.md · Apply clippy-aligned Rust practices when writing or editing Rust code (.rs). Covers procedural flow, clippy-driven…
v1.3.2 · audit A · 38 stars
git_checkout SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/git_checkout/SKILL.md · Put the repository onto an existing branch wherever it lives: fetch every remote without pruning, switch when the…
v1.0.0 · audit A · 38 stars
git_commit SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/git_commit/SKILL.md · Create one structured git commit covering the full current working-tree state. Use when the user explicitly asks to…
v3.5.2 · audit B · 38 stars
git_refresh SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/git_refresh/SKILL.md · Refresh a local git repo back to a clean current default branch: fetch/prune, detect the remote HEAD, fast-forward…
v1.0.1 · audit A · 38 stars
git_review SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/git_review/SKILL.md · Review the changes the user names and answer two questions kept apart: could they be approved in general, and can they…
v1.0.9 · audit B · 38 stars
guardrail SKILL.md skill
theafh/ai-modules · plugins/ai_dev/skills/guardrail/SKILL.md · Hub and source of truth for the repo-root guardrail documents (CHARTER.md, ARCHITECTURE.md, TESTING.md, SECURITY.md)…
v1.0.3 · audit A · 38 stars

Every file in theafh/ai-modules

Browse by kind, by grade A, or by owner.