mgiovani/ai-arsenal / skills/docs-diagram
docs-diagram
VerifiedGenerate a Mermaid diagram (ER, architecture, deployment, or security) by reading the actual codebase and writing it to docs/. Use for requests like "draw an ER diagram of these tables", "show me the architecture", "diagram the deployment setup", "visualize the security data flow", or "generate a system diagram". Not for scaffolding a new docs directory structure (use docs-init), syncing existing prose docs with code changes (use docs-update), or recording a design decision's rationale (use docs-adr), this skill only produces diagrams generated from code.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.6 KB |
| assets/templates/architecture.md | markdown | 745 B |
| assets/templates/data-model.md | markdown | 873 B |
| assets/templates/deployment.md | markdown | 829 B |
| assets/templates/security.md | markdown | 705 B |
| evals/evals.json | config | 3.1 KB |
| evals/trigger-eval.json | config | 1.8 KB |
| references/detection-patterns.md | markdown | 1.7 KB |
| references/mermaid-patterns.md | markdown | 3.1 KB |
assets/templates/architecture.md
View on GitHub# {{PROJECT_NAME}} Architecture
**Last Updated:** {{DATE}}
## Overview
{{ARCHITECTURE_OVERVIEW}}
[One paragraph: what this system does, its main components, and how they interact.]
## Diagram
```mermaid
{{DIAGRAM_CONTENT}}
```
## Components
- **{{COMPONENT_1_NAME}}**: {{COMPONENT_1_DESCRIPTION}}
- **{{COMPONENT_2_NAME}}**: {{COMPONENT_2_DESCRIPTION}}
- **{{COMPONENT_3_NAME}}**: {{COMPONENT_3_DESCRIPTION}}
## External Integrations
- **{{EXTERNAL_1_NAME}}**: {{EXTERNAL_1_DESCRIPTION}}
- **{{EXTERNAL_2_NAME}}**: {{EXTERNAL_2_DESCRIPTION}}
## Data Flow
1. {{DATA_FLOW_STEP_1}}
2. {{DATA_FLOW_STEP_2}}
3. {{DATA_FLOW_STEP_3}}
---
*Generated from the codebase. Regenerate with docs-diagram after significant architecture changes.*
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |