python-development · laurigates — скилл для Claude Code
Скилл python-development даёт агенту идиомы Python 3.10+: подсказки типов, match, asyncio, отладку. Полезен, когда правите библиотечный код или разбираете чужой.
MIT 192 установок ★ 60 обновлён 2026-11-16
npx skills add laurigates/claude-plugins --skill python-development -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/python-development/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/python-development/
1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill python-development -a codex2Вручную: положить файлы
.agents/skills/python-development/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill python-development -a cursor2Вручную: положить файлы
.cursor/skills/python-development/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install laurigates/claude-plugins python-plugin/skills/python-development2Вручную: положить файлы
.github/skills/python-development/SKILL.md1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill python-development -a gemini-cli2Командой платформы
gemini skills install https://github.com/laurigates/claude-plugins --path python-plugin/skills/python-developmentВручную: положить файлы
.devin/skills/python-development/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill python-development -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.