compose-python-stack

A project generator for Python software. It combines documented building blocks or presets, such as frameworks, data tools, interfaces, deployment targets and infrastructure choices, into a new project.

In plain words
What is it for?
Use it to create a Python library, command-line tool, web API or AI application with a compatible technology stack and deployment setup.
Why use it?
It removes the need to decide and assemble every part of a Python project by hand. It also checks the generated project with dependency installation, tests and code-quality commands.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/leynier/python-template/compose-python-stack
Any agent
npx skills add leynier/python-template --skill compose-python-stack
Clone the repo
git clone --depth 1 https://github.com/leynier/python-template

Made for: Claude Code, Codex.

Per session 65 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 425 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00065 $0.00425
Opus 5 $0.00032 $0.00212
Sonnet 5 $0.00013 $0.00085
Haiku 4.5 $0.00006 $0.00042

Measured 2d ago against content hash 13f603346f5d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

compose-python-stack scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/compose-python-stack/SKILL.md · 26 lines

What it actually says

Compose Python Stack

Turn a product goal into a supported stack, explain the consequential choices, and generate it with Copier.

Workflow

  1. Read docs/reference/presets.md and docs/reference/components.md. When exact compatibility matters, also read catalog/generated/catalog.json.
  2. Ask only about choices that change the architecture. Prefer one of the documented presets when it is close; otherwise select custom and compose the layers.
  3. Keep model and embedding providers independent. Select at most one provider for each data role. Do not add AI to a simple library, Typer CLI, or FastAPI/Flask API unless requested.
  4. Select one deployment target. Docker is the portable base for deployed projects; select either no IaC, Pulumi, or Terraform where the chosen target supports it.
  5. Generate into a new directory with copier copy gh:leynier/python-template <destination>, answering interactively. For automation, pass explicit values with repeated -d key=value arguments.
  6. Enter the generated directory and run uv sync --all-groups, uv run pytest, uv run ruff check ., and uv run ruff format --check ..
  7. Report the selected layers, generated entry points, required environment variables, and any cloud resources the user must configure.

Guardrails

  • Treat catalog compatibility rules as authoritative; do not force an invalid combination.
  • Preserve the first-class python-library, typer-cli, and fastapi-api paths.
  • Prefer Python 3.12 or newer and uv for environment and command execution.
  • Never deploy, create paid resources, or write credentials unless the user explicitly authorizes that action.
Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 26 lines · 65 tokens per session scan A 13f603346f5d

Subscribe to this mod's changes

compose-python-stack is a skill published in the GitHub repository leynier/python-template (37 stars, last pushed 4d ago), licensed MIT. It adds 65 tokens to every session and 425 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

heaven-style

Standalone personal code-quality, architecture, documentation, graphical-interface, and project-management guide for TypeScript and Python repositories. Use when writing or reviewing code or docs, designing architecture or UI, refactoring, or aligning tests; apply repository policy first, then shared design philosophy…

Magolor/Blueprint · 63 tokens

datamodel-code-generator

Use this skill when the user wants Python data models, Pydantic models, dataclasses, TypedDicts, msgspec structs, or type-safe Python classes generated from OpenAPI, AsyncAPI, JSON Schema, GraphQL, JSON/YAML/CSV sample data, MCP tool schemas, Protocol Buffers, XML Schema, Apache Avro, or existing Python model objects.…

koxudaxi/datamodel-code-generator · 147 tokens

background-task

Add or modify work that runs outside the request/response cycle — emails, document ingestion, webhooks, cleanups, scheduled jobs. Use when something is slow or fire-and-forget, or when adding a periodic/cron task. This project's queue is {{ cookiecutter.backgroundtasks }}.

vstorm-co/full-stack-ai-agent-template · 62 tokens

frontend-feature

Build a new page, view, or data-driven feature in the Next.js frontend. Use when adding a route under the dashboard/marketing area, wiring UI to a backend endpoint, adding client state, or creating a localized page. Covers App Router, data fetching, Zustand stores, and i18n.

vstorm-co/full-stack-ai-agent-template · 64 tokens

rag-knowledge

Work with the RAG knowledge base — ingest documents, run semantic search, manage collections, or add a sync source/connector (Google Drive, S3). Use when populating or debugging the knowledge base, tuning retrieval, or adding a new document source. This project uses {{ cookiecutter.vectorstore }} + {{…

vstorm-co/full-stack-ai-agent-template · 76 tokens

alembic-migration

Create, review, and apply database schema changes with Alembic. Use whenever a SQLAlchemy model is added or changed, a column/index/constraint needs to change, or a data backfill is required — anything that alters the PostgreSQL schema.

vstorm-co/full-stack-ai-agent-template · 56 tokens