feiwanghub/playground

Overview

This skill scaffolds a new FastAPI project with a standard, production-ready directory layout and basic configuration files. It generates an entry point, dependency list, and documentation stub so you can start building API endpoints immediately. The output is minimal and focused on common FastAPI patterns to reduce repetitive setup work.

How this skill works

Running the provided script creates a project folder containing main.py with a Hello World endpoint and an item lookup endpoint, a requirements.txt listing core dependencies, and a README.md with quick start instructions. The scaffold follows a simple, extensible structure so you can add routers, models, and tests without reworking the layout. Generated files are plain text and easy to customize to your team’s conventions.

When to use it

• Starting a new FastAPI microservice or prototype quickly
• Onboarding new developers with a consistent project template
• Creating reproducible demo projects or tutorials
• Standardizing basic project files across multiple APIs
• Saving time on repetitive project initialization tasks

Best practices

• Rename and adapt the scaffolded main.py to match your app’s package structure before adding many routes
• Pin dependency versions in requirements.txt for reproducible builds
• Add CI/CD and test scaffolding early to prevent diverging project setups
• Organize larger projects into app, api, and models subpackages from the start
• Use virtual environments and document setup steps in the README

Example use cases

• Generate a new API called my-api-project to demonstrate endpoint patterns in a workshop
• Bootstrap a small internal microservice that exposes a few REST endpoints
• Create a sample app for a technical blog post showing FastAPI basics
• Quickly produce a consistent project baseline for a multi-team API onboarding
• Build a prototype to validate API design before investing in full architecture