Index of every page on this site: llms.txt
All skills
comet-ml avatar

/diagram-generation

@9b3d88e
by Cometcomet-ml/opik23k stars
1,964
Run it yourself

Generate self-contained HTML architecture diagrams. Use when creating visual diagrams for PRs, task plans, or architectural explanations.

Use this Skill: https://skilld.dev/gh/comet-ml/opik/diagram-generation

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

style-guide.md

≈948 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Diagram Style Guide

Theme

  • Background: #0d1117 (GitHub dark)
  • Text: #c9d1d9 (primary), #8b949e (subtitle), #6e7681 (notes)
  • Font: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif
  • Code font: 'JetBrains Mono', 'Fira Code', monospace
  • Container: max-width: 960px; margin: 0 auto; padding: 40px

Semantic Colors

Role Color Use for
Blue (API/info) #58a6ff Titles, API endpoints, request flow, highlights
Green (new/good) #3fb950 New files, success states, solutions, converters
Red (error/bad) #f85149 Errors, problems, breaking changes, deadlocks
Purple (special) #bc8cff SQL, mappers, enums, special logic
Yellow (highlight) #fbbf24 Key fields, important values
Orange (modified) #d29922 Modified files, DAO changes

Section Labels

<div class="section-label blue"><span class="dot"></span> SECTION TITLE</div>
  • Font: 11px, 700 weight, 1.5px letter-spacing, uppercase
  • Colored dot (8px circle) before text
  • Colors: .blue, .red, .green, .purple

Flow Rows

<div class="flow">
  <div class="box client">Source</div>
  <div class="arrow green">→</div>
  <div class="box layer"><b>Component</b><br>detail</div>
</div>
  • display: flex; align-items: center
  • Boxes: padding: 9px 14px; border-radius: 8px; font-size: 12px
  • Use → entity or SVG arrows between boxes

Box Themes

Class Background Border Text Use
.client #1a1f2e #2d3548 #93c5fd Client/request origin
.layer #161b22 #21262d #c9d1d9 Generic layer/component
.converter #122117 #1e5631 #86efac Converters, new logic
.bad #2d1111 #f85149 2px #fca5a5 Error states, problems
.good #0d2818 #3fb950 2px #86efac Success states, solutions
.sql #1b1728 #3b2d5e #c4b5fd SQL/database queries

Architecture Trees

  • Vertical lines: width: 1px; height: 14px; background: #30363d
  • Horizontal branches: height: 1px; background: #30363d
  • Base class: dashed border (1px dashed #475569)
  • Implementations: solid border, colored by type
  • NEW badge: background: #3fb950; color: #0d1117; font-size: 9px; border-radius: 4px

Problem / Solution Banners

<div class="banner problem">
  <h2>Problem</h2>
  <p>Description...</p>
</div>
<div class="banner solution">
  <h2>Solution</h2>
  <p>Description...</p>
</div>
  • Problem: background: linear-gradient(135deg, #2d1215, #1c1012); border: 1px solid #f8514966
  • Solution: background: linear-gradient(135deg, #0c2d1a, #0d1117); border: 1px solid #3fb95066

Files Changed Grid

<div style="display: grid; grid-template-columns: 1fr 1fr; gap: 8px; max-width: 700px;">
  <div class="box layer" style="font-size: 11px;"><b>FileName</b> — change summary</div>
  <div class="box converter" style="font-size: 11px;"><b>NewFile</b> — new</div>
</div>
  • 2-column grid for files
  • Use .layer for modified, .converter for new files

Dividers

<hr class="divider">

border: none; border-top: 1px solid #21262d; margin: 24px 0

Notes

<div class="note">Explanation with <span class="code">inline code</span></div>

color: #6e7681; font-size: 11px

Tags

<span class="tag new">new</span>
<span class="tag modified">modified</span>
  • New: background: #0d419d; color: #79c0ff
  • Modified: background: #3d2e00; color: #d29922

Safety Guards / Numbered Lists

<div class="guard">
  <div class="guard-icon">1</div>
  Guard description
</div>
  • Icon: 20px circle, numbered
  • Green: background: #064e3b; color: #6ee7b7

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning1mo4 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    This skill generates self-contained HTML architecture diagrams using a predefined template and style guide. It includes a utility to copy diagrams as images using a reputable library from a well-known CDN with security integrity checks. No malicious patterns were detected.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: MEDIUM · 1 issue

  • Runlayer8mo

    3 files scanned · No issues

Signed by skilld at 9b3d88e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 7 months ago

README badge

README badge for comet-ml/opik/diagram-generation