Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add HoangNguyen0403/agent-skills-standard --skill common-architecture-diagramminggit clone --depth 1 https://github.com/HoangNguyen0403/agent-skills-standardWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/hoangnguyen0403/agent-skills-standard/common-architecture-diagramming)<a href="https://agentmods.dev/skills/hoangnguyen0403/agent-skills-standard/common-architecture-diagramming"><img src="https://agentmods.dev/badge/skills/hoangnguyen0403/agent-skills-standard/common-architecture-diagramming/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/hoangnguyen0403/agent-skills-standard/common-architecture-diagramming"><img src="https://agentmods.dev/badge/skills/hoangnguyen0403/agent-skills-standard/common-architecture-diagramming.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00071 | $0.01227 |
| Opus 5.5 | $0.00028 | $0.00491 |
| Sonnet 5.5 | $0.00014 | $0.00245 |
| Haiku 4.5 | $0.00007 | $0.00123 |
Grade A, and why
common-architecture-diagramming scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 26d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 93 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Architecture Diagramming Standard
Priority: P1 (HIGH)
Pipeline
Never hand-write mxGraph XML. Write a spec; the scripts own every visual decision, so diagrams stay identical across authors, repositories, and sessions.
- Write
spec.json— schema in diagram-spec.md. For an ERD, generate it:python3 scripts/schema_to_spec.py db/schema.sql --title "<System> — ERD" -o spec.json python3 scripts/validate_spec.py spec.jsonpython3 scripts/render_drawio.py spec.json -o docs/architecture/<slug>.drawio --strict(exit 2 = a layout finding; change the spec, per layout-rules.md)- For related views, optionally validate view-manifest.md:
python3 scripts/validate_manifest.py view-manifest.json - Export the image: a draw.io MCP tool if the session has one, else
python3 scripts/export_drawio.py docs/architecture/<slug>.drawio -f png -o docs/architecture/<slug>.png, else ship the.drawioand say the image was not exported. See export paths. - Inspect the exported image at normal reading size; strict validation cannot prove labels and edges are legible. Fix the spec and re-export before handoff.
The JSON spec is the semantic source of truth; .drawio is the editable presentation and the
image is a copy for a deck. Generated XML records its own baseline; regeneration protects
manual edits by default. Use --acknowledge-manual-edits only after returning semantic changes to the spec.
Guidelines
- Name the audience and the decision before drawing anything.
- One C4 level per diagram: context, container, or component, never mixed.
- Pick the type from the message, not from habit. See diagram-selection.md.
- Evidence and confidence are separate. Code citations are documented evidence, not runtime
observations; use
assumedorunverifiedfor honest design uncertainty. - Put the number on the box.
metriccarries the load or SLO that sized the node,constraintsays why it exists; never invent either. - Label every edge with its protocol or event; use
style: asyncfor events. - Cloud icons only where verified.
gcp:*andaws:*are official icons; every other vendor is acloud:*kind with the service named insublabel. No Azure logos exist in the bundle, so Azure is alwayscloud:*. - Exec audience caps at 12 nodes. Past that, split by level or by flow.
- Legend and title block are generated. Do not remove or duplicate them.
- Refine in the spec, not by mutating generated XML. Regeneration preserves files with a valid own baseline, but refuses hand mutation until explicitly acknowledged.
What ships with it
60 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- assets/fixtures/component.drawio 8.2 KB
- assets/fixtures/component.spec.json 3.9 KB
- assets/fixtures/container.drawio 13 KB
- assets/fixtures/container.spec.json 2.5 KB
- assets/fixtures/context.drawio 10 KB
- assets/fixtures/context.spec.json 1.5 KB
- assets/fixtures/dataflow.drawio 12 KB
- assets/fixtures/dataflow.spec.json 1.6 KB
- assets/fixtures/deployment.drawio 18 KB
- assets/fixtures/deployment.spec.json 2.3 KB
- assets/fixtures/erd.drawio 9.8 KB
- assets/fixtures/erd.spec.json 2.1 KB
- assets/fixtures/evidence/component-view.md 476 B
- assets/fixtures/evidence/orders_api.py 395 B runs code
- assets/fixtures/evidence/orders_retry.py 427 B runs code
- assets/fixtures/evidence/orders_schema.sql 169 B
- assets/fixtures/schemas/orders_models.py 834 B runs code
- assets/fixtures/schemas/orders_models.py.expected.json 3.2 KB
- assets/fixtures/schemas/orders.entity.ts 729 B runs code
- assets/fixtures/schemas/orders.entity.ts.expected.json 2.3 KB
- assets/fixtures/schemas/orders.prisma 451 B
- assets/fixtures/schemas/orders.prisma.expected.json 2.3 KB
- assets/fixtures/schemas/orders.sql 427 B
- assets/fixtures/schemas/orders.sql.expected.json 2.5 KB
- assets/fixtures/sequence.drawio 10 KB
- assets/fixtures/sequence.spec.json 1.4 KB
- assets/fixtures/state.drawio 9.2 KB
- assets/fixtures/state.spec.json 1.4 KB
- assets/fixtures/view-manifest.json 1.5 KB
- assets/fixtures/views/orders-containers.spec.json 2.6 KB
- LICENSE 1.0 KB
- references/best-practices.md 3.0 KB
- references/c4-model.md 968 B
- references/checklist.md 3.9 KB
- references/cloud-architecture.md 2.8 KB
- references/diagram-selection.md 2.7 KB
- references/diagram-spec.md 10.0 KB
- references/exec-readability.md 1.9 KB
- references/house-style.md 2.3 KB
- references/layout-rules.md 3.0 KB
- references/mermaid-fallback.md 2.9 KB
- references/source-extraction.md 2.5 KB
- references/style-catalog.md 3.2 KB
- references/view-manifest.md 4.6 KB
- scripts/check_layout.py 8.5 KB runs code
- scripts/export_drawio.py 3.4 KB runs code
- scripts/render_drawio.py 29 KB runs code
- scripts/render_erd.py 3.8 KB runs code
- scripts/schema_parsers/__init__.py 1.2 KB runs code
- scripts/schema_parsers/django_sqlalchemy.py 3.7 KB runs code
- scripts/schema_parsers/model.py 762 B runs code
- scripts/schema_parsers/prisma.py 2.7 KB runs code
- scripts/schema_parsers/sql_ddl.py 3.5 KB runs code
- scripts/schema_parsers/typeorm.py 3.4 KB runs code
- scripts/schema_to_spec.py 4.3 KB runs code
- scripts/style_catalog.py 11 KB runs code
- scripts/test_check_layout.py 13 KB runs code
- scripts/test_fixtures.py 2.6 KB runs code
- scripts/test_render_drawio.py 46 KB runs code
- scripts/test_schema_parsers.py 9.0 KB runs code
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 26d ago Changed · +1 lines 0ea84fb78e9f
- 1mo ago Changed · +5 lines · +11 tokens per session 79d9439a6c2e
- 1mo ago Changed · +25 lines · -2 tokens per session db4e8b9d4579
- 1mo ago First seen · 62 lines · 62 tokens per session scan A 965f6529a328
common-architecture-diagramming is a skill published in the GitHub repository HoangNguyen0403/agent-skills-standard (583 stars, last pushed yesterday), licensed MIT. It adds 71 tokens to every session and 1,227 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.
Other skills, from other repositories
magic-ui
Use this skill when users want to add, customize, or troubleshoot Magic UI components in React/Next.js projects. It covers component selection, shadcn registry installation (@magicui/), integration patterns, and practical quality checks for accessibility and maintainability.
frontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI).…
frontend-design
Generates distinctive, production-grade frontend interfaces and artifacts (React, Vue, HTML/CSS). Prioritizes bold aesthetics, unique typography, and motion to avoid generic designs. Use when building websites, landing pages, dashboards, posters, or when the user requests to style, beautify, or create visually…
modern-site-engineering
Integrate systems after frontend direction.
radix-accessible-primitives
Repair Radix parts, portals and focus mechanics.
nextjs-shadcn
Builds distinctive Next.js interfaces with shadcn/ui, choosing typography, styling and purposeful visual effects for the product. Use when creating or polishing a Next.js + shadcn app, page or component, including themes, presets, backgrounds and design-system lint. Uses frontend-design for substantial visual…