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