Why is moving logic to a service layer beneficial?

Moving logic to services makes your code much easier to unit test, allows the same logic to be reused in views or celery tasks, and decouples logic from command-line scaffolding.

What is the 'thin-command' pattern in Django?

It is an architectural practice where management commands only handle argument parsing and output formatting, while all business logic is delegated to a separate service layer.

How does it detect anti-patterns?

It analyzes the length of the handle() method, searches for direct ORM calls like Model.objects, and checks for the existence of corresponding service files.

Can this skill automatically refactor my Django code?

Yes, by using the --fix flag, the skill will automatically create new service files and refactor the management command to call those services.

Django Command Architect & Reviewer

Name: Django Command Architect & Reviewer
Author: jpoutrin

byjpoutrin

•

Developer Tools

Analyzes and refactors Django management commands to enforce the thin-command and service-layer architectural pattern.

This skill automates the process of auditing Django management commands to ensure they follow best practices by delegating business logic to a dedicated service layer. It scans for architectural anti-patterns—such as direct ORM queries in the handle method or 'fat' command structures—and provides detailed reports. For teams looking to modernize their codebase, it offers automated refactoring to extract logic into testable service functions, significantly improving code reusability and maintainability.

Key Features

01Provides a --fix mode for rapid architectural modernization

02Scans management commands for architectural anti-patterns and 'fat' handlers

03Automates the extraction of business logic into dedicated service files

04Generates detailed compliance reports with complexity metrics

05Detects direct ORM queries and missing service layer dependencies

068 GitHub stars

Use Cases

01Enforcing standardized coding patterns across multi-agent development teams

02Refactoring complex management commands into reusable service layer functions

03Auditing legacy Django projects for architectural consistency and technical debt

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jpoutrin/product-forge review-django-commands

For use in Claude.ai and ChatGPT

Download Skill