tranhieutt/visual-engineer
.claude/skills/visual-engineer/SKILL.md
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).
$ install --global
skillsauthnpx skillsauth add tranhieutt/software_development_department visual-engineerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 11:49 PM4.4s1 file scanned
SKILL.md
- name:
- visual-engineer
- description:
- 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).
- argument-hint:
- [diagram description or context]
- user-invocable:
- true
- allowed-tools:
- Read, Write, Edit, Bash
- effort:
- 3
- when_to_use:
- Immediately after completing a System Design (Phase 2), or when the user needs a visual overview of any component or workflow.
🎨 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.mdor latestdesign/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.mdnoting 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
.svgfile for future editing. - The
.pngfile (1920px Retina) for immediate viewing. - A brief explanation of the architectural choices visualized.
Motto: "If it is designed right, it looks right."
Related Skills
tranhieutt/vector-database-engineer
data-ai
VerifiedTrustedCommunity
Provides vector database and semantic search patterns for Pinecone, Weaviate, Qdrant, Milvus, and pgvector in RAG and recommendation systems. Use when implementing vector search or when the user mentions vector database, semantic search, embeddings, or similarity search.
60SKILL.mdUpdated Apr 15, 2026
tranhieutt/update-codemap
development
VerifiedTrustedCommunity
Updates docs/technical/CODEMAP.md by scanning the current codebase structure. Run after a significant feature merge, refactor, or when CODEMAP feels stale.
60SKILL.mdUpdated Apr 15, 2026
tranhieutt/unfreeze
development
VerifiedTrustedCommunity
Unlocks the codebase after a release freeze or incident freeze period to resume normal development. Use when a freeze period ends or when the user mentions unfreezing or lifting the code freeze.
60SKILL.mdUpdated Apr 15, 2026
tranhieutt/test-driven-development
development
VerifiedTrustedCommunity
Forces the strict Red-Green-Refactor development cycle. Requires writing a failing test and running it in the terminal before writing any implementation code.
60SKILL.mdUpdated Apr 15, 2026