viz-render

Viz Render Skill

Render markdown documents, Mermaid diagrams, or plan files as formatted HTML with syntax highlighting, math formulas, and Mermaid, in the dark-only Musingfox design system. One skill, one script, three input shapes.

Requires macOS (open, stat -f), python3, curl, lsof, and network access for the CDN that loads Mermaid, KaTeX, and highlighting.

When NOT to Use

• Short non-table content (<20 lines) or simple diagrams (2–8 nodes) — use the viz-inline skill's chat shapes (call tree, pseudocode, diff) instead
• User explicitly wants terminal/text output
• User is asking to edit or modify the content, not view it

Input Shapes → Workflow

Shape A: file path

User gave an absolute/relative path to a markdown file.

bash "${CLAUDE_PLUGIN_ROOT}/lib/render.sh" "{file_path}" "doc-{name}"

Shape B: plan name (bare name, no path separator, no .md)

List available plans or resolve by name against ~/.claude/plans/:

INPUT="$ARGUMENTS"
PLANS_DIR="$HOME/.claude/plans"

if [ -z "$INPUT" ]; then
    echo "Available plans in $PLANS_DIR:"
    ls -t "$PLANS_DIR"/*.md 2>/dev/null | head -20 | xargs -n1 basename | sed 's/\.md$//' | sed 's/^/  - /'
elif [ -f "$INPUT" ]; then
    DOC_FILE="$INPUT"; DOC_NAME=$(basename "$DOC_FILE" .md)
    bash "${CLAUDE_PLUGIN_ROOT}/lib/render.sh" "$DOC_FILE" "doc-$DOC_NAME"
else
    DOC_FILE="$PLANS_DIR/$INPUT.md"
    [ -f "$DOC_FILE" ] && bash "${CLAUDE_PLUGIN_ROOT}/lib/render.sh" "$DOC_FILE" "doc-$INPUT" \
      || { echo "Plan not found: $INPUT.md"; ls -t "$PLANS_DIR"/*.md 2>/dev/null | head -10 | xargs -n1 basename | sed 's/\.md$//' | sed 's/^/  - /'; }
fi

Shape C: inline content or Mermaid code

Write the content (or Mermaid wrapped in a ```mermaid fence) to a temp markdown file, then render.

For inline markdown, write to /tmp/viz-doc-{timestamp}.md.

For bare Mermaid code, wrap as:

# {Diagram Title}

```mermaid
{mermaid code}
```

…write to /tmp/viz-diagram-{name}.md, then: