existential-birds avatar

Python Code Review

Runs through your Python files checking PEP8 style, type hints, async/await patterns, error handling, and the usual footguns like mutable defaults. It's got reference docs for each category and a five-gate workflow that forces you to document scope, screen for false positives, cite file and line numbers, and run a verification protocol before shipping findings. The opinionated part is good: it knows not to flag things like cast() after runtime checks or Any types when dealing with untyped libraries. If you want structured reviews instead of ad-hoc comments, this keeps you honest about what you actually checked and why you're flagging it.

skills.sh installs
928
GitHub stars
87
last updated
Aug 21, 2026

Install

$ npx -y skills add existential-birds/beagle --skill python-code-review --agent claude-code

Installs into .claude/skills of the current project.

Files

Python Code Review

Quick Reference

Issue TypeReference
Indentation, line length, whitespace, namingreferences/pep8-style.md
Missing/wrong type hints, Any usagereferences/type-safety.md
Blocking calls in async, missing awaitreferences/async-patterns.md
Bare except, missing context, loggingreferences/error-handling.md
Mutable defaults, print statementsreferences/common-mistakes.md

Review Checklist

PEP8 Style

  • 4-space indentation (no tabs)
  • Line length ≤79 characters (≤72 for docstrings/comments)
  • Two blank lines around top-level definitions, one within classes
  • Imports grouped: stdlib → third-party → local (blank line between groups)
  • No whitespace inside brackets or before colons/commas
  • Naming: snake_case for functions/variables, CamelCase for classes, UPPER_CASE for constants
  • Inline comments separated by at least two spaces

Sponsors

Details

Repository
github.com/existential-birds/beagle
Categories
Git & Pull Requests, Code Review & Quality, Debugging, Python
First seen
Jun 3, 2026

More from existential-birds/beagle

All 40
1existential-birds avatarlanggraph-code-reviewexistential-birds/beagleReviews LangGraph code for bugs, anti-patterns, and improvements. Use when reviewing code that uses StateGraph, nodes, edges, checkpointing, or other LangGraph 887skills.sh installs
2bitjaru avatarss-reviewbitjaru/styleseedReview UI code for design system compliance, accessibility, and best practices864skills.sh installs
3encoredev avatarencore-code-reviewencoredev/skillsReview existing Encore.ts code for best practices and common anti-patterns.862skills.sh installs
4huangwb8 avatarsystematic-literature-reviewhuangwb8/chineseresearchlatex当用户明确要求"做系统综述/文献综述/related work/相关工作/文献调研"时使用。AI 自定检索词,多源检索→去重→AI 逐篇阅读并评分(1–10分语义相关性与子主题分组)→按高分优先比例选文→自动生成"综/述"字数预算→资深领域专家自由写作(固定摘要/引言/子主题/讨论/展望/结论),保留正文字数与参考文献826skills.sh installs
5affaan-m avatarprediction-market-risk-reviewaffaan-m/everything-claude-codeprediction market risk review801skills.sh installs
6majiayu000 avatargithub-trendingmajiayu000/claude-arsenalgithub trending788skills.sh installs