api-design-python

Installation
SKILL.md

Python API — design and build (FastAPI + async ORM)

This skill produces a working, deployable API — not a tutorial. It has two halves:

  • Sections 0–2 — design. What the API promises, how it is versioned, and what changes when the domain is not a blog.
  • Sections 3–21 — build. One skeleton, one set of conventions, and the handful of decisions that must be asked instead of assumed (Appendix A).

Rules are IDs (DES-3, CFG-1, EP-4, …) so they can be referenced in review. Appendices B–F trace every rule back to evidence; Appendix G explains the limits of that evidence.

Nothing in the build half is mandatory. Each layer — database, migrations, auth, uploads, email, frontend, containers, CI, health checks — exists only if the target API has that requirement. Section 1 starts with the decision table; read it before generating anything.

Installs
1
Repository
phenpen/perski
First Seen
Oct 31, 2026