# Visual Reasoning

> Uses visual diagrams (Mermaid, ASCII, UI mockups) to model spatial, architectural, and flow relationships.

- Skill: `felipecustodio/visual-reasoning` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add felipecustodio/visual-reasoning`
- Raw SKILL.md: https://api.skillmd.com/api/skills/felipecustodio/visual-reasoning/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: felipecustodio (https://skillmd.com/u/felipecustodio)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/felipecustodio/visual-reasoning

---


## Overview & Purpose

Visual Reasoning uses structured visual diagrams (Mermaid flowcharts, sequence diagrams, architecture blueprints) to model spatial relationships, execution flows, and system components visually.

## When to Use

- **Architecture Documentation**: Drawing flowcharts, sequence diagrams, or component diagrams.
- **Workflow Visualization**: Clarifying complex state machines or process branches.

## Execution Workflow

1. **Select Diagram Type**: Choose Mermaid diagram style (flowchart, sequenceDiagram, classDiagram, graph TD).
2. **Model Nodes & Relationships**: Map entities to nodes and connections to labeled arrows.
3. **Render Diagram Block**: Output syntactically valid Mermaid code blocks.

## Expected Output Contract

```mermaid
graph TD
    A[Input State] --> B{Decision Node}
    B -- Choice 1 --> C[Outcome 1]
    B -- Choice 2 --> D[Outcome 2]
```

## Scripts

- `scripts/visual_reasoning.py` - Deterministic evaluation, state validation, and CLI tool for visual-reasoning.