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

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

Задаёт правила разработки на Python: строгую типизацию с mypy, линтинг через ruff и тестирование на pytest с проверкой покрытия.

MIT 282 установок ★ 713 обновлён 2026-10-13

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

Что делает python

Скилл настраивает работу с кодовой базой Python по принципам TDD. Внутри заложены шаблоны структуры с разделением на чистую бизнес-логику в core/ и внешние вызовы в infra/, параметры ruff с длиной строки 100 символов, строгий режим mypy и порог покрытия в pytest от 80%.

Прямой вызов пользователем отключён: правила активируются автоматически, когда агент открывает файлы *.py, pyproject.toml, setup.py или списки зависимостей. Инструкции также содержат готовый воркфлоу для GitHub Actions под Python 3.12 и конфигурацию pre-commit хуков с автоформатированием.

Строгий режим mypy запрещает использование type: ignore без пояснений, поэтому агенту придётся явно типизировать все сигнатуры функций.

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

  • настроить конфигурацию ruff, mypy и pytest в pyproject.toml
  • разделить чистую логику и инфраструктурный код сервиса
  • подготовить пайплайн GitHub Actions для проверок на Python 3.12
  • внедрить паттерн Result для обработки ошибок без исключений

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

  • Организуй структуру нового сервиса с разделением на core и infra
  • Напиши unit-тесты на pytest для функции расчёта стоимости
  • Добавь конфигурацию ruff и mypy в pyproject.toml

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

1Через Skills CLI (Vercel)

npx skills add alinaqi/maggy --skill python -a claude-code

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

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

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

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

Вопросы о python

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

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

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

Он заставляет агента писать код с полной типизацией, создавать тесты до реализации и проверять проект инструментами ruff и mypy.

Как активируется этот скилл?

Он не вызывается вручную через слэш-команду: агент подключает его сам при редактировании файлов *.py, setup.py, pyproject.toml или requirements*.txt.

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

SKILL.md · MIT
---
name: python
description: Python development with ruff, mypy, pytest - TDD and type safety
when-to-use: When working on Python files
user-invocable: false
paths: ["**/*.py", "pyproject.toml", "setup.py", "requirements*.txt"]
effort: medium
---

# Python Skill


---

## Type Hints

- Use type hints on all function signatures
- Use `typing` module for complex types
- Run `mypy --strict` in CI

```python
def process_user(user_id: int, options: dict[str, Any] | None = None) -> User:
    ...
```

---

## Project Structure

```
project/
├── src/
│   └── package_name/
│       ├── __init__.py
│       ├── core/           # Pure business logic
│       │   ├── __init__.py
│       │   ├── models.py   # Pydantic models / dataclasses
│       │   └── services.py # Pure functions
│       ├── infra/          # Side effects
│       │   ├── __init__.py
│       │   ├── api.py      # FastAPI routes
│       │   └── db.py       # Database operations
│       └── utils/          # Shared utilities
├── tests/
│   ├── unit/
│   └── integration/
├── pyproject.toml
└── CLAUDE.md
```

---

## Tooling (Required)

```toml
# pyproject.toml
[tool.ruff]
line-length = 100
select = ["E", "F", "I", "N", "W", "UP"]

[tool.mypy]
strict = true

[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = "--cov=src --cov-report=term-missing --cov-fail-under=80"
```

---

## Testing with Pytest

```python
# tests/unit/test_services.py
import pytest
from package_name.core.services import calculate_total

class TestCalculateTotal:
    def test_returns_sum_of_items(self):
        # Arrange
        items = [{"price": 10}, {"price": 20}]
        
        # Act
        result = calculate_total(items)
        
        # Assert
        assert result == 30

    def test_returns_zero_for_empty_list(self):
        assert calculate_total([]) == 0

    def test_raises_on_invalid_item(self):
        with pytest.raises(ValueError):
            calculate_total([{"invalid": "item"}])
```

---

## GitHub Actions

```yaml
name: Python Quality Gate

on: [push, pull_request]

jobs:
  quality:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Setup Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.12'
          
      - name: Install dependencies
        run: |
          pip install -e ".[dev]"
          
      - name: Lint (Ruff)
        run: ruff check .
        
      - name: Format Check (Ruff)
        run: ruff format --check .
        
      - name: Type Check (mypy)
        run: mypy src/
        
      - name: Test with Coverage
        run: pytest
```

---

## Pre-Commit Hooks

```yaml
# .pre-commit-config.yaml
repos:
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.8.0
    hooks:
      - id: ruff
        args: [--fix]
      - id: ruff-format

  - repo: https://github.com/pre-commit/mirrors-mypy
    rev: v1.13.0
    hooks:
      - id: mypy
        additional_dependencies: [pydantic]
        args: [--strict]

  - repo: local
    hooks:
      - id: pytest
        name: pytest
        entry: pytest tests/unit -x --tb=short
        language: system
        pass_filenames: false
        always_run: true
```

Install and setup:
```bash
pip install pre-commit
pre-commit install
```

---

## Patterns

### Pydantic for Data Validation
```python
from pydantic import BaseModel, Field

class CreateUserRequest(BaseModel):
    email: str = Field(..., min_length=5)
    name: str = Field(..., max_length=100)
```

### Dependency Injection
```python
# Don't import dependencies directly in business logic
# Pass them in

# Bad
from .db import database
def get_user(user_id: int) -> User:
    return database.fetch(user_id)

# Good
def get_user(user_id: int, db: Database) -> User:
    return db.fetch(user_id)
```

### Result Pattern (No Exceptions in Core)
```python
from dataclasses import dataclass

@dataclass
class Result[T]:
    value: T | None
    error: str | None
    
    @property
    def is_ok(self) -> bool:
        return self.error is None
```

---

## Python Anti-Patterns

- ❌ `from module import *`
- ❌ Mutable default arguments
- ❌ Bare `except:` clauses
- ❌ Using `type: ignore` without explanation
- ❌ Global variables for state
- ❌ Classes when functions suffice

© alinaqi · MIT · alinaqi/maggy

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

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

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

python Mindrally Задаёт агенту стиль Python-кода: PEP 8, type hints, ранние возвраты и async для I/O. Агент применяет его при написании и правке кода в проекте. CX Codex +1 1 100установок python pproenca С набором правил оптимизации производительности Python 3.11+. Срабатывает при работе с asyncio, структурами данных, управлением памятью, циклами и строками. CX Codex +1 329установок python siviter-xyz Задаёт единый стиль Python: типизация, внедрение зависимостей, структура тестов и модулей. Держит код в одном порядке при правках в существующем проекте. CX Codex +1 353установок python martinholovsky Скилл для бэкенда на Python: типизация, asyncio, проверка ввода и тесты на pytest. Агент сначала пишет падающий тест, потом код. CX Codex +1 229установок python finom Генерирует типизированный Python-пакет из схем Vovk.ts с RPC-функциями, TypedDict и стримингом JSON Lines; автоматизирует создание клиента для готового API. CX Codex +1 ★ 57звёзд репо gravitas-python udaysharmadev Скилл gravitas-python добавляет к GRAVITAS проверки и шаблоны для Python. Он пригодится при ревью, настройке типов, линтинга и pytest. CX Codex +1 419установок python-pro qdhenry Субагент python-pro для Claude Code помогает рефакторить Python-код, оптимизировать его и добавлять сложные функции. Он подключается к таким задачам и пишет тесты вместе с изменениями. CX Codex ★ 1 357звёзд репо pare-python Dave-London MCP-сервер pare-python для Claude Code и Codex, который оборачивает ruff, mypy, pip, uv, black и pytest и возвращает их вывод типизированным JSON. Агент получает готовые данные вместо сырого текста терминала. CX Codex +1 ★ 141звёзд репо writing-python julianobarbosa Скилл writing-python держит агента в правилах Python 3.14+: сначала стандартная библиотека, аннотации типов у всех функций, uv и ruff вместо pip и black. CX Codex +1 134установок python-code-style Seth Hobson Скилл python-code-style для Claude Code задаёт правила стиля Python, линтеров, форматирования и документации для новых модулей, ревью и настройки проекта. CX Codex +1 16 456установок python-projects-guide-cursorrules-prompt-file PatrickJS Правило python-projects-guide-cursorrules-prompt-file задаёт стандарты Python-разработки в Cursor: модульную структуру проекта, форматирование через Ruff и управление пакетами с помощью Rye. CX Codex +1 ★ 41 178звёзд репо

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

Весь набор →
code-graph Скилл code-graph индексирует весь кодовый проект как граф символов и связей. Вместо чтения файлов подряд запрашиваешь у графа сигнатуры функций, цепи вызовов и зону влияния изменений за миллисекунды. CX Codex +1 285установок medusa Скилл помогает собирать headless-магазины на Medusa: модули, API-маршруты, workflow и админский интерфейс. Подходит для backend-задач в e-commerce. CX Codex +1 285установок gemini-review Скилл gemini-review подключает Gemini CLI для ревью кода, проверки безопасности и анализа больших репозиториев. Подходит для локальной работы и CI/CD. CX Codex +1 283установок ticket-craft Скилл ticket-craft форматирует задачи в Jira, Linear или Asana так, чтобы ИИ-агент выполнял их автономно без наводящих вопросов. CX Codex +1 283установок project-tooling Скилл project-tooling проверяет и настраивает CLI-инструменты для работы с GitHub, Vercel, Supabase и Render. Нужен перед началом проекта с CI/CD и облачными сервисами. CX Codex +1 277установок base Скилл base задаёт правила чистого кода, лимиты на размер файлов и строгий TDD-процесс для ИИ-агентов. CX Codex +1 276установок shopify-apps Скилл shopify-apps помогает собирать приложения Shopify на Remix, работать с Admin GraphQL API и создавать checkout-расширения. Пригодится при разработке приложения или расширения для магазина. CX Codex +1 273установок azure-cosmosdb Скилл Claude Code разбирает partition keys, консистентность, change feed и паттерны SDK для Azure Cosmos DB; содержит примеры CRUD, иерархических ключей и cross-partition запросов. CX Codex +1 269установок

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

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