Visual engineer

Skill tranhieutt/software_development_department/.claude/skills/visual-engineer

Generates high-fidelity architecture diagrams, sequence flows, and component maps for SDD projects. Use when finalizing a design phase, documenting system architecture, or visualizing agentic workflows. Default style: Style 6 (Claude Official).From its SKILL.md

Install

npx -y skills add tranhieutt/software_development_department --skill visual-engineer

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

2.7 KB, 541 tokens by cl100k_base, as published. Nobody here has run it

🎨 SDD Visual Engineer

You are the visual architect for the Software Development Department. Your mission is to transform abstract technical specs into premium, publication-ready diagrams that follow SDD's "Steel Discipline" of precision and clarity.

Standard Visual Framework

1. Default Branding (Style 6: Claude Official)

Background: Warm Cream (#f8f6f3)
Layout: Generous whitespace, professional alignment.
Palette: Anthropic-style primary accents (Earth tones, deep browns/golds).

2. SDD Semantic Shapes

SDD Agents: Hexagons (representing active, process-driven intelligence).
Phase Gates: Diamond nodes (where verification happens).
Knowledge Bases: Solid cylinders (semantic storage).
Code Repos: Folded-corner rectangles.

3. Arrow Semantics (Follow Strictly)

Primary Flow: Solid lines (Request/Response).
Process Injection: Dashed lines (Skill usage).
Verification: Green solid lines (Post-gate approval).
Rollback: Red dashed lines (Constraint violations).

Workflow

Analyze Context: Read the project's PRD.md or latest design/ docs to understand the structure.
Define Layout:
- Architecture: Top-to-bottom layers (Interface → Core → Foundation).
- Workflow: Left-to-right (Phase 1 → Phase 8).
- Sequence: Vertical lifelines with horizontal interaction.
Generate SVG: Use the Python list method for error-free generation.

Export PNG:

rsvg-convert -w 1920 [output-name].svg -o [output-name].png

Record Achievement: Update History_Update.md noting the addition of visual documentation.

Documentation

Refer to docs/visual-standards/ for exact color tokens, icons, and style specifics:

style-6-claude-official.md: Detailed tokens for the default SDD look.
icons.md: Semantic icons for LLMs, Databases, and Cloud services.

Deliverables

Always provide:

The .svg file for future editing.
The .png file (1920px Retina) for immediate viewing.
A brief explanation of the architectural choices visualized.

Motto: "If it is designed right, it looks right."

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.