Skills vision-analysis

install

source · Clone the upstream repo

git clone https://github.com/MiniMax-AI/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/MiniMax-AI/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/vision-analysis" ~/.claude/skills/minimax-ai-skills-vision-analysis && rm -rf "$T"

manifest: skills/vision-analysis/SKILL.md

source content

Vision Analysis

Analyze images using the MiniMax

MiniMax_understand_image

MCP tool available in the MiniMax Token Plan.

Prerequisites

MiniMax Token Plan subscription with valid
```
MINIMAX_API_KEY
```
MiniMax MCP configured (
```
MiniMax_understand_image
```
tool available)

If MCP tool is not configured

Step 1: The agent should fetch setup instructions from: https://platform.minimaxi.com/docs/token-plan/mcp-guide

Step 2: Detect the user's environment (OpenCode, Cursor, Claude Code, etc.) and output the exact commands needed. Common examples:

OpenCode — add to

~/.config/opencode/opencode.json

package.json

{
  "mcp": {
    "MiniMax": {
      "type": "local",
      "command": ["uvx", "minimax-coding-plan-mcp", "-y"],
      "environment": {
        "MINIMAX_API_KEY": "YOUR_TOKEN_PLAN_KEY",
        "MINIMAX_API_HOST": "https://api.minimaxi.com"
      },
      "enabled": true
    }
  }
}

Claude Code:

claude mcp add -s user MiniMax --env MINIMAX_API_KEY=your-key --env MINIMAX_API_HOST=https://api.minimaxi.com -- uvx minimax-coding-plan-mcp -y

Cursor — add to MCP settings:

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": ["minimax-coding-plan-mcp"],
      "env": {
        "MINIMAX_API_KEY": "your-key",
        "MINIMAX_API_HOST": "https://api.minimaxi.com"
      }
    }
  }
}

Step 3: After configuration, tell the user to restart their app and verify with

/mcp

Important: If the user does not have a MiniMax Token Plan subscription, inform them that the

understand_image

tool requires one — it cannot be used with free or other tier API keys.

Analysis Modes

Mode	When to use	Prompt strategy
`describe`	General image understanding	Ask for detailed description
`ocr`	Text extraction from screenshots, documents	Ask to extract all text verbatim
`ui-review`	UI mockups, wireframes, design files	Ask for design critique with suggestions
`chart-data`	Charts, graphs, data visualizations	Ask to extract data points and trends
`object-detect`	Identify objects, people, activities	Ask to list and locate all elements

Workflow

Step 1: Auto-detect image

The skill triggers automatically when a message contains an image file path or URL with extensions:

.jpg

.jpeg

.png

.gif

.webp

.bmp

.svg

Extract the image path from the message.

Step 2: Select analysis mode and call MCP tool

Use the

MiniMax_understand_image

tool with a mode-specific prompt:

describe:

Provide a detailed description of this image. Include: main subject, setting/background,
colors/style, any text visible, notable objects, and overall composition.

ocr:

Extract all text visible in this image verbatim. Preserve structure and formatting
(headers, lists, columns). If no text is found, say so.

ui-review:

You are a UI/UX design reviewer. Analyze this interface mockup or design. Provide:
(1) Strengths — what works well, (2) Issues — usability or design problems,
(3) Specific, actionable suggestions for improvement. Be constructive and detailed.

chart-data:

Extract all data from this chart or graph. List: chart title, axis labels, all
data points/series with values if readable, and a brief summary of the trend.

object-detect:

List all distinct objects, people, and activities you can identify. For each,
describe what it is and its approximate location in the image.

Step 3: Present results

Return the analysis clearly. For

describe

, use readable prose. For

ocr

, preserve structure. For

ui-review

, use a structured critique format.

Output Format Example

For describe mode:

## Image Description

[Detailed description of the image contents...]

For ocr mode:

## Extracted Text

[Preserved text structure from the image]

For ui-review mode:

## UI Design Review

### Strengths
- ...

### Issues
- ...

### Suggestions
- ...

Notes

Images up to 20MB supported (JPEG, PNG, GIF, WebP)
Local file paths work if MiniMax MCP is configured with file access

The

MiniMax_understand_image

tool is provided by the

minimax-coding-plan-mcp

package