doc-bd-erd

Generate and revise BD-ERD Markdown documents with Mermaid diagrams for Obsidian.

1|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/tsuji-tomonori/diopside-v3 --skill doc-bd-erd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-bd-erd
Source: https://github.com/tsuji-tomonori/diopside-v3/tree/main/.opencode/skills/doc-bd-erd
Command: npx skills add https://github.com/tsuji-tomonori/diopside-v3 --skill doc-bd-erd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires auto_link_glossary.py, validate_vault.py, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the creation and revision of Basic Design (BD) ER Diagrams (ERD) for the diopside project, ensuring adherence to Obsidian operational standards.

Core Features & Use Cases

  • New Document Creation: Generate new BD-ERD-*.md files with all mandatory frontmatter.
  • Document Revision: Update existing ERD documents based on requirement changes or design decisions.
  • Use Case: When a new data entity is identified or a relationship between existing entities changes, use this Skill to update the corresponding BD-ERD-*.md file, ensuring all links and metadata are consistent.

Quick Start

Use the doc-bd-erd skill to create a new BD-ERD document for the 'user_profiles' entity.

Frequently Asked Questions about doc-bd-erd

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

FAQPage Schema
How do I create a Basic Design ERD document in Markdown for Obsidian?

To create a Basic Design ERD document in Markdown, use this skill to generate a new BD-ERD file with mandatory frontmatter, entity-relationship definitions, and Mermaid diagrams adhering to Obsidian operational conventions.

How do I update an existing ER Diagram when database requirements change?

Update an existing ER Diagram by revising the corresponding BD-ERD Markdown file to reflect requirement changes, ensuring entity relationships, Mermaid diagrams, and change history tracking remain consistent.

What is included in an Obsidian BD-ERD document for database design?

An Obsidian BD-ERD document includes mandatory frontmatter, entity-relationship definitions, Mermaid diagrams, change history tracking, and traceability links to requirements and other design documents.

Does this Markdown ERD generator enforce Obsidian vault validation and linking?

Yes, the skill enforces Obsidian vault validation and auto-linking through dependencies like auto_link_glossary.py and validate_vault.py to ensure correct metadata and traceability.

Can I use Mermaid diagrams for entity-relationships in Basic Design documentation?

Yes, you can use Mermaid diagrams for entity-relationships; the skill generates and revises Basic Design ERD documents by embedding Mermaid syntax directly within the Markdown files.

What are the limitations of manually maintaining ERD documents instead of using a dedicated skill?

Manually maintaining ERD documents risks breaking frontmatter consistency, Mermaid syntax, and traceability links, whereas this skill automates validation and change history tracking for the diopside project.