evaluate-diagram

Score AI-generated diagrams against human references using a VLM-as-Judge mechanism.

1|1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/dtsong/claude-code-windows-setup --skill evaluate-diagram
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: evaluate-diagram
Source: https://github.com/dtsong/claude-code-windows-setup/tree/main/skills/evaluate-diagram
Command: npx skills add https://github.com/dtsong/claude-code-windows-setup --skill evaluate-diagram

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides an objective way to score and compare AI-generated diagrams against human-created references, ensuring accuracy and quality.

Core Features & Use Cases

  • Diagram Evaluation: Uses a VLM-as-Judge approach for scoring.
  • Quality Assessment: Compares generated diagrams against a reference image based on faithfulness, conciseness, readability, and aesthetics.
  • Use Case: After an AI generates a system architecture diagram, use this Skill to evaluate how well it matches a hand-drawn diagram provided by a senior engineer.

Quick Start

Use the evaluate-diagram skill to score the diagram 'output.png' against 'reference.png'.

Frequently Asked Questions about evaluate-diagram

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

FAQPage Schema
How do I evaluate AI-generated diagrams against human references?

You can evaluate AI-generated diagrams against human references using a VLM-as-Judge scoring mechanism that compares the generated image to a reference image based on faithfulness, conciseness, readability, and aesthetics.

Can I score diagram quality without a reference image?

No, scoring diagram quality requires both a generated diagram and a human-created reference image to perform the comparison and calculate scores across faithfulness, conciseness, readability, and aesthetics.

Do I need a specific tool to perform VLM diagram quality assessments?

Yes, diagram quality assessments require the paperbanana MCP tool or a local paperbanana CLI installation to execute the image analysis and scoring processes.

What is the best way to compare a generated system architecture diagram with a hand-drawn one?

The best way to compare a generated system architecture diagram with a hand-drawn one is to use a VLM-as-Judge approach that scores faithfulness, conciseness, readability, and aesthetics against the provided reference image.

What dimensions are scored when comparing generated diagrams to references?

When comparing generated diagrams to references, the evaluation scores four dimensions: faithfulness, conciseness, readability, and aesthetics to ensure accuracy and quality.

Why should I use an automated approach for diagram evaluation instead of manual review?

Automated diagram evaluation provides an objective way to score and compare AI-generated diagrams against human-created references, ensuring consistent accuracy and quality across faithfulness, conciseness, readability, and aesthetics.