> common-architecture-diagramming
Standards for creating clear, audience-appropriate C4 and UML architecture diagrams with Mermaid. Use when producing system context diagrams, container views, sequence diagrams, or updating ARCHITECTURE.md files. (triggers: ARCHITECTURE.md, **/*.mermaid, **/*.drawio, diagram, architecture, c4, system design, mermaid)
curl "https://skillshub.wtf/HoangNguyen0403/agent-skills-standard/common-architecture-diagramming?format=md"Architecture Diagramming Standard
Priority: P1 (Standard)
Guidelines
- Use C4 Model: Context -> Container -> Component -> Code.
- Audience-Centric: Tailor abstraction (Execs vs. Devs).
- Select Type: Sequence (Protocol), ERD (Data), State (Lifecycle), Cloud (Infra). See Selection.
- Explicit Labels: Label every arrow (e.g., "Uses", "HTTPS").
- Consistent Notation: Cylinders=DB, Rectangles=Systems, Dashed=Async.
- Metadata: Title, Date, Version, Author.
- Legend Mandatory: Define all shapes/colors/styles.
- Direction:
graph LR(Flow) orgraph TD(Hierarchy). - Deployment: Map containers to infrastructure.
- Governance: CRITICAL: Review best-practices.md before starting.
See implementation examples for a C4 container diagram in Mermaid.
Anti-Patterns
- Mixed Levels: DB columns in System Context.
- Unlabeled Arrows: Ambiguous relations.
- Mystery Shapes: Undefined in Legend.
- Dead Ends: Unconnected nodes.
- Clutter: >20 nodes/diagram.
- Acronyms: Undefined abbreviations.
References
> related_skills --same-repo
> common-store-changelog
Generate user-facing release notes for the Apple App Store and Google Play Store by collecting git history, triaging user-impacting changes, and drafting store-compliant changelogs. Enforces character limits (App Store ≤4000, Google Play ≤500), tone, and bullet format. Use when generating release notes, app store changelog, play store release, what's new, or version release notes for any mobile app. (triggers: generate changelog, app store notes, play store release, what's new, release notes, ve
> golang-tooling
Go developer toolchain — gopls LSP diagnostics, linting, formatting, and vet. Use when setting up Go tooling, running linters, or integrating gopls with Claude Code. (triggers: gopls, golangci-lint, golangci.yml, go vet, goimports, staticcheck, go tooling, go lint)
> common-ui-design
Design distinctive, production-grade frontend UI with bold aesthetic choices. Use when building web components, pages, interfaces, dashboards, or applications in any framework (React, Next.js, Angular, Vue, HTML/CSS). (triggers: build a page, create a component, design a dashboard, landing page, UI for, build a layout, make it look good, improve the design, build UI, create interface, design screen)
> common-owasp
OWASP Top 10 audit checklist for Web Applications (2021) and APIs (2023). Load during any security review, PR review, or codebase audit touching web, mobile backend, or API code. (triggers: security review, OWASP, broken access control, IDOR, BOLA, injection, broken auth, API review, authorization, access control)