minimax-understand-image_skill

Overview

This skill uses the MiniMax MCP server to perform image understanding and analysis. It provides a lightweight command-line workflow to call the understand_image tool and receive structured JSON descriptions. The skill automates dependency checks, API key handling, and the call to the MCP service for fast image inspection.

How this skill works

The skill checks for the uvx runtime and installs the minimax-coding-plan-mcp package if missing. It validates or prompts for a MiniMax API key stored in ~/.openclaw/config/minimax.json. Finally, it invokes a Python helper script that sends a JSON-RPC request to the MCP server's understand_image tool and returns formatted JSON results.

When to use it

• You need a detailed description of a photo, scene, or object in an image.
• You must extract visible text, identify objects, or summarize visual context.
• You want to automate image analysis via CLI or scriptable pipelines.
• You prefer using a local MCP runtime with a configured MiniMax API key.

Best practices

• Ensure uvx is installed before running the skill; follow the provided install commands if missing.
• Store a valid MiniMax API key in ~/.openclaw/config/minimax.json using the exact JSON structure.
• Provide clear, focused prompts when calling understand_image to get targeted answers.
• Use accessible file paths or public URLs for images so the MCP server can fetch them.
• Check MCP server stderr output for troubleshooting if the call fails.

Example use cases

• Describe the contents of a product photo to generate alt text for accessibility.
• Detect and transcribe visible text in a screenshot or document image.
• Identify objects and scene context in surveillance or field photos.
• Integrate into a preprocessing pipeline that tags images with semantic labels.
• Quickly validate that an image contains expected elements before downstream processing.