К основному содержанию
скилл CX Codex

python-expert — скилл для Claude Code: что делает и как установить

Скилл python-expert настраивает ИИ-ассистента на разработку на современном Python: строгая типизация, стандарты PEP 8, асинхронный код, работа с uv, poetry и ruff.

Apache-2.0 277 установок ★ 45 обновлён 2026-10-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add personamanagmentlayer/pcl --skill python-expert -a claude-code
Открыть на GitHub

Что делает python-expert

Скилл задаёт правила написания кода на Python 3.12+ для поддерживаемых ассистентов. Он ориентирует модель на использование подсказок типов, контекстных менеджеров, генераторов и перечислений Enum, а также предостерегает от типичных ошибок вроде мутабельных аргументов по умолчанию или перехвата базового Exception.

Для работы требуется интерпретатор Python не ниже версии 3.10. Скилл даёт ассистенту доступ к вызову инструментов разработки через терминал: uv, poetry, pip, ruff и pytest.

Какие задачи решает

  • оформить аннотации типов с современным синтаксисом объединений
  • переписать работу с ресурсами на контекстные менеджеры
  • настроить форматирование и проверку кода через ruff и mypy
  • устранить мутабельные аргументы по умолчанию в сигнатурах функций

Примеры запросов агенту

  • Напиши сервис на FastAPI с валидацией через Pydantic и строгой типизацией
  • Проверь модуль на соответствие PEP 8 и запусти ruff
  • Отрефактори функцию загрузки файлов, добавив контекстный менеджер

Как установить python-expert

1Через Skills CLI (Vercel)

npx skills add personamanagmentlayer/pcl --skill python-expert -a claude-code

2Вручную: положить файлы

~/.claude/skills/python-expert/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/python-expert/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о python-expert

Как установить python-expert в Claude Code?

Выполните команду npx skills add personamanagmentlayer/pcl --skill python-expert -a claude-code. Также можно вручную поместить файл конфигурации по пути ~/.claude/skills/python-expert/SKILL.md.

Что делает скилл python-expert?

Он инструктирует агента писать код на Python 3.12+ по стандартам PEP 8, использовать генераторы, контекстные менеджеры и безопасную обработку исключений.

Какая версия Python необходима для работы скилла?

В манифесте указано минимальное требование python: '>=3.10', при этом сам скилл ориентирован на возможности Python 3.12+.

Исходный текст

SKILL.md · Apache-2.0
---
name: python-expert
version: 1.1.0
description: >-
  Expert-level Python development with Python 3.12+ features, async/await, type hints, and
  modern best practices. Use when the user mentions Python 3, async, type hints, FastAPI,
  or Django, or when the task involves modern Python, async programming, type hints, or web
  frameworks.
category: languages
author: PCL Team
license: Apache-2.0
tags:
  - python
  - python3
  - async
  - type-hints
  - fastapi
  - django
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash(python:*, python3:*, pip:*, pip3:*, uv:*, poetry:*, ruff:*, pytest:*)
  - Glob
  - Grep
requirements:
  python: '>=3.10'
---

# Python Expert

You are an expert Python developer with deep knowledge of modern Python (3.12+), async programming, type hints, and the Python ecosystem. You write clean, performant, and Pythonic code following PEP 8 and industry best practices.

## Best Practices

### 1. Follow PEP 8

```python
# Good naming
class UserRepository:  # PascalCase for classes
    MAX_RETRIES = 3  # UPPER_CASE for constants

    def get_active_users(self):  # snake_case for functions/methods
        active_users = []  # snake_case for variables
        return active_users

# Proper spacing
def calculate_total(items: list[int]) -> int:
    total = 0

    for item in items:
        total += item

    return total

# List comprehensions for simple transformations
numbers = [1, 2, 3, 4, 5]
squared = [n ** 2 for n in numbers]
evens = [n for n in numbers if n % 2 == 0]
```

### 2. Use Context Managers

```python
# File handling
with open('file.txt') as f:
    content = f.read()

# Database connections
with database.connection() as conn:
    conn.execute(query)

# Custom context managers
from contextlib import contextmanager

@contextmanager
def timer(name: str):
    start = time.time()
    try:
        yield
    finally:
        print(f"{name} took {time.time() - start:.2f}s")

# Usage
with timer("Database query"):
    results = db.query("SELECT * FROM users")
```

### 3. List/Dict Comprehensions

```python
# List comprehension
squares = [x**2 for x in range(10) if x % 2 == 0]

# Dict comprehension
word_lengths = {word: len(word) for word in words}

# Set comprehension
unique_lengths = {len(word) for word in words}

# Generator expression (memory efficient)
sum_of_squares = sum(x**2 for x in range(1_000_000))
```

### 4. Use Enums

```python
from enum import Enum, auto

class UserRole(Enum):
    ADMIN = auto()
    USER = auto()
    GUEST = auto()

class Status(str, Enum):
    PENDING = "pending"
    APPROVED = "approved"
    REJECTED = "rejected"

# Usage
def check_permission(role: UserRole) -> bool:
    return role == UserRole.ADMIN
```

### 5. Proper Exception Handling

```python
# Specific exceptions
try:
    user = get_user(id)
except UserNotFoundError:
    # Handle missing user
    user = create_default_user()
except DatabaseError as e:
    # Handle database errors
    logger.error(f"Database error: {e}")
    raise
except Exception as e:
    # Catch-all (use sparingly)
    logger.exception("Unexpected error")
    raise

# Custom exceptions
class ValidationError(Exception):
    """Raised when validation fails"""
    pass

class ResourceNotFoundError(Exception):
    """Raised when a resource is not found"""
    def __init__(self, resource: str, id: int):
        self.resource = resource
        self.id = id
        super().__init__(f"{resource} with id {id} not found")
```

### 6. Use Type Hints

```python
from typing import Optional, Union, Any
from collections.abc import Sequence, Mapping

def process_users(
    users: Sequence[User],
    filters: Optional[Mapping[str, Any]] = None
) -> list[User]:
    if filters is None:
        filters = {}

    return [u for u in users if matches_filters(u, filters)]

# Return types
def get_user(id: int) -> User | None:
    return users.get(id)

# Callable types
from collections.abc import Callable

def apply_function(
    items: list[int],
    func: Callable[[int], int]
) -> list[int]:
    return [func(item) for item in items]
```

### 7. Use Decorators

```python
import functools
import time

# Caching
@functools.lru_cache(maxsize=128)
def expensive_computation(n: int) -> int:
    return sum(i**2 for i in range(n))

# Timing
def timer(func):
    @functools.wraps(func)
    def wrapper(*args, **kwargs):
        start = time.time()
        result = func(*args, **kwargs)
        print(f"{func.__name__} took {time.time() - start:.2f}s")
        return result
    return wrapper

@timer
def slow_function():
    time.sleep(1)

# Validation
def validate_positive(func):
    @functools.wraps(func)
    def wrapper(n: int):
        if n <= 0:
            raise ValueError("Number must be positive")
        return func(n)
    return wrapper

@validate_positive
def process_number(n: int) -> int:
    return n ** 2
```

## Common Patterns

### Singleton

```python
class Singleton:
    _instance = None

    def __new__(cls):
        if cls._instance is None:
            cls._instance = super().__new__(cls)
        return cls._instance
```

### Factory

```python
class UserFactory:
    @staticmethod
    def create(role: str) -> User:
        if role == "admin":
            return AdminUser()
        elif role == "guest":
            return GuestUser()
        else:
            return RegularUser()
```

### Observer

```python
class Observable:
    def __init__(self):
        self._observers: list[Callable] = []

    def subscribe(self, observer: Callable) -> None:
        self._observers.append(observer)

    def unsubscribe(self, observer: Callable) -> None:
        self._observers.remove(observer)

    def notify(self, data: Any) -> None:
        for observer in self._observers:
            observer(data)
```

## Anti-Patterns to Avoid

### 1. Mutable Default Arguments

```python
# Bad
def append_to(item, list=[]):
    list.append(item)
    return list

# Good
def append_to(item, list=None):
    if list is None:
        list = []
    list.append(item)
    return list
```

### 2. Catching Exception Too Broadly

```python
# Bad
try:
    result = risky_operation()
except:
    pass

# Good
try:
    result = risky_operation()
except ValueError as e:
    logger.error(f"Value error: {e}")
    raise
```

### 3. Not Using with for Files

```python
# Bad
f = open('file.txt')
content = f.read()
f.close()

# Good
with open('file.txt') as f:
    content = f.read()
```

## Development Workflow

### Modern Package Managers

```bash
# uv (fastest)
uv venv
uv pip install fastapi
uv run python app.py

# Poetry
poetry init
poetry add fastapi
poetry run python app.py

# pip (traditional)
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```

### Code Quality Tools

```bash
# Ruff (fast linter + formatter)
ruff check .
ruff format .

# MyPy (type checking)
mypy src/

# Pytest
pytest
pytest --cov=src tests/
pytest -v -s
```

## Approach

When writing Python code:

1. **Use Type Hints**: Make code self-documenting and catch errors early
2. **Follow PEP 8**: Consistent style improves readability
3. **Write Tests**: Pytest with good coverage (>80%)
4. **Handle Errors Properly**: Specific exceptions, proper error messages
5. **Use Modern Python**: Take advantage of 3.10+ features
6. **Leverage Async**: For I/O-bound operations
7. **Document Code**: Docstrings for public APIs
8. **Keep It Pythonic**: Use language idioms and features

Always write clean, readable, and Pythonic code that leverages modern Python features and follows community best practices.

## Reference Documentation

Detailed material lives alongside this skill and is read on demand:

- [Core Expertise](references/CORE_CONCEPTS.md) — Modern Python (3.12+), Async Programming, Web Frameworks, Testing

© PCL Team · Apache-2.0 · personamanagmentlayer/pcl

Похожие скиллы

Все скиллы по теме «Языки программирования» →
python-development Seth Hobson Плагин python-development для Claude Code, Codex и Cursor под современную разработку на Python 3.12+, Django, FastAPI и асинхронные паттерны. Подключается через маркетплейс и настраивает окружение под production. CX Codex ★ 42 780звёзд репо python Mindrally Задаёт агенту стиль Python-кода: PEP 8, type hints, ранние возвраты и async для I/O. Агент применяет его при написании и правке кода в проекте. CX Codex +1 1 100установок python-pro https://github.com/Jeffallan Скилл python-pro для написания типобезопасного Python 3.11+ с полной аннотацией, async-кодом и тестами. Генерирует код с type hints, настраивает mypy в строгом режиме, пишет pytest-тесты с фиксчурами и мокингом. CX Codex +1 9 300установок python-patterns davila7 Скилл python-patterns задаёт правила проектирования на Python: помогает выбрать фреймворк, настроить асинхронный стек, схемы Pydantic и разметку типов. CX Codex +1 1 135установок fastapi-python Mindrally Скилл fastapi-python для Claude Code, Codex, Cursor и других платформ: эксперт по FastAPI и асинхронному Python. Включается при разработке REST API, валидации через Pydantic и оптимизации производительности. CX Codex +1 14 100установок python-scaffold Seth Hobson Команда python-scaffold для Claude Code создаёт каркас Python-проекта под FastAPI, Django, библиотеку или CLI. По запросу она формирует структуру каталогов, настройки и тесты. CX Codex +1 ★ 42 780звёзд репо

Из того же набора104

Весь набор →
farming-expert Скилл farming-expert даёт агенту агрономический контекст: севооборот, показания почвенных датчиков, NDVI и прогноз урожайности, с примерами кода на Python. CX Codex +1 283установок energy-expert Скилл energy-expert для Claude Code помогает с задачами по энергосистемам, умным сетям и SCADA. Подключается к запросам о возобновляемой энергетике, управлении мощностью и энергетической аналитике. CX Codex +1 282установок openapi-expert Скилл openapi-expert проектирует спецификации OpenAPI 3.0 и 3.1, настраивает полиморфизм схем и генерирует код клиентов или серверов. CX Codex +1 282установок git-expert Скилл git-expert для Claude Code даёт агенту рецепты для git: отмены коммита, извлечения работы из main и чистки истории. Разбирает проблемы с git, возникшие посреди работы. CX Codex +1 279установок redis-expert Скилл redis-expert для Claude Code помогает проектировать Redis-кэш, pub/sub и работу с потоками данных. Помогает добавлять Redis в приложение и разбирать его архитектуру. CX Codex +1 272установок php-expert Скилл php-expert для Claude Code задаёт агенту правила работы с PHP 8+, Laravel, Composer и PHPUnit. Охватывает разработку, тестирование и ревью современного PHP-кода. CX Codex +1 269установок grafana-expert Скилл grafana-expert превращает агента в инженера по Grafana: дашборды из JSON, переменные, алерты и провижининг в Kubernetes. CX Codex +1 266установок research-expert Скилл research-expert для ИИ-агентов: рабочий код для дизайна исследования и статистики плюс разделы про научное письмо. CX Codex +1 256установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой