AI Skills
This repository contains skills and a superpower used by AI agents when working on this codebase.
All documents are written in English. They describe technology choices, project structure, architecture, and coding conventions.
Index
| File | Type | Description |
|---|---|---|
skills/python-development/SKILL.md |
Superpower | High-level philosophy, when to apply, and skill routing map |
skills/python-development-stack/SKILL.md |
Skill | Technology stack: Python, FastAPI, SQLModel, facet, typer, loguru, uv |
skills/python-development-layout/SKILL.md |
Skill | File and folder organization, service and adapter package layout |
skills/python-development-architecture/SKILL.md |
Skill | Ports and Adapters, Monolith-over-Microservices, facet hierarchy |
skills/python-development-code-style/SKILL.md |
Skill | Imports, __init__.py, wildcard bans, block grouping |
skills/python-development-settings/SKILL.md |
Skill | Pydantic Settings, BaseModel, YAML/JSON loading, validators |
skills/python-development-cli/SKILL.md |
Skill | Typer composition, callback boot, deferred imports, nesting |
Usage
When an agent starts working on a task, it should load the superpower first. The superpower contains a decision tree that points to the relevant granular skills.
Customizing
Edit the files in skills/ to match your actual preferences, frameworks, and team conventions.