core-conventions

Validates Python 3.11+ code in TTA.dev repositories for compliance with coding standards and best practices.

Updated Apr 14, 2025
One-click install
npx skills add https://github.com/theinterneti/TTA.dev --skill core-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: core-conventions
Source: https://github.com/theinterneti/TTA.dev/tree/main/.claude/skills/core-conventions
Command: npx skills add https://github.com/theinterneti/TTA.dev --skill core-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures code consistency across the TTA.dev repository by enforcing Python coding standards and best practices.

Core Features & Use Cases

  • Package Manager Guidance: Standardizes dependency management using uv instead of pip or poetry.
  • Python Version & Types: Enforces Python 3.11+ usage and specific type hinting conventions.
  • Primitives Usage: Recommends using RetryPrimitive, TimeoutPrimitive, and CachePrimitive instead of manual loops.
  • Anti-Patterns: Identifies common anti-patterns and suggests alternatives for better code quality.

Quick Start

Run the core-conventions skill to validate your Python code in TTA.dev against the defined conventions.

Frequently Asked Questions about core-conventions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce Python coding standards and best practices in my repository?

To enforce Python coding standards, you validate code against specific conventions focusing on package management, type hinting, primitive usage, and anti-patterns. This ensures code consistency by identifying issues and suggesting better alternatives.

What is the best way to manage Python dependencies consistently across a project?

The best way to manage Python dependencies consistently is to standardize on a specific package manager like uv instead of pip or poetry. This prevents version conflicts and aligns dependency management with repository best practices.

Do I need Python 3.11 to use specific type hinting conventions and primitives?

Yes, you need Python 3.11 or later to use specific type hinting conventions and primitives. This version requirement ensures compatibility with modern Python features required by the coding standards.

How do I replace manual loops with primitives to avoid Python anti-patterns?

To replace manual loops and avoid Python anti-patterns, use RetryPrimitive, TimeoutPrimitive, and CachePrimitive. These primitives standardize retry, timeout, and caching logic, improving overall code quality.

Why should I use uv instead of pip or poetry for Python package management?

You should use uv instead of pip or poetry for Python package management to ensure code consistency across the repository. Standardizing on uv aligns with specific coding conventions and avoids dependency management anti-patterns.

What Python code anti-patterns should I look for during a code review?

During a Python code review, look for anti-patterns like manual retry loops, missing type hints, and using pip or poetry for dependency management. Identifying these issues ensures adherence to recommended coding standards.