GuruDevvv/my-claude-skills / external/mermaid-tools
mermaid-tools
VerifiedExtracts Mermaid diagrams from markdown files and generates high-quality PNG images using bundled scripts. Activates when working with Mermaid diagrams, converting diagrams to PNG, extracting diagrams from markdown, or processing markdown files with embedded Mermaid code.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 1.4 KB |
| SKILL.md | skill md | 5.4 KB |
| references/setup_and_troubleshooting.md | markdown | 5.1 KB |
| scripts/extract-and-generate.sh | script | 5.2 KB |
| scripts/extract_diagrams.py | script | 4.9 KB |
| scripts/puppeteer-config.json | config | 356 B |
| КАК_ИСПОЛЬЗОВАТЬ.md | markdown | 512 B |
scripts/extract_diagrams.py
View on GitHub#!/usr/bin/env python3
"""
Extract Mermaid diagrams from markdown file and create numbered .mmd files
"""
import re
import sys
from pathlib import Path
def extract_mermaid_diagrams(markdown_file, output_dir):
"""Extract Mermaid diagrams from markdown file and create numbered .mmd files"""
try:
with open(markdown_file, 'r', encoding='utf-8') as f:
content = f.read()
except Exception as e:
print(f"ERROR: Cannot read markdown file: {e}")
return []
# Find all mermaid code blocks with their content
mermaid_pattern = r'```mermaid\n(.*?)\n```'
matches = re.findall(mermaid_pattern, content, re.DOTALL)
if not matches:
print("No Mermaid diagrams found in markdown file")
return []
# Extract diagram names from context (look backwards for section headers)
diagrams = []
lines = content.split('\n')
for i, match in enumerate(matches, 1):
# Find the position of this diagram in the content
diagram_pattern = f'```mermaid\n{re.escape(match)}\n```'
diagram_match = re.search(diagram_pattern, content)
if not diagram_match:
# Fallback: use simple search
diagram_start = content.find(f'```mermaid\n{match}\n```')
else:
diagram_start = diagram_match.start()
# Count lines up to this point to find context
if diagram_start >= 0:
lines_before = content[:diagram_start].count('\n')
else:
lines_before = 0
# Look backwards for the most recent section header or meaningful context
diagram_name = f"diagram-{i:02d}" # Default fallback
# Look for context clues in the 20 lines before the diagram
context_start = max(0, lines_before - 20)
context_lines = lines[context_start:lines_before] if lines_before > 0 else []
# Priority 1: Look for specific diagram descriptions
for line in reversed(context_lines):
line = line.strip().lower()
if 'system architecture' in line:
diagram_name = f"{i:02d}-system-architecture"
break
elif 'authentication flow' in line:
diagram_name = f"{i:02d}-authentication-flow"
break
elif 'caching architecture' in line or 'multi-layer cache' in line:
diagram_name = f"{i:02d}-caching-architecture"
break
elif 'data flow' in line or 'redshift schema' in line:
diagram_name = f"{i:02d}-data-flow"
break
elif 'api request' in line or 'dashboard metrics endpoints' in line:
diagram_name = f"{i:02d}-api-request-response"
break
elif 'dashboard layout' in line or 'presentation layer' in line:
diagram_name = f"{i:02d}-dashboard-layout"
break
elif 'agency' in line and ('hierarchy' in line or 'filter' in line):
diagram_name = f"{i:02d}-agency-hierarchy"
break
# Priority 2: Look for section headers (## or ###)
if diagram_name.startswith('diagram-'):
for line in reversed(context_lines):
line = line.strip()
if line.startswith('###') or line.startswith('##'):
# Extract meaningful part from header
header = re.sub(r'^#+\s*\*?\*?', '', line)
header = re.sub(r'\*?\*?$', '', header)
header = header.strip()
# Convert to filename-friendly format
name_part = re.sub(r'[^\w\s-]', '', header)
name_part = re.sub(r'\s+', '-', name_part.strip())
name_part = name_part.lower()[:30] # Limit length
if name_part and name_part != 'detailed-design':
diagram_name = f"{i:02d}-{name_part}"
break
diagrams.append({
'number': i,
'name': diagram_name,
'content': match.strip()
})
print(f"Found diagram {i}: {diagram_name}")
# Write .mmd files
output_path = Path(output_dir)
output_path.mkdir(parents=True, exist_ok=True)
created_files = []
for diagram in diagrams:
mmd_file = output_path / f"{diagram['name']}.mmd"
try:
with open(mmd_file, 'w', encoding='utf-8') as f:
f.write(diagram['content'])
created_files.append(str(mmd_file))
print(f"Created: {mmd_file}")
except Exception as e:
print(f"ERROR: Cannot create {mmd_file}: {e}")
return created_files
if __name__ == "__main__":
if len(sys.argv) != 3:
print("Usage: python3 extract_diagrams.py <markdown_file> <output_directory>")
sys.exit(1)
markdown_file = sys.argv[1]
output_dir = sys.argv[2]
files = extract_mermaid_diagrams(markdown_file, output_dir)
print(f"\nExtracted {len(files)} diagrams successfully")Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |