machina-python

Enforces strict type hints, modern Python syntax, and static analysis with mypy and Ruff.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/NumberOne-AI/machina-meta --skill machina-python
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: machina-python
Source: https://github.com/NumberOne-AI/machina-meta/tree/main/.claude/skills/machina-python
Command: npx skills add https://github.com/NumberOne-AI/machina-meta --skill machina-python

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The machina-python skill codifies and enforces the highest coding standards across the MachinaMeta workspace, eliminating ambiguity and drift by ensuring strict type hints, modern Python syntax, and security-conscious patterns.

Core Features & Use Cases

  • Strict typing enforcement: requires complete type hints on all public APIs and returns concrete types, with abstract input types where appropriate.
  • Modern Python compliance: promotes Python 3.10+ syntax (| unions, built-in generics) and removes deprecated typing constructs.
  • Static analysis integration: integrates with mypy and Ruff to catch issues early during development, enabling continuous quality checks.
  • Security-first workflow: enforces environment-based secrets, input validation, and avoidance of hard-coded credentials in code.
  • Use Case: A team refactors a legacy module; the skill ensures all functions are annotated, keyword-only, and asynchronously safe, with automated checks.

Quick Start

Run the Hyper-perfect Python standards against new modules using the in-repo tooling (e.g., Just commands or CI) to validate type hints, syntax, and security policies.

Frequently Asked Questions about machina-python

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

FAQPage Schema
How do I enforce strict type hints and modern Python syntax across a project?

You can enforce strict type hints and modern Python syntax by applying a skill that integrates mypy and Ruff static analysis, requiring complete type annotations on public APIs and promoting Python 3.10+ syntax like union operators and built-in generics.

What's the best way to automate security-conscious Python coding standards?

Automate security-conscious Python coding standards by enforcing environment-based secrets management, strict input validation, and avoidance of hard-coded credentials through integrated static analysis checks during development and continuous integration.

Does mypy work with Ruff to catch Python type and syntax issues early?

Yes, mypy works with Ruff to catch Python type and syntax issues early by integrating continuous static analysis checks that validate type hints, modern syntax compliance, and security policies across all source files.

When do I need keyword-only argument enforcement in Python functions?

You need keyword-only argument enforcement when refactoring legacy modules or building public APIs to eliminate ambiguity, ensure strict typing compliance, and maintain asynchronously safe function signatures across the workspace.

Can I use static analysis to validate deprecated typing constructs during a refactor?

Yes, you can use integrated static analysis to validate and remove deprecated typing constructs during a refactor by enforcing Python 3.10+ compliance rules that flag outdated syntax and require modern alternatives like union operators.

Why does my Python project drift from strict coding standards over time?

Python projects drift from strict coding standards due to ambiguity in typing and syntax practices, which is resolved by codifying rigorous type hints, modern syntax rules, and security-first patterns into automated continuous quality checks.