obsidian-arch

Generate Obsidian Canvas and sequence diagrams from codebases.

Updated Jan 4, 2026
One-click install
npx skills add https://github.com/tzf1003/ObsidianSkills --skill obsidian-arch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-arch
Source: https://github.com/tzf1003/ObsidianSkills/tree/main
Command: npx skills add https://github.com/tzf1003/ObsidianSkills --skill obsidian-arch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Obsidian-arch provides a bridge between code repositories and Obsidian, enabling AI-assisted generation, visualization, and synchronization of project architectures using Obsidian Canvas and sequence diagrams.

Core Features & Use Cases

  • Generate global architecture canvases from codebases.
  • Create dynamic interaction sequence diagrams and support reverse-sync to code.
  • Maintain Obsidian notes in sync with evolving architectures for architecture-driven development.
  • Use Case: Quickly visualize a monorepo's dependencies and critical data paths as a single canvas.

Quick Start

Point your AI agent at this project and run the /init command to generate the initial architecture canvases.

Frequently Asked Questions about obsidian-arch

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

FAQPage Schema
How do I visualize a monorepo's architecture using Obsidian Canvas?

Obsidian Canvas visualization of a monorepo architecture is generated by pointing your AI agent at the codebase and running the /init command. This produces canvas JSON output compatible with Obsidian standards, mapping dependencies and data paths into a single visual view.

Can I generate sequence diagrams for multi-service interactions in Obsidian?

Sequence diagrams for multi-service interactions can be generated dynamically to visualize critical data paths. This Skill creates dynamic sequence diagrams and supports reverse-syncing the diagram changes back to the code repository.

How do I keep Obsidian notes in sync with evolving codebase architecture?

Obsidian notes are kept in sync with evolving codebase architecture through AI-assisted generation and synchronization. This bridges the code repository and Obsidian, enabling architecture-driven development by updating interaction scenarios and module details as the code changes.

Does this architecture visualization approach work for multi-service projects?

Architecture visualization works effectively for multi-service projects and monorepos. The Skill handles initialization, global architecture mapping, module details, and interaction scenarios specifically designed for complex codebases.

What is the best way to bridge a code repository with Obsidian for architecture discovery?

Bridging a code repository with Obsidian for architecture discovery is best done using MCP-based prompts and frontmatter-driven discovery. This automates the extraction of global architecture and module details, outputting canvas JSON compatible with Obsidian Canvas.

Are there limitations when generating global architecture canvases from large codebases?

Global architecture canvas generation from large codebases relies on AI agent processing, so limitations depend on the agent's context window and reasoning capabilities. The Skill provides the structural prompts for initialization and module details, but the discovery depth is bounded by the agent.