Home

Python AI Coding Standards & Skills

Welcome to the python-skills wiki — your guide to using AI coding standards for production Python projects.

What Is This Repo?

A shared set of skill files that AI coding assistants read before writing your code. It ensures consistent, production-quality Python output regardless of which AI tool you use.

Supported AI Tools

Tool	Config File	Status
Claude Code	CLAUDE.md	✅ Supported
Cursor	.cursorrules	✅ Supported
GitHub Copilot	.github/copilot-instructions.md	✅ Supported
Kiro	.kiro/steering/*.md	✅ Supported
Windsurf	.windsurfrules	✅ Supported
Gemini CLI	GEMINI.md	✅ Supported
OpenAI Codex	AGENTS.md	✅ Supported
Google Antigravity	.agents/skills/	✅ Supported

Quick Links

• FAQ — Common questions answered
• Tool Comparison — Cursor vs Claude Code vs Copilot vs others
• Framework Comparison — FastAPI vs Django vs Flask

Skills Overview

Common Skills (loaded for all projects)

Skill	Description
Code Style	Formatting, naming, imports, type annotations
Testing	pytest patterns, fixtures, coverage
Security	Auth, input validation, secrets management
API Auth	OAuth2, JWT, RBAC/ABAC
DB Design	Models, relationships, queries
Error Handling	Domain exceptions, HTTP mapping
Logging	structlog, structured output
Performance	Async, caching, N+1 prevention
Deployment	Docker, health checks, 12-factor
Observability	Metrics, tracing, OpenTelemetry
CI/CD	GitHub Actions, pipelines
Async Patterns	Task queues, retries, events
Microservices	Service boundaries, communication
Feature Flags	Gradual rollouts, lifecycle
LLM Patterns	AI/LLM client abstraction

Framework Skills

Framework	File	Use Case
FastAPI	skills/fastapi/SKILL.md	Async APIs, microservices
Django	skills/django/SKILL.md	Full-stack web apps
DRF	skills/drf/SKILL.md	Django REST APIs
Flask	skills/flask/SKILL.md	Lightweight APIs, internal tools

Getting Started

# Copy into your project
cp -r skills ./skills
cp CLAUDE.md ./CLAUDE.md        # For Claude Code
cp AGENTS.md ./AGENTS.md        # For Codex/Kiro
cp .cursorrules ./.cursorrules  # For Cursor

Then open your project in any supported AI tool — it works immediately.