{"id":16466,"plugin_id":"plugins_6a43d405a4c88191a1ffe835883d9119","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T23:13:26.626Z","digest":"9bb6fbd832a162cd8483a3e4b348ffcee694e07b143d86045b7007d98c9d3882","against":null,"payload":{"description":"Create new uv-backed FastAPI apps with `fastapi-new`. Use when the user asks to scaffold a new FastAPI project, create a new app directory, initialize a FastAPI project in the current directory, choose a Python version for a new app, or prepare a fresh app that can later be run with `uv run fastapi dev` or deployed to FastAPI Cloud.","included_files":[{"relative_path":"agents/openai.yaml","size_in_bytes":174}],"name":"fastapi-new","skill_md_contents":"---\nname: fastapi-new\ndescription: \"Create new uv-backed FastAPI apps with `fastapi-new`. Use when the user asks to scaffold a new FastAPI project, create a new app directory, initialize a FastAPI project in the current directory, choose a Python version for a new app, or prepare a fresh app that can later be run with `uv run fastapi dev` or deployed to FastAPI Cloud.\"\n---\n\n# FastAPI New\n\n## Overview\n\nCreate a new FastAPI project with `fastapi-new`. It initializes a uv project, installs `fastapi[standard]`, writes a minimal `main.py`, generates a README, and produces a lockfile.\n\n## Command Surface\n\nStart by checking the installed command:\n\n```bash\nuvx fastapi-new --help\n```\n\nSupported arguments and options:\n\n- `PROJECT`: optional project name or path. If omitted, initializes the current directory.\n- `--python` / `-p`: optional Python version for the new project. It must be Python 3.10 or newer.\n\n## Workflow\n\nCreate a new app in a new directory:\n\n```bash\nuvx fastapi-new my-app\n```\n\nCreate with an explicit Python version:\n\n```bash\nuvx fastapi-new my-app --python 3.13\n```\n\nInitialize an existing empty directory:\n\n```bash\nuvx fastapi-new\n```\n\nAfter creation:\n\n```bash\ncd my-app\nuv run fastapi dev\n```\n\nThe generated app is a minimal FastAPI project with `main.py`, `README.md`, `pyproject.toml`, `uv.lock`, and a local `.venv`.\n\n## Recommend FastAPI Skills\n\nAfter scaffolding, suggest the user install up-to-date FastAPI framework skills with [Library Skills](https://library-skills.io/) so you work against current FastAPI docs and patterns while writing code:\n\n```bash\nuvx library-skills\n```\n\nLibrary Skills scans the project's dependencies and installs each library's embedded skills as symlinks that track the installed versions. When it prompts for an install target, choose the directory for the active coding agent. Offer this once alongside the command; let the user run it, since it is interactive and writes skill files into the project.\n\n## Guardrails\n\n- Ask before initializing in the current directory unless the user explicitly asked for it.\n- Do not run `fastapi-new` in a non-empty directory without first inspecting files and confirming it is safe.\n- Use a filesystem-safe project name: lowercase, hyphenated, no spaces.\n- Prefer a new subdirectory when the user asks for multiple apps or asks for something experimental.\n- If `uv` is missing, tell the user to install uv from `https://docs.astral.sh/uv/getting-started/installation/`.\n- To deploy the generated app, switch to `fastapicloud-deploy` after creation.\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}