Install
git clone https://github.com/SpillwaveSolutions/design-doc-mermaid.git누구에게 맞나
Claude Code에서 Mermaid 그림을 그리고 설계 문서를 쓰려는 사람에게 맞습니다. 공식 문구는 필요 시 불러오는 가이드, 코드에서 그림 생성, Python 도구로 Mermaid 그림과 설계 문서를 만드는 강력한 Claude Code 스킬 묶음이라고 합니다.
이미 흐름(가입과 이메일 확인 등)이 있거나 코드가 있어 먼저 그림을 보고 싶은 사람에게 더 맞습니다. 저장소를 ~/.claude/skills에 클론할 준비가 없는 사람에게는 맞지 않습니다.
시작하기 전에 git clone을 쓸 수 있어야 하고, 공식이 주는 이 한 가지 수동 설치 경로를 받아들여야 합니다. 처음부터 다른 마켓 명령을 섞지 마세요.
3분 만에 첫 시도
원문의 클론 설치만 따릅니다. 처음에는 대화에서 그림을 내고, 저장소에 설계 문서를 먼저 쓰지 마세요.
전제: 이 기기에 이미 git이 있고, Claude Code가 ~/.claude/skills에서 스킬을 불러옵니다. 처음에는 운영 문서를 덮어쓰지 마세요.
설치 위치: 먼저 스킬 디렉터리로 들어간 뒤 공식 저장소를 클론합니다.
cd ~/.claude/skills
git clone https://github.com/SpillwaveSolutions/design-doc-mermaid.git
공식 저장소 페이지:
https://github.com/spillwavesolutions/design-doc-mermaid
낮은 위험 트리거: 설치 후 대화에서 원문 예시 문장을 씁니다. Create an activity diagram for user registration with email verification. 먼저 대화 안에서만 Mermaid를 요청하고 파일은 쓰지 마세요. 공식은 SKILL.md를 결정 트리가 있는 주 조율 파일로 적습니다. 도우미가 이름 대지 않은 스크립트를 호출하기 시작하면 부작용을 먼저 확인하세요.
성공 신호: ~/.claude/skills/design-doc-mermaid가 있고 SKILL.md를 포함하며, 대화에 활동도 Mermaid가 나타납니다. 문서로 저장하려면 쓰기 전에 경로를 확인하세요.
사용 사례
사례 1: 공식 예시로 활동도를 그립니다. 도우미에게 Create an activity diagram for user registration with email verification라고 말하세요. 가입과 이메일 확인 흐름을 설명하려는 사람에게 맞습니다. 증거는 이 사용자 문장뿐이며 가이드 파일 이름은 없습니다. 대화에서 먼저 그림을 본 뒤 디스크에 쓸지 결정하세요.
사례 2: 기존 코드에서 그림을 만듭니다. 공식 능력에는 code-to-diagram generation이 있습니다. 이미 코드가 있고 먼저 그림을 보고 싶은 사람에게 맞습니다. 증거는 지원 언어나 소스 변경 여부를 말하지 않습니다. 본인 코드만 읽기 전용으로 생성하고, Python 도구가 파일을 쓰면 출력 위치를 먼저 확인하세요.
사용 한계
주 경로는 ~/.claude/skills로 클론하는 것입니다. 원문에는 skilz install SpillwaveSolutions_design-doc-mermaid/design-doc-mermaid도 있습니다. 처음에는 둘을 함께 하지 말고, 적히지 않은 환경에 마켓 명령을 적용하지 마세요.
이름을 댄 파일은 SKILL.md(주 조율, 결정 트리)뿐입니다. 다른 가이드 이름, 스크립트 이름, 스킬 경로를 스스로 채우지 마세요.
필요 시 가이드와 Python 도구는 언급되지만 목록은 없습니다. Mermaid 런타임을 자동 설치하거나 문서를 내보낸다고 가정하지 마세요.
공식은 이 스킬 묶음을 Claude Code 스킬로만 적었고 다른 환경 단계는 없습니다.