python-dev

Configure FastAPI project scaffolds with strict typing and linting tools.

1|Updated Sep 16, 2025
One-click install
npx skills add https://github.com/sk8metalme/ai-agent-setup --skill python-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-dev
Source: https://github.com/sk8metalme/ai-agent-setup/tree/main/plugins/lang-python/skills/python
Command: npx skills add https://github.com/sk8metalme/ai-agent-setup --skill python-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides guidance and tooling to accelerate modern Python development, focusing on FastAPI, Pydantic, and uvicorn with strong typing, linting, and testing practices to reduce setup time and ensure consistent quality across projects.

Core Features & Use Cases

  • Type hints & static checks: Enforce typing with strict mypy checks and consistent formatting via ruff.
  • Modern API stack: Ready-to-use FastAPI, Pydantic models, SQLAlchemy ORM, and uvicorn setup for fastAPI services.
  • Project scaffolding & standards: Prescribed src layout, pre-commit configuration, and testing setup to accelerate onboarding and maintain quality.

Quick Start

Initialize a new Python FastAPI project with type hints, Pydantic models, and strict lint/type checks.

Frequently Asked Questions about python-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a FastAPI project with strict typing and linting?

FastAPI projects benefit from strict typing enforced via mypy in strict mode, ruff formatting, and pre-commit hooks. This Skill provides a complete scaffold with src/ layout, Pydantic models, SQLAlchemy integration, uvicorn configuration, and testing setup to ensure PEP 8 compliance and consistent quality from project initialization.

What's the best way to configure Python type checking and code formatting for API services?

Type checking and formatting for API services requires mypy strict mode, ruff linting, Google/NumPy docstring standards, and pre-commit automation. This Skill delivers a production-ready configuration across FastAPI, Pydantic, and uvicorn with canonical project structure and tooling to enforce these standards automatically.

Can I use Pydantic with FastAPI and SQLAlchemy in a single project?

Yes. Pydantic handles request/response validation in FastAPI, while SQLAlchemy manages ORM and database operations. This Skill configures both together with strict typing, dependency management via uv, and testing tools, structuring models, schemas, services, and API layers for seamless integration.

Do I need pre-commit hooks for Python linting and type checking?

Pre-commit hooks automate linting, type checking, and formatting before commits, preventing style violations and type errors from reaching the repository. This Skill includes pre-commit configuration tied to ruff, mypy, and docstring standards so checks run automatically on every commit.

How should I organize a FastAPI project directory structure?

FastAPI projects follow a src/ layout with separate directories for api routes, core configuration, models, schemas, services, and tests. This Skill prescribes this canonical structure alongside strict typing, testing frameworks, and linting rules to accelerate onboarding and maintain consistency.

What testing and dependency tools work best with FastAPI and Pydantic?

FastAPI projects use pytest for testing, uv for dependency management, and uvicorn for serving. This Skill integrates these with mypy strict mode, ruff formatting, and pre-commit hooks, delivering a complete toolchain for type-safe, tested, and linted API services.