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

writing-python — скилл для Claude Code: правила Python 3.14

Скилл writing-python держит агента в правилах Python 3.14+: сначала стандартная библиотека, аннотации типов у всех функций, uv и ruff вместо pip и black.

MIT 134 установок ★ 17 обновлён 2026-10-14

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

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

Скилл задаёт агенту правила для нового кода на Python 3.14 и выше. Сначала стандартная библиотека: внешний пакет берут, только если без него не обойтись. Аннотации типов у всех функций и параметров. Ошибки поднимаются сразу, с понятным текстом.

Внутри короткие образцы: аннотации, dataclass с field(default_factory=...), разбор событий через match. Отдельный блок про 3.14 — отложенные аннотации, t-строки, except без скобок, concurrent.interpreters, compression.zstd. Дальше ссылки на PATTERNS.md, CLI.md и TESTING.md; два поглощённых скилла лежат справкой в References/code-style.md и References/type-safety.md. Инструменты названы прямо: uv вместо pip и poetry, ruff вместо flake8 и black, плюс pytest и mypy. Агенту разрешены Read, Bash, Grep, Glob.

Раздел с ловушками объясняет, что сломается на старом проекте. dataclass(slots=True) в Python 3.9 молча ничего не делает, int | None в рантайме работает с 3.10, а from __future__ import annotations превращает аннотации в строки и ломает typing.get_type_hints на forward refs к локальным классам.

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

  • написать CLI-утилиту на одной стандартной библиотеке
  • расставить аннотации типов в модуле, где их нет
  • перевести проект с pip и black на uv и ruff
  • поймать ловушки версий: slots, union-синтаксис, отложенные аннотации
  • развести обработку событий через pattern matching

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

  • Напиши CLI на Python 3.14: только стандартная библиотека, аннотации типов везде, потом прогони ruff и mypy.
  • Переведи модуль на uv и ruff, конфиг flake8 больше не нужен.
  • Добавь конфиг через dataclass с slots=True и скажи, что сломается на Python 3.9.

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

1Через Skills CLI (Vercel)

npx skills add julianobarbosa/claude-code-skills --skill writing-python -a claude-code

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

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

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

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

Вопросы о writing-python

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

Выполните npx skills add julianobarbosa/claude-code-skills --skill writing-python -a claude-code. Скилл окажется по пути ~/.claude/skills/writing-python/SKILL.md.

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

Задаёт агенту правила идиоматичного Python 3.14+: стандартная библиотека в приоритете, аннотации типов, ранние ошибки, инструменты uv, ruff, pytest и mypy.

Чем он отличается от скиллов python-infrastructure и uv?

Здесь про стиль кода, типы и возможности 3.14. Фоновые задачи и ретраи вынесены в python-infrastructure, а управление зависимостями и каркас проекта — в uv.

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

SKILL.md · MIT
---
name: writing-python
description: Idiomatic Python 3.14+ development. Use when writing Python code, CLI tools, scripts, or services. Emphasizes stdlib, type hints, uv/ruff toolchain, and minimal dependencies.
allowed-tools: Read, Bash, Grep, Glob
---

# Python Development (3.14+)

## Core Principles

- **Stdlib first**: External deps only when justified
- **Type hints everywhere**: All functions, all parameters
- **Explicit over implicit**: Clear is better than clever
- **Fail fast**: Raise early with informative errors

## Toolchain

```bash
uv           # Package management (not pip/poetry)
ruff         # Lint + format (not flake8/black)
pytest       # Testing
mypy         # Type checking
```

## Quick Patterns

### Type Hints

```python
def process_users(users: list[User], limit: int | None = None) -> list[Result]:
    ...

async def fetch_data(url: str, timeout: float = 30.0) -> dict[str, Any]:
    ...
```

### Dataclasses

```python
from dataclasses import dataclass, field

@dataclass
class Config:
    host: str
    port: int = 8080
    tags: list[str] = field(default_factory=list)
```

### Pattern Matching

```python
match event:
    case {"type": "click", "x": x, "y": y}:
        handle_click(x, y)
    case {"type": "key", "code": code}:
        handle_key(code)
    case _:
        raise ValueError(f"Unknown event: {event}")
```

## Python 3.14 Features

- **Deferred annotations**: No more `from __future__ import annotations`
- **Template strings (t"")**: `t"Hello {name}"` returns Template object
- **except without parens**: `except ValueError, TypeError:`
- **concurrent.interpreters**: True parallelism via subinterpreters
- **compression.zstd**: Zstandard in stdlib
- **Free-threaded build**: No GIL (opt-in)

## References

- [PATTERNS.md](PATTERNS.md) - Code patterns and style
- [CLI.md](CLI.md) - CLI application patterns
- [TESTING.md](TESTING.md) - Testing with pytest

## Tooling

```bash
uv sync                    # Install deps
ruff check --fix .         # Lint and autofix
ruff format .              # Format
pytest -v                  # Test
mypy .                     # Type check
```

---

## Absorbed sub-skills (post-consolidation)

This skill now subsumes the former `python-code-style` and `python-type-safety` skills. Their original SKILL.md content is preserved as deep reference:

| Subject | Path |
|---------|------|
| ruff, mypy, naming, imports, docstrings (Google style) | `References/code-style.md` |
| Type annotations, generics, protocols, strict checking patterns | `References/type-safety.md` |

For system-reliability concerns (background jobs, retries, observability), see the sibling **`python-infrastructure`** skill. For dependency management and project scaffolding, see **`uv`**.

---

## Gotchas

- **`from __future__ import annotations` makes ALL annotations strings** — runtime introspection (`typing.get_type_hints`) needs the actual types available; forward refs to local-scope classes fail.
- **f-string debug syntax (`f"{var=}"`) is 3.8+** — quietly fails (treats `=` as literal) in 3.7 and earlier.
- **`dataclass(slots=True)` is 3.10+** — silently does nothing in 3.9. Use `__slots__` manually for portability.
- **PEP 604 union syntax (`int | None`) is 3.10+ at runtime** — works as a string annotation in 3.9 with `from __future__ import annotations`, fails at runtime introspection.
- **`async def` vs `def` for FastAPI dependencies**: async deps run in the event loop; sync deps run in a thread pool. Mixing without thought causes either blocking or extra context-switch overhead.

© julianobarbosa · MIT · julianobarbosa/claude-code-skills

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

Все скиллы по теме «Языки программирования» →
python-pro https://github.com/Jeffallan Скилл python-pro для написания типобезопасного Python 3.11+ с полной аннотацией, async-кодом и тестами. Генерирует код с type hints, настраивает mypy в строгом режиме, пишет pytest-тесты с фиксчурами и мокингом. CX Codex +1 9 300установок python alinaqi Задаёт правила разработки на Python: строгую типизацию с mypy, линтинг через ruff и тестирование на pytest с проверкой покрытия. CX Codex +1 282установок python-code-style Seth Hobson Скилл python-code-style для Claude Code задаёт правила стиля Python, линтеров, форматирования и документации для новых модулей, ревью и настройки проекта. CX Codex +1 16 456установок modern-python trailofbits Скилл modern-python для Claude Code настраивает Python-проекты с uv, ruff и ty; применяется при создании проектов, написании скриптов и миграции со старых инструментов. CX Codex +1 9 700установок gravitas-python udaysharmadev Скилл gravitas-python добавляет к GRAVITAS проверки и шаблоны для Python. Он пригодится при ревью, настройке типов, линтинга и pytest. CX Codex +1 419установок Python Type Hints taste f Промпт Python Type Hints taste для ChatGPT задаёт правила типизации Python-кода. Он охватывает аннотации, выбор типов и настройку статической проверки. GP ChatGPT ★ 178 201звёзд репо

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

Весь набор →
mkdocs Помогает создать и настроить сайт документации на MkDocs из Markdown-файлов. Помогает собрать, локально просматривать и публиковать сайт. CX Codex +1 157установок loki Скилл помогает настраивать Grafana Loki: выбирать режим развёртывания и хранилище, задавать параметры и писать запросы LogQL. Пригодится при внедрении Loki и разборе проблем. CX Codex +1 148установок consulting-design Скилл consulting-design подключает Gemini к обсуждению архитектуры, поиску компромиссов и генерации проектных альтернатив через MCP-инструменты. CX Codex +1 140установок opentelemetry Скилл по OpenTelemetry: помогает агенту настроить коллектор, развернуть его в Kubernetes и связать приёмники, процессоры и экспортёры в рабочие пайплайны. CX Codex +1 135установок zabbix-api Скилл zabbix-api учит агента управлять Zabbix через API и библиотеку zabbix_utils: хосты, шаблоны, триггеры, история и отправка данных. CX Codex +1 132установок shellcheck Скилл shellcheck находит синтаксические ошибки, проблемы с кавычками и несовместимости с POSIX в bash- и sh-скриптах, а также генерирует готовые diff-исправления. CX Codex +1 129установок shell-prompt Скилл shell-prompt для Claude Code собирает конфиги zsh-промпта Powerlevel10k и vi-режима с формой курсора и индикаторами NORMAL/INSERT. CX Codex +1 125установок azure-ad-sso Скилл azure-ad-sso проводит приложение в Kubernetes через вход Azure AD (Entra ID) по OAuth2/OIDC: App Registration, группы, клиентский секрет в Key Vault. CX Codex +1 124установок

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

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