skills.rest
MaiconGambini
MaiconGambiniCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

python-development-python-scaffold

Generate Python project structures with uv, FastAPI, Django, testing, and tooling configuration.

Updated Jul 29, 2026
Search Tags:#fastapi#project structure#python#scaffolding#uv#pyproject.toml#django
One-click install
npx skills add https://github.com/MaiconGambini/opencode-harness-guide --skill python-development-python-scaffold-maicongambini
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: python-development-python-scaffold
Source: https://github.com/MaiconGambini/opencode-harness-guide/tree/main/skills/python-development-python-scaffold
Command: npx skills add https://github.com/MaiconGambini/opencode-harness-guide --skill python-development-python-scaffold-maicongambini

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new Python project involves repetitive decisions about directory layout, dependency management, linting, and testing configuration. This Skill generates complete project skeletons following current best practices so you start coding immediately instead of wiring boilerplate. ## Core Features & Use Cases - Multi-framework scaffolding: Generates project structures for FastAPI services, Django applications, reusable libraries, CLI tools, and generic Python apps. - Modern tooling setup: Configures uv for dependency management, ruff for linting and formatting, pytest for testing, and type hints throughout. - Production-oriented defaults: Includes pyproject.toml, .env.example, Makefile, .gitignore, and layered src/ layouts with API routers, models, schemas, and services. - Use Case: Ask for a new FastAPI microservice and receive a complete directory tree with versioned API endpoints, Pydantic settings, async test configuration, and a Makefile with dev/test/lint commands. ## Quick Start Scaffold a new FastAPI project called inventory-api with uv, pytest, and ruff configured.

Frequently Asked Questions about python-development-python-scaffold

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

FAQPage Schema
How do I scaffold a FastAPI project with uv?▼

Run uv init to create the project, then generate a src layout with api, core, models, schemas, and services packages. Configure pyproject.toml with fastapi, uvicorn, pydantic, and sqlalchemy dependencies plus ruff and pytest dev tools.

What project structure should a Python library use?▼

Use a src layout with the package under src/library_name, a py.typed marker for type checking, and hatchling as the build backend in pyproject.toml. Include tests, README, LICENSE, and classifiers for PyPI publication.

FastAPI vs Django for a new Python web project?▼

FastAPI suits REST APIs, microservices, and async applications with automatic OpenAPI docs. Django fits full-stack applications needing an admin panel, ORM-heavy data models, and built-in authentication.

Does uv replace pip and virtualenv for Python projects?▼

Yes, uv handles project initialization, virtual environment creation via uv venv, and dependency installation via uv add or uv sync. It manages the .venv directory and lockfile in a single toolchain.

How do I configure pytest for async FastAPI tests?▼

Install pytest-asyncio and httpx as dev dependencies, then set asyncio_mode = "auto" and testpaths = ["tests"] under [tool.pytest.ini_options] in pyproject.toml. Use httpx AsyncClient against the FastAPI app in test fixtures.

Related Skills

Explore More Software Engineering Skills→
euxxeuxx
4

mcp-server-dev

Design and build MCP servers with deployment, tool pattern, and framework selection.

Community
Advanced
ZaxbyHubZaxbyHub

contributing

Guides branch, commit, CI gate, and PR workflows for the KnowledgeVault repository.

Official
Intermediate
Eng0AIEng0AI
15

fastapi-backend-template

Generate a FastAPI backend template with PostgreSQL, async SQLAlchemy 2.0, Alembic, and Docker.

Official
Advanced
gelsonsimoesgelsonsimoes

templates

Select and apply prebuilt project scaffolds for multi-stack app startups.

Community
Intermediate