Architecture Scanner

by oh-my-mermaid

Architecture Scanner is a Writing skill for Claude Code, published by oh-my-mermaid in oh-my-mermaid.

2.2K stars187 forkson oh-my-mermaid/oh-my-mermaidAdded 2026/08/18Repository updated 2026/04/07

View source on GitHub Download repo ZIP

aiarchitectureclaude-codeclaude-code-skillclicodebase-visualizationdeveloper-toolsdiagramsdocumentationmermaid

Install in seconds

Install Architecture Scanner

Copy Architecture Scanner into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/oh-my-mermaid/oh-my-mermaid/tree/main/skills/omm-scan ~/.claude/skills/omm-scan

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/oh-my-mermaid/oh-my-mermaid.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/omm-scan/SKILL.md in oh-my-mermaid/oh-my-mermaid
Installs to: ~/.claude/skills/omm-scan
Collection: One of 3 skills cataloged from this repository
Category: Writing — 1012 skills

What Architecture Scanner does

Architecture Scanner scans codebase architecture and generates or updates .omm documentation using perspective-driven recursive analysis, creating Mermaid diagrams and fields. Use when the user says 'omm scan', 'scan architecture', or wants to refresh architecture diagrams.

Architecture Scanner is cataloged under Writing on DirSkills. Architecture Scanner comes from a repository tagged ai, architecture, claude-code, claude-code-skill and cli.

Documentation

README

Excerpt

omm-scan — Perspective-Based Architecture Scanner

Purpose

Analyze the codebase and generate .omm/ architecture documentation using perspective-driven recursive analysis.

A perspective is a top-level element — a distinct way to look at the architecture.
Each element in a diagram gets analyzed recursively. If it has internal structure, it becomes a child element (subdirectory with its own diagram). If not, it stays a leaf.
The filesystem determines nesting. Element IDs in diagrams match child directory names. The viewer resolves groups from the filesystem.

Prerequisites

command -v omm || npm install -g oh-my-mermaid

If the install fails, tell the user: "Please run npm install -g oh-my-mermaid in your terminal, then try again."

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Architecture Scanner

What else does oh-my-mermaid publish alongside Architecture Scanner?
Architecture Scanner is one of 3 skills that DirSkills catalogs from oh-my-mermaid/oh-my-mermaid, the repository it ships in. Its siblings there include Omm Push and Omm View. Each one is a separate skill with its own page in this directory, installs the same way Architecture Scanner does, and is maintained by oh-my-mermaid in that same repository. The rest of the collection is listed on the oh-my-mermaid/oh-my-mermaid page.
How does Architecture Scanner compare to other Writing skills?
Architecture Scanner ranks #270 by stars among the 1012 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Architecture Scanner against them. Open each page to compare what they document and how they install.