Diagramar

Use in discovery to draw the HIGH-LEVEL architecture in Mermaid — context diagram (C4 L1), containers (C4 L2), and the bounded contexts map (DDD). It reads vision, context-map, design, and assessment, and generates/updates docs/architecture/diagrams.md. It keeps a high level, with no implementation detail. Trigger with /diagramar.

100 stars 27 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add adriannoes/awesome-agentic-ai --skill diagramar
Manual install
git clone --depth 1 https://github.com/adriannoes/awesome-agentic-ai.git /tmp/awesome-agentic-ai
mkdir -p ~/.claude/skills
cp -r /tmp/awesome-agentic-ai/cursor-claude-codex/skills/igoruehara-spec-driven/skills/diagramar ~/.claude/skills/diagramar

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

> **Translation note:** Originally authored in Portuguese (pt-BR) by Igor Uehara ([igoruehara/spec-driven](https://github.com/igoruehara/spec-driven), MIT). Translated to English by this hub to keep the repository language consistent. Original content unchanged in meaning; see the upstream repo for the pt-BR source.

# Skill: Diagram architecture (Mermaid, high level)

Generates the architecture diagrams in **Mermaid** (they render on GitHub and in Claude Code) from the
discovery artifacts. Keep it **high level**: actors, systems, containers, and contexts — never classes,
tables, or implementation detail (that is the scope of the feature's `design.md`).

## Inputs (pull only what exists and cite the source)
- `docs/product/vision.md` — actors/personas and the system's purpose.
- `docs/architecture/context-map.md` — bounded contexts and relationships (DDD).
- `specs/*/design.md` — containers, services, and integrations.
- `docs/architecture/assessment.md` — as-is, in brownfield.
- **Gaps** → ask (`AskUserQuestion`): external actors, neighboring systems, the main containers
  (UI/services/data/queues), and the critical journey to illustrate.

## Diagrams (high level, aligned with C4 + DDD)
1. **System context (C4 L1):** the system at the center + personas + external systems.
2. **Containers (C4 L2):** apps/services, data, queues, and how they talk.
3. **Bounded contexts map (DDD):** contexts and relationship patterns (ACL, Customer/Supplier,
   Conformist, Shared Kernel).
Read the full skill on GitHub

Details

Skill name
diagramar
Path
cursor-claude-codex/skills/igoruehara-spec-driven/skills/diagramar/SKILL.md
License
MIT
Repo updated
2 November 2026

FAQ

What does the Diagramar skill do?

Use in discovery to draw the HIGH-LEVEL architecture in Mermaid — context diagram (C4 L1), containers (C4 L2), and the bounded contexts map (DDD). It reads vision, context-map, design, and assessment, and generates/updates docs/architecture/diagrams.md. It keeps a high level, with no implementation detail. Trigger with /diagramar.

How do I install the Diagramar skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add adriannoes/awesome-agentic-ai --skill diagramar. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Diagramar popular?

It lives in adriannoes/awesome-agentic-ai, which has 100 GitHub stars and 27 forks, and is included in 2 curated skill lists.

Related skills

Browserstack

100

adriannoes/awesome-agentic-ai

Run tests on BrowserStack. Use when user mentions "browserstack", "cross-browser", "cloud testing", "browser matrix", "test on safari", "test on firefox", or "browser compatibility".

Testing & QAIn 2 lists27

Coverage

100

adriannoes/awesome-agentic-ai

Analyze test coverage gaps. Use when user says "test coverage", "what's not tested", "coverage gaps", "missing tests", "coverage report", or "what needs testing".

Testing & QAIn 2 lists27

Fix

100

adriannoes/awesome-agentic-ai

Fix failing or flaky Playwright tests. Use when user says "fix test", "flaky test", "test failing", "debug test", "test broken", "test passes sometimes", or "intermittent failure".

Testing & QAIn 2 lists27

Hackathon Sponsorship

88

jonathimer/devmarketing-skills

Getting ROI from hackathon sponsorships for developer tools. Covers evaluating which hackathons to sponsor, booth presence strategies, prizes that actually work, judge involvement, follow-up strategies, and measuring sponsorship ROI. Use when asked about: - Hackathon sponsorship strategy - Developer event sponsorship ROI - Hackathon prizes - Booth presence at hackathons - Post-hackathon follow-up - Hackathon sponsorship evaluation

Software DevelopmentIn 1 list

Developer Signup Flow

88

jonathimer/devmarketing-skills

Design frictionless signup experiences for developers including GitHub OAuth, API key generation, and onboarding personalization. Trigger phrases: developer signup, dev registration, OAuth flow, API key onboarding, reduce signup friction, developer authentication, signup conversion, registration UX

Software DevelopmentIn 1 list

Hunt API Misconfig

100

adriannoes/awesome-agentic-ai

Hunt API security misconfiguration — mass assignment, JWT attacks, prototype pollution, CORS, HTTP verb tampering. Mass assignment: send {is_admin:true, role:admin, verified:true} on profile/account/reset endpoints — server blindly applies. JWT: alg=none, weak HMAC bruteforce, kid path traversal, JWK injection, token confusion. Prototype pollution: __proto__ injection in JSON merge / Object.assign / lodash _.merge → polluted prototype reaches sink (RCE in Node, XSS in browser). CORS: wildcard with credentials, null origin, regex with subdomain takeover, postMessage origin checks. HTTP verb: GE

Software DevelopmentIn 2 lists27

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.