python-standards

python-standards is a skill for Claude Code, Codex from systemowiec/ai-agents-workspace-starter. It costs 38 tokens per session (2,183 once invoked), scanned A, original, MIT.

A set of advanced standards for writing maintainable Python code in large projects. It covers interfaces, immutable data objects, error handling, dependency injection, and class design.

In plain words
What is it for?
Use it whenever you implement Python code, especially domain models, services, data-transfer objects, interfaces, and business error handling.
Why use it?
It makes code easier to test, change, and maintain as the codebase and team grow, while reducing unnecessary coupling between parts of the system.

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/systemowiec/ai-agents-workspace-starter/python-standards
Any agent
npx skills add systemowiec/ai-agents-workspace-starter --skill python-standards
Clone the repo
git clone --depth 1 https://github.com/systemowiec/ai-agents-workspace-starter

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for python-standards

README.md
[![agentmods](https://agentmods.dev/badge/skills/systemowiec/ai-agents-workspace-starter/python-standards.svg)](https://agentmods.dev/skills/systemowiec/ai-agents-workspace-starter/python-standards)
Your own site
<a href="https://agentmods.dev/skills/systemowiec/ai-agents-workspace-starter/python-standards"><img src="https://agentmods.dev/badge/skills/systemowiec/ai-agents-workspace-starter/python-standards.svg" alt="Measured on agentmods" height="20"></a>
Per session 38 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,183 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.00038 $0.02183
Opus 5 $0.00019 $0.01092
Sonnet 5 $0.00008 $0.00437
Haiku 4.5 $0.00004 $0.00218

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

Security

Grade A, and why

python-standards 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 4d 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.

.agents/skills/python-standards/SKILL.md · 125 lines

How it starts

The opening of the file, as written. The whole thing — 125 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Skill: Enterprise Python Standards

Principal/Staff-level Python patterns. NOT junior/mid rules. These standards produce code that scales, is testable, and is maintainable by large teams. Apply to ALL Python code in this project.


A. Architecture & Design

  1. Protocols over ABC - Use typing.Protocol for interfaces, not abc.ABC. Protocols enable structural subtyping (duck typing with type safety) without inheritance coupling.
  2. Frozen dataclasses for value objects - Immutable by default: @dataclass(frozen=True, slots=True). Mutable state only where explicitly needed.
  3. Result pattern for expected failures - Return Result[T, E] (or T | ErrorType) instead of raising exceptions for business-level failures. Exceptions only for truly exceptional (unexpected) situations.
  4. __slots__ on hot-path classes - Reduces memory footprint and attribute access time. Always on dataclasses (slots=True), domain models, and DTO/schema objects.
  5. Composition over inheritance - Favor dependency injection and delegation. Inheritance allowed only for framework requirements (e.g., AgentExecutor).
  6. Single Responsibility - One class = one reason to change. Max 500 lines/class, 50 lines/function. If a method needs a comment explaining "what it does", it should be a separate function.

B. Type System

  1. Exhaustive type hints - Every function: params + return type. No Any unless interfacing with untyped libraries (and wrap it immediately).
  2. TypeVar with bounds - T = TypeVar("T", bound=BaseModel) for generic functions operating on model subtypes.
  3. ParamSpec for decorator preservation - Decorators must preserve wrapped function's signature: P = ParamSpec("P"), Callable[P, R].
  4. TypeGuard for narrowing - Use TypeGuard[SpecificType] in filter/validation functions to enable type narrowing in callers.
  5. Final for constants - All module-level constants annotated with Final. Prevents accidental reassignment.
  6. Annotated for validation metadata - Annotated[int, Field(ge=0)] instead of runtime-only checks. Self-documenting constraints.
  7. TYPE_CHECKING for circular imports - Import type-only dependencies inside if TYPE_CHECKING: block. Never restructure code just to avoid forward references.

Read the full file on GitHub · 125 lines

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. 4d ago First seen · 125 lines · 38 tokens per session scan A a51ee21376fb

Subscribe to this mod's changes

python-standards is a skill published in the GitHub repository systemowiec/ai-agents-workspace-starter (2 stars, last pushed 5mo ago), licensed MIT. It adds 38 tokens to every session and 2,183 once invoked, about $0.0002 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-31.

Related

Other skills, from other repositories

bump-dependency

Bumps a Python package dependency across Home Assistant Core integrations, regenerates core requirement files, runs verification tests and prek lint, and prepares a pull request with proper release/compare links.

home-assistant/core · 42 tokens

mem0-vercel-ai-sdk

Mem0 provider for Vercel AI SDK (@mem0/vercel-ai-provider). TRIGGER when: user mentions "vercel ai sdk", "@mem0/vercel-ai-provider", "createMem0", "retrieveMemories", "addMemories", "getMemories", "searchMemories", "mem0 vercel", "AI SDK provider", "AI SDK memory", or is using generateText/streamText with mem0. Also…

mem0ai/mem0 · 146 tokens

schema-exploration

Lists tables, describes columns and data types, identifies foreign key relationships, and maps entity relationships in a database. Use when the user asks about database schema, table structure, column types, what tables exist, ERD, foreign keys, or how entities relate.

langchain-ai/deepagents · 57 tokens

pause

Pause Mem0 memory capture on this machine. Use when the user wants to stop memories being recorded, for example for private work or experiments.

mem0ai/mem0 · 30 tokens

mem0-oss-to-platform

Plan and then execute a migration of a project from the mem0 open-source / self-hosted SDK (the local Memory class) to the mem0 Platform / hosted / managed SDK (the MemoryClient class). Use this whenever a developer wants to move, switch, or migrate their mem0 usage off OSS/self-hosted to the hosted API — e.g.…

mem0ai/mem0 · 273 tokens

complete-partial-pr

Evaluate and complete an issue or PR where the submitted patch fixes only a narrow symptom of the reported pain point. Use when a contribution may miss adjacent integration surfaces, provider/spec semantics, roundtrip behavior, tests, docs, or historical maintainer decisions.

pydantic/pydantic-ai · 55 tokens