AgentSkillsCN

visual-analysis

捕捉并分析TUI截图,用于UX评审、冻结帧检测与视觉验证,同时支持生成提示词与开展结构化分析。

SKILL.md
--- frontmatter
name: visual-analysis
description: Capture and analyze TUI screenshots for UX review, freeze detection, and visual verification, including prompt generation and structured analysis types.

Visual Analysis

Capture TUI screenshots and generate analysis prompts.

Quick Start

bash
source venv/bin/activate
CAPTURE_TUI="PYTHONPATH=.codex/skills/visual-analysis python -m tui_screenshot_capture"

# Capture with analysis
$CAPTURE_TUI capture <screen> --analyze --id <session-id> --charts-path ../web-helm-repository

Use view_image for rendered PNG inspection when needed.

Mandatory options:

  • --charts-path ../web-helm-repository
  • --id <session-id>

Analysis Types

TypePurpose
quickFast render check (5s)
standardNormal check with expected elements (10s)
dataData loading verification (10s)
freezeDetect stuck/frozen states (30,60,90s)
layoutComponent sizing and proportions (10s)
fullComprehensive UX audit (default, 10s)

Key Options

bash
$CAPTURE_TUI capture <screen> [OPTIONS]
$CAPTURE_TUI capture --all [OPTIONS]
$CAPTURE_TUI generate-prompt <screen> --type <type>
OptionDescription
--allCapture all screens
--delaysComma-separated delays in seconds (default: 5)
--analyzeGenerate analysis prompts
--analysis-typeAnalysis type (default: full)
--outputOutput directory (default: /tmp/screenshots)
--idSession identifier (for grouping artifacts)
--charts-pathPath to helm charts (required)

Freeze Detection

bash
$CAPTURE_TUI capture <screen> --delays 30,60,90 --analyze --analysis-type freeze --id <session-id> --charts-path ../web-helm-repository

Cleanup when done:

bash
rm -rf /tmp/screenshots/