skills.rest
SteveGJones
SteveGJonesCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

service-architecture-renderer

Generate service-architecture SVG diagrams from canonical service domain model JSON.

3|Updated Mar 29, 2026
Search Tags:#architecture#service#svg#diagram#graphviz#domain-model#canonical-model
One-click install
npx skills add https://github.com/SteveGJones/jack-tar-deckhand --skill service-architecture-renderer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: service-architecture-renderer
Source: https://github.com/SteveGJones/jack-tar-deckhand/tree/main/.claude/skills/service-architecture-renderer
Command: npx skills add https://github.com/SteveGJones/jack-tar-deckhand --skill service-architecture-renderer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generating clear, enterprise-grade diagrams from a canonical service domain model JSON eliminates manual diagramming work and ensures consistency for stakeholders.

Core Features & Use Cases

  • Generates one-service-level diagrams showing services, AI Personas, human and system actors, external interactions, and interaction flows.
  • Uses Graphviz (neato) for layout and produces professionally styled SVGs; falls back to a manual layout if Graphviz is not installed.
  • Works with canonical-model JSON inputs to produce enterprise-wide L0 diagrams or drill-down L1-L6 views for detailed exploration.

Quick Start

Provide a canonical service domain model JSON to the renderer to generate the desired diagram.

Frequently Asked Questions about service-architecture-renderer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate service architecture diagrams from a domain model JSON?▼

To generate service architecture diagrams, provide a canonical service domain model JSON to the renderer. It produces professionally styled SVGs showing services, actors, and interactions.

Do I need Graphviz installed to render architecture SVGs?▼

Graphviz is required for automated layout to render architecture SVGs. The tool falls back to a manual layout if Graphviz is unavailable, ensuring output generation continues without interruption.

What is a canonical service domain model and when do I need to diagram it?▼

A canonical service domain model is a structured JSON representing enterprise services and interactions. You need to diagram it to provide stakeholders with consistent L0 enterprise views or detailed L1-L6 drill-down exploration.

Can I create drill-down L1 to L6 enterprise architecture views?▼

Yes, you can create drill-down L1 to L6 enterprise architecture views. The renderer supports generating detailed diagrams from the canonical model JSON for granular service-level exploration.

Does the service architecture renderer work without Graphviz for SVG output?▼

The renderer outputs SVGs using Graphviz neato for layout, but it does work without Graphviz by falling back to a manual layout. You still get an SVG diagram output regardless of the environment.

What's the best way to visualize human and system actors in a service architecture?▼

The best way to visualize human and system actors is by processing a canonical domain model JSON through the renderer. It automatically maps services, AI Personas, and interaction flows into a structured SVG.

Related Skills

Explore More Software Engineering Skills→
SteveGJonesSteveGJones
3

bsa-documentation-generator

Transform canonical service domain model JSON into architecture documentation.

Community
Advanced
tiancaiamaotiancaiamao
5

architecture-diagram

Create dark-themed architecture diagrams as self-contained HTML files with inline SVG.

Community
Intermediate
rlagycksrlagycks
3

ontology-sync

Validate domain spec sections and synchronize ontology index JSON files.

Community
Intermediate
VSF-QC-TTSVSF-QC-TTS

common-architecture-diagramming

Standardize architecture diagrams using C4 and UML models with Mermaid syntax.

Official
Intermediate