Can I use this to visualize class inheritance?

Yes, the skill analyzes class definitions to generate Mermaid class diagrams showing inheritance, composition, and method exports.

Where should I store the generated diagrams?

The skill is designed to embed Mermaid syntax directly into Markdown files like README.md or dedicated documentation folders, complete with tracking metadata for freshness checks.

How does the Code Visualizer detect stale diagrams?

It compares the modification timestamps of source Python files against the diagram's internal metadata and Git history to identify when code changes have outpaced the documentation.

Does this skill support languages other than Python?

Currently, the core analysis engine is optimized specifically for Python AST parsing. However, it can delegate general visualization tasks to the visualization-architect agent for broader contexts.

Code Visualizer

Name: Code Visualizer
Author: rysweet

byrysweet

•

Learning & Documentation

Generates and maintains live Mermaid architecture diagrams by analyzing Python module dependencies and detecting documentation staleness.

About

The Code Visualizer skill automates the creation of architectural documentation by performing deep AST analysis on Python codebases to extract import relationships, class hierarchies, and data flows. It solves the common problem of outdated documentation by implementing a staleness detection system that monitors file modification timestamps against diagram metadata. Designed for the amplihack framework, it allows developers to visualize the architectural impact of pull requests, generate instant overviews for new modules, and ensure that README diagrams remain a truthful representation of the underlying source code.

Key Features

Generates Mermaid.js flowcharts, class diagrams, and module relationship graphs
16 GitHub stars
Automated Python AST parsing for accurate import and dependency extraction
Smart staleness detection comparing source timestamps with diagram metadata
Visual PR impact analysis highlighting added, modified, or deleted dependencies
Delegation to specialized agents for complex multi-level architecture mapping

Use Cases

Auto-generating dependency graphs for new modules to accelerate team onboarding
Auditing project documentation to identify and update stale architecture diagrams
Visualizing the structural consequences of a Pull Request before merging

About

Key Features

Generates Mermaid.js flowcharts, class diagrams, and module relationship graphs
16 GitHub stars
Automated Python AST parsing for accurate import and dependency extraction
Smart staleness detection comparing source timestamps with diagram metadata
Visual PR impact analysis highlighting added, modified, or deleted dependencies
Delegation to specialized agents for complex multi-level architecture mapping

Use Cases

Auto-generating dependency graphs for new modules to accelerate team onboarding
Auditing project documentation to identify and update stale architecture diagrams
Visualizing the structural consequences of a Pull Request before merging