python-action-guide

Guide Python custom action development for MaaNTE game automation workflows.

2.6k|191|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/1bananachicken/MaaNTE --skill python-action-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-action-guide
Source: https://github.com/1bananachicken/MaaNTE/tree/main/.claude/skills/python-action-guide
Command: npx skills add https://github.com/1bananachicken/MaaNTE --skill python-action-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the guesswork and common errors developers face when writing Python CustomActions for MaaNTE, ensuring code integrates correctly with MaaFramework and follows project coding standards.

Core Features & Use Cases

  • Full Development Lifecycle Coverage: Provides guidance on architecture design, action registration, naming conventions, Controller API usage, Pipeline integration, error handling, and logging for MaaNTE Python custom actions.
  • Pre-built Component References: Documents built-in common actions (click_override, alt_click) and shared utility functions to reduce redundant code development.
  • Use Case: Use this skill when implementing complex game automation logic like image-based state detection, audio triggers, or rhythm game mechanics that cannot be handled by standard Pipeline JSON configurations.

Quick Start

Consult this guide when writing or modifying Python custom actions for MaaNTE to ensure proper registration, correct MaaFramework API usage, and alignment with project coding standards.

Frequently Asked Questions about python-action-guide

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

FAQPage Schema
How do I create custom Python actions for MaaFramework game automation?

To create custom Python actions for MaaFramework, you must register the action, use the Controller API, and integrate it with the Pipeline. This ensures proper state management and reliable game logic execution.

When should I use Python custom actions instead of Pipeline JSON for game automation?

Use Python custom actions when implementing complex game automation logic like image-based state detection, audio triggers, or rhythm game mechanics that standard Pipeline JSON configurations cannot handle.

What are the naming and coordinate standards for MaaFramework custom actions?

MaaFramework custom actions must adhere to project naming conventions and use a 720p coordinate system standard. Following these guidelines ensures reliable integration with the MaaNTE Pipeline system.

How do I handle errors and logging in MaaFramework Python custom actions?

Error handling and logging in MaaFramework Python custom actions require following best practices throughout the development lifecycle. This approach ensures robust execution and easier debugging for complex game logic.

Does MaaFramework provide built-in actions to reduce redundant Python code?

MaaFramework includes pre-built common actions like click_override and alt_click, along with shared utility functions. These components help reduce redundant code development when building custom game automation.