Communitygithub.com

markdown-viewer/architecture

Crea diagramas de arquitectura de sistemas en capas usando plantillas HTML/CSS con niveles codificados por colores y diseños de cuadrícula. Ideal para pilas tecnológicas, topología de microservicios y diseño de aplicaciones de múltiples capas.

¿Qué es architecture?

Este skill permite generar diagramas de arquitectura de sistemas visualmente atractivos y detallados directamente desde Markdown. Utiliza plantillas HTML/CSS para crear representaciones de sistemas en capas con niveles codificados por colores y diseños de cuadrícula, lo que facilita la comprensión de la estructura y las relaciones entre componentes. Es especialmente útil para documentar pilas tecnológicas, topologías de microservicios y aplicaciones de múltiples capas. Los diagramas se renderizan como HTML, por lo que son compatibles con cualquier plataforma que admita Markdown y visualización web, como GitHub, GitLab o sitios de documentación estática. El flujo de trabajo es simple: se describe la arquitectura en Markdown usando una sintaxis específica, y el skill transforma esa descripción en un diagrama HTML/CSS listo para incrustar.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/markdown-viewer/skills/tree/main/skills/architecture

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace architecture?

Crea diagramas de arquitectura de sistemas en capas usando plantillas HTML/CSS con niveles codificados por colores y diseños de cuadrícula. Ideal para pilas tecnológicas, topología de microservicios y diseño de aplicaciones de múltiples capas.

Sintaxis

Para crear un diagrama de arquitectura, usa el siguiente formato en tu Markdown:

```architecture
Nombre del Sistema
Capa 1: [Componente1] [Componente2] [Componente3]
Capa 2: [ComponenteA] [ComponenteB]
Capa 3: [ComponenteX]

### Parámetros

- **Nombre del Sistema**: Título opcional del diagrama.
- **Capas**: Define una o más capas, cada una en una línea nueva. El nombre de la capa va antes de los dos puntos `:`. Los componentes se listan entre corchetes `[]` separados por espacios.
- **Colores**: Los niveles se asignan automáticamente con colores predefinidos, pero se pueden personalizar agregando un color en formato hexadecimal después del nombre de la capa (ej. `Capa 1 (#ff5733): [Componente1]`).

### Ejemplo

```markdown
```architecture
Sistema de Reservas
Frontend: [React App] [Webpack]
Backend: [Node.js] [Express] [Base de Datos]
Infraestructura: [Docker] [Kubernetes] [AWS]

Esto generará un diagrama con tres capas (Frontend, Backend, Infraestructura) y sus respectivos componentes.

## Salida

El skill renderiza el diagrama como HTML incrustado en tu Markdown. El HTML incluye estilos CSS que se encargan del diseño de cuadrícula, los colores de los niveles y la disposición de los componentes.

## Plataformas Soportadas

- Cualquier visor de Markdown que admita HTML (como GitHub, GitLab, Typora, etc.)
- No requiere plugins adicionales; todo el CSS está inline en el HTML generado.

## Personalización

- **Colores**: Puedes cambiar el color de cada capa usando un código hexadecimal después del nombre de la capa (ej. `Capa 2 (#00ff00): [ComponenteA]`).
- **Diseño**: Los componentes se distribuyen automáticamente en una cuadrícula flexible. Si necesitas más control, puedes ajustar el CSS inline que genera el skill (aunque esto se recomienda solo para usuarios avanzados).

## Notas

- Los nombres de los componentes deben ser cortos para que quepan bien en la cuadrícula.
- Si hay muchos componentes en una capa, se ajustarán automáticamente en varias filas.
- El diagrama es responsive y se adapta al ancho de la ventana.

## Ejemplo Completo

```markdown
```architecture
Aplicación Web
Presentación: [Next.js] [Tailwind CSS]
Lógica de Negocio: [API Gateway] [Microservicio A] [Microservicio B]
Datos: [PostgreSQL] [Redis] [S3]

Este ejemplo generará un diagrama de tres capas para una aplicación web moderna.

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

markdown-viewer/archimate

Create ArchiMate enterprise architecture diagrams using PlantUML stdlib macros. Best for TOGAF viewpoints, layered EA modeling (Business/Application/Technology), motivation analysis, and migration planning.

markdown-viewer/bpmn

Create business process diagrams using PlantUML syntax with BPMN, EIP, and Lean Mapping stencil icons. Best for workflow automation, approval chains, message-based integration patterns, and value stream mapping.

markdown-viewer/canvas

Create spatial diagrams with free-positioned nodes using JSON format. Best for concept maps, knowledge graphs, and planning boards requiring precise x/y coordinate control.

markdown-viewer/cloud

Create cloud provider architecture diagrams using PlantUML syntax with official AWS, Azure, GCP, and Alibaba Cloud service icons. Best for multi-service cloud topologies and migration blueprints.

markdown-viewer/data-analytics

Create data pipeline and analytics architecture diagrams using PlantUML syntax with database/analytics stencil icons. Best for ETL pipelines, data lakes, real-time streaming, data warehousing, and BI dashboard design.

markdown-viewer/graphviz

Create directed/undirected graphs using DOT language with automatic layout. Best for dependency trees, call graphs, package hierarchies, and module relationships requiring fine-grained edge routing.

markdown-viewer/infocard

Create editorial-style information cards using HTML/CSS in Markdown. Best for knowledge summaries, data highlights, event announcements, and single-topic content cards with magazine-quality typography.

markdown-viewer/iot

Create IoT architecture diagrams using PlantUML syntax with device and sensor stencil icons. Best for smart home, industrial IoT (IIoT), fleet management, edge computing, and sensor network layouts.

markdown-viewer/mindmap

Create hierarchical mind maps using PlantUML @startmindmap syntax. Best for brainstorming, topic decomposition, study notes, and decision trees with automatic radial layout, left/right branches, and per-node styling.

markdown-viewer/network

Create network topology diagrams using PlantUML syntax with mxgraph device icons (Cisco, Citrix, etc.). Best for LAN/WAN layouts, datacenter interconnects, and physical/logical network design.

markdown-viewer/security

Create security architecture diagrams using PlantUML syntax with identity, encryption, firewall, and compliance stencil icons. Best for IAM flows, zero-trust models, encryption pipelines, and threat detection architectures.

markdown-viewer/uml

Create UML diagrams using PlantUML syntax. Best for software modeling — Class, Sequence, Activity, State Machine, Component, Use Case, and Deployment diagrams with concise text-based notation and auto-layout.

markdown-viewer/vega

Create data-driven charts with Vega-Lite (declarative) and Vega (programmatic). Best for statistical visualization of numeric data — bar, line, scatter, heatmap, area, radar charts, and word clouds.

Skills relacionados