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.