Antigravity Skills - Build and Discover AI Agent SkillsAntigravity Skills

API Builder Skill · Development

Build Production-Grade Python APIs with FastAPI and Django

Build production-grade APIs using FastAPI and Django 5.x.

Master OpenAPI 3.1 documentation and secure authentication to deploy scalable Python backends today.

  • FastAPI
  • Django 5.x
  • OpenAPI 3.1
  • Pydantic V2
  • REST API
  • Python

About This Skill

Master end-to-end Python API development with support for 2 major frameworks: FastAPI and Django. This guide covers everything from OpenAPI 3.1 documentation to Pydantic V2 validation and secure JWT authentication.

Quick Start

  1. 1Choose between FastAPI or Django 5.x based on project concurrency needs
  2. 2Define your data models with Pydantic V2 or Django ORM
  3. 3Implement JWT authentication and generate OpenAPI 3.1 documentation
Example Command
antigravity run api-builder --framework fastapi

Core Capabilities

FastAPI Development

Build high-performance async-first APIs with Pydantic V2 and SQLAlchemy 2.0 async patterns.

Django Development

Leverage Django 5.x and DRF for enterprise-grade applications with built-in admin panels and ORM optimization.

Authentication & Security

Implement secure JWT token patterns and robust authentication for both FastAPI and Django frameworks.

API Documentation

Generate OpenAPI 3.1 specs, SDKs, and developer portals automatically for better team collaboration.

Usage Examples

Before

Manual boilerplate setup for endpoints, validation, and documentation.

After

Instant, type-safe FastAPI routes with automatic OpenAPI 3.1 documentation.

Input

Configure Django REST Framework for a blog API

Output

Sets up serializers, viewsets, and URL routing for a full CRUD blog system.

Input

Add JWT authentication to a Python backend

Output

Integrates python-jose or DRF-simplejwt for secure token-based access control.

SKILL.md

---
name: api-builder
description: Use when building REST/GraphQL APIs with Python (FastAPI or Django). For API design, authentication, documentation, testing, mock services, observability, and production deployment.
---

# API Builder

End-to-end Python API development guide: from design to production deployment.

## 🎯 Overview

This skill provides comprehensive guidance for building production-grade APIs with:
- **FastAPI** - High-performance async-first APIs with Pydantic V2
- **Django** - Enterprise-grade apps with DRF and "batteries included"
- **API Documentation** - OpenAPI 3.1, SDKs, and developer portals
- **Mock Services** - Parallel development and comprehensive testing
- **Observability** - Logs, traces, metrics, and health checks

---

## 📋 Quick Start: Framework Selection

```markdown
Choose your framework based on project needs:

| Criteria | FastAPI | Django |
|:---------|:--------|:-------|
| **Primary Use** | High-concurrency APIs | Full-featured web apps |
| **Async Support** | Native, first-class | Available (Django 5.x) |
| **ORM** | SQLAlchemy 2.0 | Django ORM |
| **Learning Curve** | Low (Python hints) | Medium (conventions) |
| **Admin Panel** | Manual setup | Built-in |
| **Best For** | Microservices, ML APIs | SaaS, E-commerce |
```

---

## 🔧 Framework-Specific Guides

### FastAPI Development
- Async/await patterns for high-concurrency
- Pydantic V2 for data validation
- SQLAlchemy 2.0 async with asyncpg
- Background tasks and task queues
- **[📖 Full Guide: references/fastapi-patterns.md](references/fastapi-patterns.md)**

### Django Development
- Django 5.x async views and middleware
- ORM optimization (select_related, prefetch_related)
- Django REST Framework (DRF) patterns
- Celery for background tasks
- **[📖 Full Guide: references/django-patterns.md](references/django-patterns.md)**

---

## 🔐 Authentication & Security

### Supported Patterns
| Pattern | FastAPI | Django |
|:--------|:--------|:-------|
| JWT Tokens | python-jose

Frequently Asked Questions

FAQ

Which Python frameworks are supported?
This skill provides comprehensive support for FastAPI (async-first) and Django 5.x (enterprise-grade).
Who is this skill designed for?
It is built for software developers and backend engineers looking to standardize their Python API development workflow.
How does this differ from standard tutorials?
It provides production-ready patterns for observability, security, and deployment that go beyond basic 'Hello World' examples.
Does it support GraphQL as well as REST?
Yes, while focusing on REST patterns, it includes guidance for building GraphQL APIs within the Python ecosystem.
What kind of results can I expect?
You will achieve faster development cycles, standardized codebases, and APIs that are ready for production deployment with full documentation.

Discussion

Discussion

0 comments
U

On This Page

Trigger Phrases

Use these phrases to activate this skill in your AI coding assistant:

Build a FastAPI appSetup Django REST FrameworkGenerate OpenAPI documentationConfigure JWT auth in PythonCreate a Python microservice
Python API Builder for Developers: FastAPI & Django Guide