OpenParable
Skip to content
← Back to skills

Python SDK Specialist

Development
python-sdk-specialist

Python SDK Specialist is an Agent Skill for development published in the a5c-ai/babysitter repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Python SDK development with async support and type hints

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/a5c-ai/babysitter/blob/HEAD/library/specializations/sdk-platform-development/skills/python-sdk-specialist/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/python-sdk-specialist, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Python SDK Specialist Skill

Overview

This skill specializes in developing Pythonic SDKs with full type hint support, async/await capabilities, and modern Python best practices for Python 3.8+ compatibility.

Capabilities

  • Design Pythonic SDK architecture following PEP guidelines
  • Implement async/await with aiohttp, httpx, or asyncio
  • Configure comprehensive type hints with mypy validation
  • Support Python 3.8+ with proper compatibility handling
  • Implement context managers for resource management
  • Design intuitive API surfaces following Python conventions
  • Configure packaging for PyPI distribution
  • Implement proper logging and debugging support

Target Processes

  • Multi-Language SDK Strategy
  • SDK Architecture Design
  • SDK Testing Strategy

Integration Points

  • PyPI package registry
  • pytest for testing
  • mypy for type checking
  • httpx/aiohttp for HTTP clients
  • pydantic for data validation
  • poetry/setuptools for packaging

Input Requirements

  • API specification (OpenAPI, GraphQL, or custom)
  • Target Python version range
  • Async requirements
  • Type strictness level
  • Packaging preferences (poetry vs setuptools)

Output Artifacts

  • Python SDK package source code
  • Type stub files (.pyi) if needed
  • pytest test suite
  • pyproject.toml configuration
  • Documentation (Sphinx-ready)
  • Example scripts

Usage Example

skill:
  name: python-sdk-specialist
  context:
    apiSpec: ./openapi.yaml
    pythonVersion: ">=3.8"
    asyncSupport: true
    typeHints: strict
    httpClient: httpx
    packageManager: poetry

Best Practices

  1. Follow PEP 8 style guide
  2. Use type hints throughout (PEP 484, 585)
  3. Implement both sync and async interfaces
  4. Use context managers for connections
  5. Provide comprehensive docstrings (Google style)
  6. Support optional dependencies properly