python

Refactor a Python file using ruff, mypy, and modern patterns

Use this agent when implementing async/await patterns, debugging asyncio issues, integrating sync and async code, or optimizing concurrent I/O operations. Specializes in asyncio, aiohttp, async database drivers, and async testing. Examples: <example> Context: User has blocking code in async function user: 'My async endpoint is slow' assistant: 'I'll use async-python-specialist to identify blocking calls' <commentary>Async debugging requires deep asyncio knowledge</commentary> </example> <example> Context: User needs concurrent I/O user: 'How do I run multiple API calls concurrently?' assistant: 'I'll use the async-python-specialist for asyncio.gather patterns' <commentary>Concurrency patterns need specialized guidance</commentary> </example> <example> Context: User mixing sync and async user: 'How do I call a sync library from async code?' assistant: 'I'll use async-python-specialist for run_in_executor patterns' <commentary>Sync/async bridging is a common pain point</commentary> </example>

Use this agent when building Django applications, implementing Django ORM patterns, working with Django REST Framework, or optimizing database queries. Specializes in Django 5.0+ async views, DRF serializers, service layer architecture, and query optimization. Examples: <example> Context: User has N+1 query problem user: 'My Django view is making hundreds of queries' assistant: 'I'll use the django-specialist agent to optimize with select_related/prefetch_related' <commentary>Django-specific query optimization requires ORM expertise</commentary> </example> <example> Context: User structuring Django project user: 'Where should I put my business logic in Django?' assistant: 'I'll use the django-specialist agent to show service layer patterns' <commentary>Architecture patterns are Django-specific</commentary> </example> <example> Context: User building DRF API user: 'How do I structure my DRF serializers?' assistant: 'I'll use django-specialist for Input/Output serializer patterns' <commentary>DRF patterns require specialized knowledge</commentary> </example>

Use this agent when building FastAPI applications, implementing dependency injection, working with Pydantic v2 models, or optimizing async route handlers. Specializes in FastAPI patterns, SQLAlchemy 2.0 async integration, and modern API design. Examples: <example> Context: User building FastAPI endpoint user: 'How do I implement dependency injection in FastAPI?' assistant: 'I'll use the fastapi-specialist agent to show proper DI patterns' <commentary>FastAPI-specific features require specialized knowledge</commentary> </example> <example> Context: User needs async database integration user: 'Set up SQLAlchemy 2.0 with async FastAPI' assistant: 'I'll use fastapi-specialist for async SQLAlchemy integration patterns' <commentary>Async DB patterns are framework-specific</commentary> </example> <example> Context: User has Pydantic validation questions user: 'How do I use computed fields in Pydantic v2?' assistant: 'I'll use the fastapi-specialist agent for Pydantic v2 patterns' <commentary>Pydantic v2 is tightly integrated with FastAPI</commentary> </example>

Use this agent when making Python architecture decisions, selecting frameworks, coordinating multiple Python skills, or reviewing Python code for best practices. Specializes in framework selection (FastAPI/Django/Flask), project structure, and dispatching to specific skills. Examples: <example> Context: User needs to build a REST API user: 'Should I use FastAPI or Django for my API?' assistant: 'I'll use the python-expert agent to analyze requirements and recommend a framework' <commentary>Framework selection requires architecture expertise</commentary> </example> <example> Context: User needs project setup with testing user: 'Set up a Python project with FastAPI and pytest' assistant: 'I'll use python-expert to coordinate python-project and python-testing skills' <commentary>Multi-skill coordination is the agent's primary role</commentary> </example> <example> Context: User asking about Python project structure user: 'How should I structure my microservice?' assistant: 'I'll use the python-expert agent for architectural guidance' <commentary>Architecture questions beyond skill scope need this agent</commentary> </example>

Use when Python code runs slowly, needs profiling, requires async/await patterns, or needs concurrent execution - covers profiling tools, optimization patterns, and asyncio; measure before optimizing (plugin:python@dot-claude)

Use when creating Python projects, managing dependencies with uv, configuring pyproject.toml, building packages, or publishing to PyPI - covers project initialization, dependency management, and distribution; NOT for testing or performance (plugin:python@dot-claude)

Use when writing pytest tests, creating fixtures, mocking dependencies, or testing async code - provides patterns that verify actual behavior with proper fixtures and parametrization; prevents testing mocks instead of code (plugin:python@dot-claude)

2 hooks across 2 events