py-scaffold

Scaffold a Python/FastAPI backend with clean architecture and SQLAlchemy async setup.

3|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/vndee/engineering-skills --skill py-scaffold
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: py-scaffold
Source: https://github.com/vndee/engineering-skills/tree/main/.claude/skills/py-scaffold
Command: npx skills add https://github.com/vndee/engineering-skills --skill py-scaffold

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scaffold a ready-to-use Python/FastAPI backend skeleton with clean architecture, SQLAlchemy async setup, Alembic migrations, and strict typing from day one.

Core Features & Use Cases

  • Project skeleton with domain, application, infrastructure, and interfaces layers.
  • Async SQLAlchemy setup with Alembic support and typed models.
  • App factory pattern with lifespan management and health checks.
  • Built-in tooling: mypy strict typing, FastAPI, and test-ready structure.

Quick Start

Bootstrap a new Python/FastAPI project using the scaffold to initialize the full backend skeleton.

Frequently Asked Questions about py-scaffold

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

FAQPage Schema
How do I scaffold a FastAPI backend with clean architecture and async SQLAlchemy?

You can scaffold a typed FastAPI backend by generating a project skeleton with domain, application, infrastructure, and interfaces layers, alongside async SQLAlchemy setup and Alembic migrations.

What is the best way to structure a new FastAPI microservice for strict mypy typing?

The best way to structure a FastAPI microservice for strict typing is using a modular layered architecture with an app factory pattern, ensuring typed code and mypy strict checking from day one.

Does this scaffolding tool include Alembic for database migrations?

Yes, the scaffolding tool includes Alembic support for database migrations, providing async SQLAlchemy setup with typed models out of the box for your FastAPI backend.

Can I bootstrap a production-grade Python API service with health checks using this scaffold?

Yes, you can bootstrap a production-grade Python API service that includes a runnable app factory pattern with lifespan management and built-in health checks.

What are the limitations of using a pre-built scaffold for a FastAPI backend?

Using this pre-built scaffold enforces specific clean architecture layers and strict typing rules, which may require refactoring if your project demands a different structural pattern or less rigid mypy configurations.