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

superpowers-python-automation — скилл для Claude Code

Скилл superpowers-python-automation настраивает правила создания надёжных Python-скриптов для работы с REST API: повторы запросов, таймауты, пагинацию и тесты. Пригодится при написании интеграций и синхронизаций данных.

MIT 1 установок ★ 852 обновлён 2026-01-18

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

Что делает superpowers-python-automation

Скилл задаёт архитектуру и правила для скриптов на Python, работающих с внешними REST API. Базовый стек опирается на библиотеку httpx для сетевых запросов и pytest с пакетом respx для тестов. Конфигурация выносится в переменные окружения через pydantic-settings. Проект делится на отдельные файлы: клиент в client.py, структуры данных в models.py, логика передачи в sync.py и запуск через main.py.

Запросы без явных таймаутов на соединение и чтение запрещены, иначе скрипт рискует зависнуть. Повторные попытки разрешаются для сетевых сбоев, ошибок сервера и превышения лимитов с учётом заголовка Retry-After. Ошибки клиента повторно не отправляются, чтобы не тратить запросы впустую. Для надёжности скилл требует сохранять состояние через заголовок Idempotency-Key или локальную базу SQLite.

Токены авторизации и конфиденциальные заголовки исключены из логов. Для проверки работы перед записью скилл обязывает агента добавить флаг --dry-run.

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

  • Настроить HTTP-клиент с обработкой повторов и таймаутов
  • Реализовать постраничную загрузку данных с лимитом шагов
  • Предотвратить дублирование записей через заголовок идемпотентности или SQLite
  • Подготовить тесты для логики трансформации данных с моками на respx

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

  • Напиши скрипт синхронизации данных из REST API в sync.py с обработкой пагинации через курсор
  • Создай клиент на httpx с повторами сетевых ошибок и тестами на pytest
  • Собери CLI-утилиту в main.py с поддержкой флага dry-run для проверки выгрузки

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

1Через Skills CLI (Vercel)

npx skills add anthonylee991/gemini-superpowers-antigravity --skill superpowers-python-automation -a claude-code

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

~/.claude/skills/superpowers-python-automation/SKILL.md

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

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

Вопросы о superpowers-python-automation

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

Выполните команду npx skills add anthonylee991/gemini-superpowers-antigravity --skill superpowers-python-automation -a claude-code. Файл сохранится по пути ~/.claude/skills/superpowers-python-automation/SKILL.md.

Зачем нужен скилл superpowers-python-automation?

Он задаёт стандарты автоматизации: обязательные таймауты, правила повтора сетевых сбоев, защиту от дублей и изоляцию токенов от логов.

Какой HTTP-клиент скилл использует по умолчанию?

Основным клиентом выбран httpx, но скилл разрешает использовать requests, если это принято в текущем проекте.

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

SKILL.md · MIT
---
name: superpowers-python-automation
description: Implements reliable automations in Python for REST APIs: httpx/requests patterns, retries, timeouts, pagination, typing, config, logging, and tests. Use when writing Python scripts/services that call external APIs.
---

# Python Automation Skill

This skill provides concrete Python patterns to implement robust REST API automations.

## When to use this skill
- Python scripts that call one or more REST APIs
- ETL jobs, sync tools, webhook handlers
- CLI tools or small services that integrate external systems

## Preferred stack (defaults)
- HTTP client: **httpx** (preferred) or requests
- Config: env vars + `.env` (optional) with pydantic-settings if appropriate
- Logging: stdlib `logging` with structured-ish fields
- Testing: pytest (+ respx for httpx mocking when useful)

If the project already uses different tools, follow project conventions.

---

## Reference architecture (small but scalable)
- `client.py`: API client wrapper (auth headers, retries, pagination helpers)
- `models.py`: typed payload models (dataclasses or pydantic)
- `sync.py`: orchestration logic (fetch -> transform -> upsert)
- `main.py`: CLI entrypoint
- `tests/`: unit tests for transform + client behavior

## HTTP rules (mandatory)
- Always set timeouts (connect + read)
- Centralize request sending in one function so retries/logging are consistent
- Never log secrets (Authorization headers, tokens)

### Retry policy guidance
Retry on:
- network errors/timeouts
- 429 (respect Retry-After when present)
- 500–599
Optional: 408, and 409 only if operation is safe and semantics known

Do NOT retry on:
- most 400–499 (unless explicitly safe)

### Timeouts
- Set explicit timeouts; do not rely on defaults.
- Use smaller connect timeout; moderate read timeout.

---

## Pagination patterns
Support at least one helper that can handle:
- `next` URL in response
- cursor token in response
- page/limit parameters

Add a hard stop:
- max pages OR max items OR max elapsed time

---

## Idempotency patterns (Python)
Choose and document:
- Use an `Idempotency-Key` header when supported
- Upsert using a stable `external_id`
- Persist a lightweight state store:
  - simplest: SQLite file (recommended for OSS)
  - alternative: JSONL log + compaction

Minimum: ensure repeated runs don’t create duplicates.

---

## Observability (Python)
Minimum logs should include:
- `run_id`
- request: method, url/path, status_code, elapsed_ms, attempt
- record counts: processed/created/updated/skipped/failed

Also include a final summary log line.

---

## Verification requirements
For non-trivial work, add:
- unit tests for mapping/transform logic
- at least one test for pagination or retry behavior (mocked)
- a “dry-run” CLI flag (prints intended writes)

---

## Output format when writing code
- Provide a small directory layout
- Explain how to configure env vars
- Include exact commands to run (and test)

© anthonylee991 · MIT · anthonylee991/gemini-superpowers-antigravity

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

Все скиллы по теме «Бэкенд и API» →
python-testing-strategies c0x12c Скилл python-testing-strategies задаёт агенту правила написания тестов для FastAPI: pytest-asyncio, httpx AsyncClient, фабрики данных и обязательные проверки на каждый эндпоинт. CX Codex +1 ★ 111звёзд репо api-testing laurigates Скилл api-testing для написания тестов REST и GraphQL API через Supertest (TypeScript) и httpx/pytest (Python). Проверяет статусы, схемы ответов, аутентификацию и обработку ошибок. CX Codex +1 106установок python-mcp-server-generator официальный github Скилл python-mcp-server-generator создаёт Python MCP-серверы для подключения функций, API или базы данных к ИИ-клиентам. Подходит, когда нужен новый сервер на MCP Python SDK v2. CX Codex +1 10 418установок python-pro https://github.com/Jeffallan Скилл python-pro для написания типобезопасного Python 3.11+ с полной аннотацией, async-кодом и тестами. Генерирует код с type hints, настраивает mypy в строгом режиме, пишет pytest-тесты с фиксчурами и мокингом. CX Codex +1 9 300установок selenium-automation Mindrally Скилл selenium-automation задаёт агенту правила написания тестов на Selenium WebDriver: Page Object Model, явные ожидания, устойчивые локаторы. CX Codex +1 1 300установок api-test-suite-builder Alireza Rezvani Скилл api-test-suite-builder для Claude Code находит API-маршруты и генерирует тесты для них. Запускается по запросу создать проверки REST-точек, интеграционный набор или контрактные тесты. CX Codex +1 660установок

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

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

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