Diagram Design, 간단한 설명으로 독립형 HTML·SVG 파일 하나를 만듭니다

Diagram Design은 에이전트가 SVG를 포함한 독립형 HTML 파일 하나로 다이어그램을 작성하게 하고, 지정한 사이트의 색상과 글꼴에도 맞춥니다. 프런트엔드, 백엔드, 데이터베이스, Redis 캐시로 구성한 아키텍처를 Mermaid 텍스트나 드로잉 도구에서 끌어다 놓은 도형 대신, 에이전트가 작성하는 파일로 받고 싶을 때 손을 뻗습니다.
에이전트가 다이어그램 유형을 고르고, 계획을 밝힌 뒤 HTML 파일 하나를 작성합니다.
이 저장소에는 스타 69,268개와 포크 4,652개가 있고, 열린 이슈는 44개입니다. 2026-04-16에 생겼으며 마지막 푸시는 2026-11-19입니다. 라이선스는 MIT입니다.
없을 때와 있을 때
이 스킬이 없으면 그 아키텍처 요청은 Mermaid나 PlantUML에 넣을 텍스트를 직접 쓰는 일이 됩니다. 레이아웃은 자동으로 잡히고, 그림은 그 렌더러의 테마를 따릅니다. 문서에 적힌 다른 방법은 draw.io나 Excalidraw이며, 여기서는 도형을 하나씩 직접 배치합니다.
이 스킬이 있으면 같은 앱을 평범한 말로 설명합니다. 에이전트가 유형을 고르고 계획을 밝힌 뒤 HTML 파일 하나를 작성합니다. 다이어그램을 4px 그리드에 배치하고, CI가 겹침과 잘림 여부를 검사합니다. 파일은 HTML과 SVG로 이루어지며, 스킬은 그림자를 추가하지 않습니다.
무엇을 결정하나
에이전트는 요청마다 모든 다이어그램 유형을 실행하지 않습니다. 사용한 표현에 맞춰 유형 하나를 고르고, 계획을 밝힌 뒤 브라우저에서 여는 .html 파일 하나를 작성합니다. 배치는 4px 그리드에 맞춥니다. CI가 그 배치에 겹침과 잘림이 없는지 검사합니다. 이 검사는 레이아웃 방식의 일부입니다. 파일마다 따로 입력해야 하는 명령은 아닙니다.
요청이 다르면 갈래도 달라집니다. 온보드 명령은 지정한 URL에서 팔레트와 글꼴을 읽고, 이후 다이어그램이 그 값을 사용합니다. 가져오기는 draw.io, Mermaid, Excalidraw, PlantUML을 읽습니다. 내보내기는 PNG나 SVG를 출력합니다. 이 가져오기·내보내기 명령은 네이티브 패키지에 남아 있습니다. 일반 skills CLI 설치본은 이 명령을 추가하지 않습니다.
설치도 갈래가 나뉩니다. npx skills add가 스킬 디렉터리를 둘 이상 찾으면 방법을 묻고 심볼릭 링크를 권장합니다: 정본 복사본 하나를 각 루트에 링크해 두면 이후 업데이트가 모든 루트에 닿습니다. 각 루트에 독립 복사본을 두려면 --copy를 넘기세요. 디렉터리 하나로 정해지는 선택은 복사합니다. 그 경우에는 차이가 문제되지 않기 때문입니다. 심볼릭 링크를 쓸 수 없으면(개발자 모드가 꺼진 Windows 포함) CLI가 복사하고, 어느 루트에 복사했는지 알려 줍니다.
references/style-guide.md를 편집하고 그 편집을 유지하려면 저장소를 클론한 뒤 그 로컬 경로에서 설치하세요. 관리형 설치에서는 업데이트가 해당 파일을 교체할 수 있습니다. ~/.diagram-design/profiles/에 저장한 프로필은 그대로 남습니다. 그 업데이트는 .diagram-design 표시가 있는 프로젝트를 건드리지 않습니다.
사용 방법
쓸 때
프런트엔드, 백엔드, 데이터베이스, Redis 캐시가 있는 애플리케이션의 다이어그램이 필요합니다.
Make me an architecture diagram of my app: frontend, backend, database, Redis cache.
에이전트가 유형을 고르고 계획을 밝히면, 그 아키텍처를 담은 HTML 파일 하나를 받습니다.
쓸 때
401 응답 뒤 토큰을 갱신하는 Bearer 호출의 순서가 필요합니다.
Give me a sequence of a bearer call with token refresh on 401.
완성 파일로는 Mermaid 소스 블록이 아니라 그 순서를 보여 주는 HTML 파일 하나를 받습니다.
쓸 때
이미 운영하는 사이트의 팔레트와 글꼴을 이후 다이어그램에 쓰고 싶습니다.
Onboard diagram-design to https://yoursite.com
그 사이트에서 읽은 팔레트와 글꼴을 쓰는 이후 다이어그램을 받습니다. PRIVACY.md는 스킬이 네트워크로 보내는 내용을 나열합니다.
설치
npx skills add cathrynlavery/diagram-design
/plugin marketplace add cathrynlavery/diagram-design
/plugin install diagram-design@diagram-design
codex plugin marketplace add cathrynlavery/diagram-design
codex plugin add diagram-design@diagram-design
copilot plugin marketplace add cathrynlavery/diagram-design
copilot plugin install diagram-design@diagram-design
droid plugin marketplace add https://github.com/cathrynlavery/diagram-design
droid plugin install diagram-design@diagram-design --scope user
git clone https://github.com/cathrynlavery/diagram-design.git
qoder plugins validate ./diagram-design
qoder plugins install ./diagram-design
qoder plugins list
pi install https://github.com/cathrynlavery/diagram-design
설치한 뒤에는 필요한 다이어그램을 평범한 문장으로 요청하세요. 예를 들어 프런트엔드, 백엔드, 데이터베이스, Redis 캐시 아키텍처를 요청하면 됩니다.
이 도구가 맞지 않을 때
npx skills add 설치본은 마켓플레이스 업데이트를 따라가지 않으며, /export-diagram, /import-mermaid, /import-plantuml, /profile, /doctor도 추가하지 않습니다. 이런 명령과 해당 호스트의 업데이트 경로가 필요하면 호스트 마켓플레이스를 사용하세요. 작업이 다이어그램 파일이 아니면 Diagram Design은 역시 고를 저장소가 아닙니다.
| 저장소 | 스타 수 | 해당 저장소를 고르는 경우 | Diagram Design을 고르는 경우 |
|---|---|---|---|
| morluto/rea | 471,470 | 에이전트가 애플리케이션을 동작부터 네이티브 바이너리까지 역공학해야 할 때 | 작업이 바이너리 추적이 아니라 다이어그램 파일일 때 |
| mattpocock/skills | 328,926 | 작동하는 에이전트 디렉터리에서 폭넓은 엔지니어링 스킬 세트를 원할 때 | 다이어그램 파일을 작성하는 이 스킬 하나를 원할 때 |
| obra/superpowers | 322,820 | 에이전트형 스킬 프레임워크와 소프트웨어 개발 방법론을 원할 때 | 개발 방법론이 아니라 다이어그램을 원할 때 |
많이 묻는 질문
어떤 코딩 에이전트가 Diagram Design을 설치할 수 있나요?
Agent Skills를 읽는 호스트라면 npx skills add cathrynlavery/diagram-design를 쓸 수 있습니다. 여기에는 Cursor, Claude Code, Codex, Qoder, GitHub Copilot, Gemini CLI, Cline, Windsurf, Amp가 포함됩니다. Factory Droid, Pi, Kiro, OpenCode, Claude Cowork는 저장소 README에 있는 호스트별 설치 절차를 따르며, 공식 빌드는 이 저장소에서만 나옵니다.
skills CLI 설치로는 무엇을 얻을 수 없나요?
그 명령은 선택한 스킬 루트에 references/, assets/, scripts/를 포함한 Agent Skill을 설치합니다. /export-diagram, /import-mermaid, /import-plantuml, /profile, /doctor는 네이티브 패키지에 남아 있고, 이 독립 복사본은 마켓플레이스 업데이트를 따라가지 않습니다. 따라서 npx skills update diagram-design을 실행하거나, 아니면 호스트 마켓플레이스 패키지를 대신 설치하세요.
브랜드 프로필은 어디에 남고, 업데이트가 무엇을 교체할 수 있나요?
~/.diagram-design/profiles/에 저장한 프로필은 패키지 업데이트를 거쳐도 남고, .diagram-design 표시가 있는 프로젝트는 영향을 받지 않습니다. 관리형 설치에서 references/style-guide.md를 편집한 내용은 다음 업데이트가 교체할 수 있습니다. 그래서 그런 변경은 로컬 경로에서 설치한 클론에 두세요.
평범한 설명으로 HTML과 SVG가 담긴 파일 하나를 원할 때 Diagram Design을 고르세요. 역공학, 일반 스킬 팩, 개발 방법론이 작업이라면 다른 저장소를 고르세요.
출처: https://github.com/cathrynlavery/diagram-design
'AI 스킬' 카테고리의 다른 글
| /last30days, last30days, Reddit, X, YouTube를 한 번에 훑는 주제 조사 (0) | 2026.11.20 |
|---|---|
| Humanizer, AI가 쓴 글을 사람이 쓴 것처럼 읽히게 (0) | 2026.11.20 |
| security-audit, 독립 검증을 거치는 구조화 코드 보안 감사 (0) | 2026.11.19 |

