skills.rest
michaelalber
michaelalberCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

python-arch-review

Automate Python code quality checks with Ruff, mypy, radon, bandit, and pytest-cov.

2|Updated Jan 31, 2026
Search Tags:#code quality#testing#tdd#security#refactoring#python#mypy
One-click install
npx skills add https://github.com/michaelalber/ai-toolkit --skill python-arch-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: python-arch-review
Source: https://github.com/michaelalber/ai-toolkit/tree/main/skills/python-arch-review
Command: npx skills add https://github.com/michaelalber/ai-toolkit --skill python-arch-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enforces rigorous quality standards and a disciplined Test-Driven Development (TDD) workflow for Python projects, ensuring code is maintainable, secure, and well-tested.

Core Features & Use Cases

  • TDD Orchestration: Guides users through the Red-Green-Refactor-Quality Check cycle for every code change.
  • Automated Quality Gates: Integrates Ruff, mypy, radon, bandit, and pytest-cov to enforce style, type safety, complexity, security, and coverage.
  • YAGNI Enforcement: Promotes writing only the necessary code, avoiding premature abstraction.
  • Use Case: When developing a new Python module, use this Skill to ensure every line of code is written with a failing test first, passes all automated checks, and adheres to best practices before committing.

Quick Start

Use the python-arch-review skill to run the quality gate on the 'src/utils.py' file.

Frequently Asked Questions about python-arch-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce Test-Driven Development (TDD) and code quality in Python?▼

You can enforce TDD and code quality in Python by automating a Red-Green-Refactor-Quality Check cycle that requires a failing test before implementation, followed by automated linting, type checking, and coverage validation.

What is the Red-Green-Refactor-Quality Check cycle for Python development?▼

The Red-Green-Refactor-Quality Check cycle is a TDD workflow where you first write a failing test (Red), make it pass (Green), refactor the code, and finally run automated quality gates using tools like Ruff, mypy, and radon to ensure robustness.

How do I integrate mypy, radon, and security scanners into my Python workflow?▼

You integrate mypy, radon, and bandit by running them as automated quality gates after refactoring, ensuring your Python code adheres to type safety, complexity limits, and security standards before committing changes.

Does this automated Python code review support the YAGNI principle?▼

Yes, this automated Python code review enforces the YAGNI (You Aren't Gonna Need It) principle by promoting the writing of only necessary code and actively discouraging premature abstraction during the development workflow.

Can I use this TDD workflow to check an existing Python module like src/utils.py?▼

Yes, you can use this TDD workflow on existing files like src/utils.py by running the integrated quality gate, which applies Ruff, mypy, radon, bandit, and pytest-cov to evaluate style, types, complexity, security, and coverage.

Related Skills

Explore More Software Engineering Skills→
hector-mannyhector-manny

django-verification

Automates Django project verification with migrations, linting, tests, security scans, and deployment checks.

Community
Advanced
evanfang0054evanfang0054

requesting-code-review

Automate code review requests with detailed context for reviewers.

Community
Advanced
vuralserhat86vuralserhat86
43

tdd_workflow

Generate tests and guide Red-Green-Refactor cycles for Jest, Pytest, JUnit, and Vitest.

Community
Advanced
R2W1csR2W1cs
1

lint-and-validate

Lint and validate JavaScript and Python code for syntax and style issues.

Community
Intermediate