python-standards

Defines Amplifier Python coding standards including typing, async execution, error handling, formatting, dependency management, and testing.

10|11|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/microsoft/amplifier-bundle-skills --skill python-standards-microsoft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-standards
Source: https://github.com/microsoft/amplifier-bundle-skills/tree/main/modules/tool-skills/tests/fixtures/skills/python-standards
Command: npx skills add https://github.com/microsoft/amplifier-bundle-skills --skill python-standards-microsoft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill gives developers a clear Python style guide for Amplifier work, reducing inconsistent code, async mistakes, weak error handling, and formatting drift across modules.

Core Features & Use Cases

  • Type Safety: Enforces complete type hints for functions, classes, and self to improve readability and static analysis.
  • Async and I/O Patterns: Encourages async execution for I/O and parallel work with asyncio.gather to keep tools responsive.
  • Reliability and Quality: Promotes returning structured errors, using uv and ruff, and testing at the protocol level for maintainable Amplifier modules.
  • Use Case: A developer building a new Amplifier tool can use this Skill to align implementation, testing, and formatting with the repository’s accepted conventions.

Quick Start

Use the python-standards skill to review my Python module and tell me how to make it compliant with Amplifier coding standards.

Frequently Asked Questions about python-standards

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

FAQPage Schema
What are the Python coding standards for Amplifier modules?

Python coding standards for Amplifier modules require complete type hints for functions and classes, async execution using asyncio.gather for I/O operations, structured ToolResult-based error reporting, and dependency management with uv.

How do I make my Python code compliant with Amplifier type safety and async patterns?

To make Python code compliant, enforce complete type hints for functions and classes, use asyncio.gather for async I/O parallel work, and return structured ToolResult-based errors to keep tools responsive and maintainable.

Does Amplifier development require using uv and ruff for Python dependency and formatting management?

Yes, Amplifier development requires using uv for dependency management and ruff for formatting to prevent formatting drift, enforce code quality, and align modules with accepted repository conventions.

What is the best way to handle error reporting in Amplifier Python tools?

The best way to handle error reporting in Amplifier Python tools is returning structured ToolResult-based errors, which promotes reliability and maintainability while enabling protocol-level testing.

When should I use async execution in Python modules for Amplifier projects?

You should use async execution in Python modules for Amplifier projects when performing I/O operations or parallel work, utilizing asyncio.gather to keep tools responsive and avoid blocking.

Can I test Amplifier Python modules at the protocol level instead of unit testing?

Yes, Amplifier Python modules support testing at the protocol level to ensure maintainability and reliability, aligning implementation and testing with accepted repository conventions.