마크다운 & Mermaid 문서 작성
모든 보고서·문서·다이어그램을 마크다운 안의 Mermaid 텍스트 다이어그램으로 표준화해 주는 문서화 스킬.
문서·오피스입문★ 33,030⑂ 3,248AI 점수 8/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
이 스킬은 Claude가 문서를 만들 때 마크다운 + Mermaid 다이어그램을 기본 포맷으로 사용하도록 규칙을 세웁니다.
- 이미지 대신 텍스트 다이어그램을 사용해 git diff가 깔끔하고, GitHub·Notion·VS Code 어디서든 바로 렌더링됩니다.
- 플로우차트, 시퀀스, ER, 상태도, 간트, 마인드맵, 레이더 등 24종 다이어그램 가이드를 참조해 상황에 맞는 타입을 고릅니다.
- PR 기록, 이슈, ADR(결정 기록), 연구 논문, 상태 보고서 등 9종 문서 템플릿을 제공합니다.
- H1 1개 원칙, H2에만 이모지, 각주 인용
[^N], 표 우선 등 마크다운 스타일 규칙과accTitle/accDescr접근성 규칙을 강제합니다. %%{init}금지, 인라인 style 금지(classDef만 사용) 같은 다크모드 호환 규칙까지 챙깁니다.
이런 분께 추천
- 연구 보고서·논문·분석 문서를 자주 쓰는 연구자, 대학원생
- README·설계 문서·ADR을 git으로 관리하는 개발자
- 다이어그램을 매번 이미지로 만들다 수정 지옥을 겪은 분
- 팀 문서 스타일을 통일하고 싶은 테크 라이터
활용 예시
- "실험 파이프라인을 문서로 정리해줘" → 연구 보고서 템플릿에 플로우차트 + 시퀀스 다이어그램을 삽입한
.md생성. - "이번 아키텍처 결정을 기록해줘" →
decision_record템플릿 기반 ADR에 C4 또는 블록 다이어그램 첨부. - "논문 리뷰 결과를 개념도로 보여줘" → 마인드맵으로 문헌 지형도, 타임라인으로 발표 연도 흐름 정리.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 K-Dense-AI/scientific-agent-skills 의 skills/markdown-mermaid-writing 폴더를 내 ~/.claude/skills/markdown-mermaid-writing/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/sas && mkdir -p ~/.claude/skills && cp -r /tmp/sas/skills/markdown-mermaid-writing ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 임시 폴더에 내려받습니다:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/sas - 스킬 폴더가 없다면 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 통째로 복사합니다(하위
references/,templates/,assets/가 함께 복사되어야 합니다):cp -r /tmp/sas/skills/markdown-mermaid-writing ~/.claude/skills/ - 복사 확인:
ls ~/.claude/skills/markdown-mermaid-writing - Claude Code를 재시작한 뒤 "이 내용을 마크다운 문서와 Mermaid 다이어그램으로 정리해줘"라고 요청하면 스킬이 활성화됩니다.
- (선택)
/tmp/sas임시 폴더는 삭제해도 됩니다.
GitHub에서 원본 보기 ↗라이선스: MIT