Fastapi Init Skill

What it does

When your agent uses it

• Tasks that involve Backend development
• Tasks that involve Authentication
• Tasks that involve NoSQL databases

Example prompts

• “帮我搭一个 FastAPI 项目”
• “FastAPI 脚手架”
• “FastAPI 一键生成”
• “/fastapi-init-skill”

Requirements

• Python 3
• Docker
• A credential in JWT_SECRET

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

1. 1检测 Python 是否安装 / 版本（需 >= 3.9）
2. 2检测 pip 是否可用
3. 3检测操作系统（Linux / macOS / Windows）
4. 4若未安装：给出明确的中文提示 + 下载链接
5. 5若已安装但版本过低：给出升级指引

What it can do on your machine

Read from SKILL.md and the folder at commit a4a640b. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/ (Python, from the files we listed), which the agent can run.

  Shell commands in SKILL.md call:

  • fastapi
  • curl
  • python
  • pip

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md. Its commands use curl and pip, which can reach the network depending on how they are called.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • JWT_SECRET

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Fastapi Init Skill loads about 1.8k tokens when it runs, and up to ~28k if it reads all its reference files. Until then it costs about 107 tokens; SKILL.md has 431 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~107

When it runs · the whole SKILL.md, loaded when a task matches

~1.8k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~28k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NoteMentions a .env fileSKILL.md:81

  依赖与配置（`requirements.txt`、`.env.example`、`.env`、`.gitignore`）

• NoteMentions a .env fileSKILL.md:93

  2. 从 `.env.example` 复制生成 `.env`（如不存在）

• NoteMentions a .env fileSKILL.md:133

  请编辑 .env 文件修改 JWT_SECRET（搜索 change-me）

• NoteMentions a .env fileSKILL.md:145

  - 表前缀：`wg`（可在 .env 中修改）

• NoteMentions a .env fileSKILL.md:185

  9. **`.env` 与 `.gitignore` 必须随脚手架一起生成，且 `.env` 中的配置必须被服务加载**：`app/config.py` 通过 Pydantic Settings 读取 `.env` 全部配置，禁止在代码中硬

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from jiushiwon/wg-skills at commit a4a640b, republished under its Apache-2.0 licence (© jiushiwon). 431 words, ~1,796 tokens.

name

fastapi-init-skill

description

FastAPI 项目一键初始化技能。面向零基础小白，提供环境探测、自动安装、完整 Web 骨架生成、SSE 流式框架、JWT 鉴权、统一响应封装、文件上传接口、一键启动/重启脚本、Swagger 文档，内置 MySQL（默认）/ PostgreSQL / MongoDB 数据库选择。用户只需说"帮我搭一个 FastAPI 项目"即可一条命令完成从零到跑的完整链路。触发词："FastAPI 脚手架"、"FastAPI 一键生成"、"初始化 FastAPI 项目"、"FastAPI 快速开始"、"fastapi init"、"搭建 FastAPI 服务"、"Python Web 骨架"、"FastAPI 开箱即用"、"FastAPI 零基础"、"FastAPI 小白"、"帮我搭一个 FastAPI"、"新建 FastAPI"、"create fastapi project"、"fastapi starter"。

1. 项目名叫什么？（默认 my-fastapi-app）
2. 用哪个数据库？
   A. MySQL（默认，推荐）
   B. PostgreSQL
   C. MongoDB
   D. 暂时不用数据库
3. 是否需要 Redis？（默认不需要）

✅ 项目 {{project}} 生成完毕！

📁 生成的文件（约 18 个）：
  - 核心模块：app/main.py, config.py, database.py, response.py, exceptions.py, dependencies.py
  - API 路由：health / auth / users / sse / upload
  - 启动脚本：restart.sh, restart.bat（dev/prod 双模式）
  - 数据库：MySQL（已配置 docker-compose.yml，可选 PG / MongoDB / 无数据库）
  - 文档：api-contract.md, docs/project-guide.md

🚀 启动方式：
  开发模式：  ./restart.sh dev        （热重载，日志 logs/dev.log）
  生产模式：  ./restart.sh prod       （后台多 worker，日志 logs/app.log）
  默认：      ./restart.sh            （同 dev）

📖 接口文档：
  Swagger UI：  http://localhost:8080/docs
  ReDoc：       http://localhost:8080/redoc

🔌 SSE 示例：
  curl http://localhost:8080/api/sse/chat

📎 上传示例：
  curl -F "file=@test.png" http://localhost:8080/api/upload

🔑 默认账号：
  注册接口：POST /api/auth/register
  登录接口：POST /api/auth/login

⚠️ 安全提醒：
  请编辑 .env 文件修改 JWT_SECRET（搜索 change-me）
  生产环境务必使用随机密钥！

FastAPI 脚手架、FastAPI 一键生成、初始化 FastAPI 项目、FastAPI 快速开始、
fastapi init、搭建 FastAPI 服务、Python Web 骨架、FastAPI 开箱即用、
FastAPI 零基础、FastAPI 小白、帮我搭一个 FastAPI、新建 FastAPI、
create fastapi project、fastapi starter

© jiushiwon, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 55 other files (scripts, references) in vibeCoding/backend/python/fastapi-init-skill of jiushiwon/wg-skills.

• SKILL.md
• README.md
• SPEC.md
• demo/.env.example
• demo/.gitignore
• demo/Dockerfile
• demo/README.md
• demo/api-contract.md
• demo/app/__init__.py
• demo/app/config.py
• demo/app/database.py
• demo/app/dependencies.py
• demo/app/exceptions.py
• demo/app/main.py
• demo/app/models/__init__.py
• demo/app/models/user.py
• demo/app/response.py
• demo/app/routers
• … and 38 more

Open the folder on GitHubat commit a4a640b