Skip to main content
skill CX Codex

w-diagram — Claude Code skill: diagrams and setup

The w-diagram Claude Code skill turns code, architecture, or data flows into Mermaid diagrams. For product and architecture requests, it compares named MDX or DESIGN.md files with the code.

MIT 647 installs ★ 1 updated 2026-10-02

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add blockmatic-icebox/basilic-skills --skill w-diagram -a claude-code
Open on GitHub

What w-diagram does

w-diagram inspects the code or documentation named in a request, then chooses a Mermaid diagram that fits the question, such as a flowchart, sequence, or class diagram. Labels stay brief, and oversized graphs are split. It adds a short explanation of the diagram.

For product, journey, or architecture documentation, the skill reads the named MDX files or DESIGN.md and produces no more than two diagrams. It flags conflicts between documentation and code. Every node and edge must come from inspected sources; the skill does not fill in missing architecture. The result goes to chat unless the request includes a file path.

What it helps with

  • map a data flow through code
  • show the steps in a user journey
  • visualize relationships between classes
  • spot conflicts between docs and code

Example prompts for the agent

  • Draw a data-flow diagram for src/api.ts.
  • Show the sequence of actions in the journey described in journey.mdx.
  • Compare the architecture in DESIGN.md with the code and diagram it.

How to install w-diagram

1Skills CLI (Vercel)

npx skills add blockmatic-icebox/basilic-skills --skill w-diagram -a claude-code

2Manually: put the files in place

~/.claude/skills/w-diagram/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/w-diagram/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about w-diagram

How do I install w-diagram in Claude Code?

Run npx skills add blockmatic-icebox/basilic-skills --skill w-diagram -a claude-code. The skill file is at ~/.claude/skills/w-diagram/SKILL.md.

What does w-diagram do?

It examines the specified code or documentation and creates a Mermaid diagram suited to the request. The output goes to chat unless a file path is supplied.

How many diagrams can w-diagram make from architecture documentation?

For product, journey, or architecture requests, it reads the named MDX files or DESIGN.md and produces at most two diagrams.

Source text

SKILL.md · MIT
---
name: w-diagram
description: Produce a Mermaid diagram of the requested code, architecture, or data flow.
disable-model-invocation: true
---

Visualize relationships, flow, or structure. Chat output unless the user gave a file path. Do not invent architecture that is not in the sources. Do not invent `PRODUCT.md`.

1. If the request is product, journey, or architecture docs, read named MDX/`DESIGN.md` and emit at most two Mermaid diagrams from those sources. Flag contradictions between docs and code without proposing a new methodology.
2. Otherwise inspect the named code or docs. Choose flowchart, sequence, class, er, state, or journey only when it matches the question.
3. Keep labels short. Split oversized graphs. Wrap output in a mermaid fence.
4. Explain what the diagram shows in a few sentences. Nodes and edges must map to inspected sources.

© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills

Similar skills

SKILL.md skills catalog →

From the same set45

The whole set →
w-form The w-form Claude Code skill guides form work in a Next.js app through the mutation path the project already uses. Invoke it to build a form. CX Codex +1 647installs w-v0 The w-v0 Claude Code skill drafts a v0.dev prompt from the current file, selection, and project stack. It opens the generated link only after OPEN. CX Codex +1 647installs w-shadcn The w-shadcn Claude Code skill adds shadcn primitives to a shared UI package or extends existing ones. It handles component-level work; screen redesigns go through /w-ui. CX Codex +1 647installs w-ui w-ui — a Claude Code skill for building or reshaping user-facing interfaces around a project’s existing tokens and accessible interactions. It checks rendered screens on desktop and mobile. CX Codex +1 647installs w-onboard The w-onboard Claude Code skill takes a developer from cloning a repository to a running local app. It follows project setup instructions and checks that the app can reach its API. CX Codex +1 647installs w-api-docs The w-api-docs Claude Code skill refreshes API documentation from its source schema or routes. It steps in when an API change needs to be reflected in generated docs. CX Codex +1 647installs w-docs w-docs — a skill for Claude Code updates project docs after code or feature changes. It selects the docs layer that owns the change. CX Codex +1 647installs w-architecture The w-architecture Claude Code skill plans an implementation structure against a project's architecture docs and ADRs. It runs on requests to plan a change. CX Codex +1 647installs

Project sponsors

Companies that keep this analytics open