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

python-development · laurigates — скилл для Claude Code

Скилл python-development даёт агенту идиомы Python 3.10+: подсказки типов, match, asyncio, отладку. Полезен, когда правите библиотечный код или разбираете чужой.

MIT 192 установок ★ 60 обновлён 2026-11-16

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

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

Скилл — справочник по языку, который агент читает перед правкой кода. Внутри современные аннотации: list[str], str | None, алиасы типов. Разбор словарей через match, контекстные менеджеры, генераторы. Есть отладка (pdb, pytest --pdb) и профилирование: cProfile, line-profiler, py-spy, scalene. Асинхронность: asyncio.gather и asyncio.wait_for с таймаутом.

Внутри SKILL.md — примеры кода и таблица, где сказано, когда брать этот скилл, а когда соседний: uv-run для одиночных скриптов, uv-project-management для нового проекта и зависимостей, python-testing для тестов. Агенту разрешены Read, Grep, Edit и Bash, поэтому он может открыть ваш модуль, переписать его и запустить проверку.

Вручную скилл не вызвать: в метаданных стоит user-invocable: false, он подключается сам, когда в запросе есть Python, подсказки типов или async. Настройку проекта и запуск скриптов он не делает — за этим идите в соседние скиллы.

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

  • Переписать старые List[str] и Optional[...] на синтаксис 3.10+
  • Заменить лесенку if/elif на match по словарю команды
  • Собрать независимые запросы в asyncio.gather и повесить таймаут
  • Найти узкое место профилировщиком, не добавляя его в зависимости проекта
  • Провалиться в pdb прямо из падающего теста pytest

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

  • Перепиши models.py на подсказки типов Python 3.10: list[str], str | None.
  • Замени эту цепочку if на match по словарю команды.
  • Корутины идут по очереди — собери их через asyncio.gather и поставь таймаут.

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

1Через Skills CLI (Vercel)

npx skills add laurigates/claude-plugins --skill python-development -a claude-code

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

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

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

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

Вопросы о python-development

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

Выполните npx skills add laurigates/claude-plugins --skill python-development -a claude-code. Скилл появится по пути ~/.claude/skills/python-development/SKILL.md.

Что делает python-development?

Даёт агенту идиомы Python 3.10+: аннотации типов, match, контекстные менеджеры, asyncio, приёмы отладки и профилирования. Срабатывает сам, когда в запросе упомянуты Python, подсказки типов или async.

Чем отличается от uv-run и uv-project-management?

python-development про сам язык и его идиомы. Одиночные скрипты и разовые команды отданы uv-run, создание проекта и добавление зависимостей — uv-project-management, тесты — python-testing.

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

SKILL.md · MIT
---
created: 2025-12-16
modified: 2026-11-14
reviewed: 2026-04-25
name: python-development
description: Core Python development idioms and language features (3.10+). Use when mentioning Python, type hints, or async. For scripts see uv-run; for project setup see uv-project-management.
user-invocable: false
allowed-tools: Glob, Grep, Read, WebFetch, TodoWrite, WebSearch, Edit, Write, NotebookEdit, Bash(uv run pytest *), Bash(uv add *), Bash(uv lock *), Bash(uv build *)
---

# Python Development

Core Python language concepts, idioms, and best practices.

## When to Use This Skill

| Use this skill when... | Use a focused sibling instead when... |
|---|---|
| Writing idiomatic Python 3.10+ code (match statements, structural pattern matching, PEP 604 unions) | Running a single script or one-off command — use uv-run |
| Adding type hints, decorators, or context managers to library code | Initializing a project or adding dependencies — use uv-project-management |
| Designing async/await flows or refactoring to Pythonic patterns | Writing or running pytest tests — use python-testing |

## Core Expertise

- **Python Language**: Modern Python 3.10+ features and idioms
- **Best Practices**: Pythonic code, design patterns, SOLID principles
- **Debugging**: Interactive debugging and profiling techniques
- **Performance**: Optimization strategies and profiling
- **Async Programming**: async/await patterns and asyncio

## Modern Python Features (3.10+)

### Type Hints

```python
# Modern syntax (Python 3.10+)
def process_items(
    items: list[str],                    # Not List[str]
    mapping: dict[str, int],             # Not Dict[str, int]
    optional: str | None = None,         # Not Optional[str]
) -> tuple[bool, str]:                   # Not Tuple[bool, str]
    """Process items with modern type hints."""
    return True, "success"

# Type aliases
type UserId = int
type UserDict = dict[str, str | int]

def get_user(user_id: UserId) -> UserDict:
    return {"id": user_id, "name": "Alice"}
```

### Pattern Matching (3.10+)

```python
def handle_command(command: dict) -> str:
    match command:
        case {"action": "create", "item": item}:
            return f"Creating {item}"
        case {"action": "delete", "item": item}:
            return f"Deleting {item}"
        case {"action": "list"}:
            return "Listing items"
        case _:
            return "Unknown command"
```

### Structural Pattern Matching

```python
def process_response(response):
    match response:
        case {"status": 200, "data": data}:
            return process_success(data)
        case {"status": 404}:
            raise NotFoundError()
        case {"status": code} if code >= 500:
            raise ServerError(code)
```

## Python Idioms

### Context Managers

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

# Custom context manager
from contextlib import contextmanager

@contextmanager
def database_connection():
    conn = create_connection()
    try:
        yield conn
    finally:
        conn.close()

with database_connection() as conn:
    conn.execute("SELECT * FROM users")
```

### List Comprehensions

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

# Dict comprehension
word_lengths = {word: len(word) for word in ["hello", "world"]}

# Set comprehension
unique_lengths = {len(word) for word in ["hello", "world", "hi"]}

# Generator expression
sum_of_squares = sum(x**2 for x in range(1000000))  # Memory efficient
```

### Iterators and Generators

```python
def fibonacci():
    a, b = 0, 1
    while True:
        yield a
        a, b = b, a + b

# Use generator
fib = fibonacci()
first_ten = [next(fib) for _ in range(10)]

# Generator expression
even_squares = (x**2 for x in range(10) if x % 2 == 0)
```

## Debugging

### Interactive Debugging

```python
import pdb

def problematic_function():
    value = calculate()
    pdb.set_trace()  # Debugger breakpoint
    return process(value)
```

```bash
# Debug on error
python -m pdb script.py

# pytest with debugger
uv run pytest --pdb                     # Drop into pdb on failure
uv run pytest --pdb --pdbcls=IPython.terminal.debugger:TerminalPdb
```

### Performance Profiling

```bash
# CPU profiling
uv run python -m cProfile -s cumtime script.py | head -20

# Line-by-line profiling (temporary dependency)
uv run --with line-profiler kernprof -l -v script.py

# Memory profiling (temporary dependency)
uv run --with memory-profiler python -m memory_profiler script.py

# Real-time profiling (ephemeral tool)
uvx py-spy top -- python script.py

# Quick profiling with scalene
uv run --with scalene python -m scalene script.py
```

### Built-in Debugging Tools

```python
# Trace execution
import sys

def trace_calls(frame, event, arg):
    if event == 'call':
        print(f"Calling {frame.f_code.co_name}")
    return trace_calls

sys.settrace(trace_calls)

# Memory tracking
import tracemalloc

tracemalloc.start()
# ... code to profile
snapshot = tracemalloc.take_snapshot()
top_stats = snapshot.statistics('lineno')
for stat in top_stats[:10]:
    print(stat)
```

## Async Programming

### Basic async/await

```python
import asyncio

async def fetch_data(url: str) -> dict:
    async with httpx.AsyncClient() as client:
        response = await client.get(url)
        return response.json()

async def main():
    result = await fetch_data("https://api.example.com")
    print(result)

asyncio.run(main())
```

### Concurrent Tasks

```python
async def process_multiple():
    # Run concurrently
    results = await asyncio.gather(
        fetch_data("url1"),
        fetch_data("url2"),
        fetch_data("url3"),
    )
    return results

# With timeout
async def with_timeout():
    try:
        result = await asyncio.wait_for(fetch_data("url"), timeout=5.0)
    except asyncio.TimeoutError:
        print("Request timed out")
```

## Design Patterns

### Dependency Injection

```python
from typing import Protocol

class Database(Protocol):
    def query(self, sql: str) -> list: ...

def get_users(db: Database) -> list:
    return db.query("SELECT * FROM users")
```

### Factory Pattern

```python
def create_handler(handler_type: str):
    match handler_type:
        case "json":
            return JSONHandler()
        case "xml":
            return XMLHandler()
        case _:
            raise ValueError(f"Unknown handler: {handler_type}")
```

### Decorator Pattern

```python
from functools import wraps
import time

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

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

## Best Practices

### SOLID Principles

**Single Responsibility:**
```python
# Bad: Class does too much
class User:
    def save(self): pass
    def send_email(self): pass
    def generate_report(self): pass

# Good: Separate concerns
class User:
    def save(self): pass

class EmailService:
    def send_email(self, user): pass

class ReportGenerator:
    def generate(self, user): pass
```

### Fail Fast

```python
def process_data(data: dict) -> str:
    # Validate early
    if not data:
        raise ValueError("Data cannot be empty")
    if "required_field" not in data:
        raise KeyError("Missing required field")

    # Process with confidence
    return data["required_field"].upper()
```

### Functional Approach

```python
# Prefer immutable transformations
def process_items(items: list[int]) -> list[int]:
    return [item * 2 for item in items]  # New list

# Over mutations
def process_items_bad(items: list[int]) -> None:
    for i in range(len(items)):
        items[i] *= 2  # Mutates input
```

## Project Structure (src layout)

```
my-project/
├── pyproject.toml
├── README.md
├── src/
│   └── my_project/
│       ├── __init__.py
│       ├── core.py
│       ├── utils.py
│       └── models.py
└── tests/
    ├── conftest.py
    ├── test_core.py
    └── test_utils.py
```

## See Also

- **uv-run** - Running scripts, temporary dependencies, PEP 723
- **uv-project-management** - Project setup and dependency management
- **uv-tool-management** - Installing CLI tools globally
- **python-testing** - Testing with pytest
- **python-code-quality** - Linting and type checking with ruff/ty
- **python-packaging** - Building and publishing packages
- **uv-python-versions** - Managing Python interpreters

## References

- Python docs: https://docs.python.org/3/
- Type hints: https://docs.python.org/3/library/typing.html
- Async: https://docs.python.org/3/library/asyncio.html
- Detailed guide: See REFERENCE.md

© laurigates · MIT · laurigates/claude-plugins

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

Все скиллы по теме «Языки программирования» →

Сначала — python-development от других авторов.

python-development sammcj Скилл python-development для Claude Code задаёт правила разработки на Python: версии, управление окружением, типизацию и стиль кода. Описывает настройку среды и требования к коду Python-проектов. CX Codex +1 ★ 173звёзд репо python-pro https://github.com/Jeffallan Скилл python-pro для написания типобезопасного Python 3.11+ с полной аннотацией, async-кодом и тестами. Генерирует код с type hints, настраивает mypy в строгом режиме, пишет pytest-тесты с фиксчурами и мокингом. CX Codex +1 9 300установок python Mindrally Задаёт агенту стиль Python-кода: PEP 8, type hints, ранние возвраты и async для I/O. Агент применяет его при написании и правке кода в проекте. CX Codex +1 1 100установок python-expert PCL Team Скилл python-expert настраивает ИИ-ассистента на разработку на современном Python: строгая типизация, стандарты PEP 8, асинхронный код, работа с uv, poetry и ruff. CX Codex +1 277установок writing-python julianobarbosa Скилл writing-python держит агента в правилах Python 3.14+: сначала стандартная библиотека, аннотации типов у всех функций, uv и ruff вместо pip и black. CX Codex +1 134установок async-python-patterns Seth Hobson Скилл async-python-patterns для Claude Code помогает писать асинхронный Python-код с asyncio, async/await и конкурентными задачами. Обрабатывает API-запросы и большое число I/O-операций в приложениях. CX Codex +1 18 055установок python-patterns davila7 Скилл python-patterns задаёт правила проектирования на Python: помогает выбрать фреймворк, настроить асинхронный стек, схемы Pydantic и разметку типов. CX Codex +1 1 135установок

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

Весь набор →
uv-advanced-dependencies Скилл uv-advanced-dependencies для работы с нестандартными источниками зависимостей в uv: репозиториями на GitHub, локальными пакетами в режиме редактирования, приватными индексами. CX Codex +1 332установок uv-tool-management Скилл uv-tool-management для Claude Code управляет глобальными Python CLI-утилитами через uv и запускает их без установки. Заменяет pipx и работает с ruff и pytest. CX Codex +1 328установок imagemagick-conversion Скилл imagemagick-conversion для Claude Code пакетно преобразует, масштабирует и оптимизирует изображения через ImageMagick в командной строке. Конвертирует форматы, создаёт миниатюры и обрабатывает сотни файлов за раз. CX Codex +1 260установок jq-json-processing Скилл jq-json-processing для парсинга, фильтрации и трансформации JSON через jq. Извлекает поля, фильтрует массивы, перестраивает объекты и валидирует синтаксис. CX Codex +1 245установок generate-image Скилл generate-image генерирует изображения из текстового описания через модель Gemini 3 Pro Image, работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 177установок justfile-expert Скилл justfile-expert для Claude Code создаёт и правит Justfile: описывает рецепты, параметры, зависимости и модули. Настраивает команды проекта и автоматизацию задач. CX Codex +1 162установок git-commit-workflow Скилл git-commit-workflow для Claude Code задаёт формат сообщений и правила staging. Помогает разделять изменения по смыслу и не смешивать файлы в одном коммите. CX Codex +1 161установок binary-analysis Скилл binary-analysis помогает агенту исследовать неизвестные бинарные файлы, дампить шестнадцатеричные данные и находить скрытые строки. CX Codex +1 146установок

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

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