markdown-viewer/skills

해결하는 문제

이 프로젝트는 AI 에이전트(Claude Code, Cursor, GitHub Copilot 등)가 아키텍처 다이어그램, 차트, 인포그래픽과 같은 고품질의 전문적인 시각 자료를 Markdown 내에서 직접 생성할 수 있도록 돕는 일련의 "스킬"을 제공합니다. 이는 에이전트의 텍스트 작성 능력과 특정 렌더링 엔진을 사용하여 구조화된 시각적 문서를 생성하는 능력 사이의 간극을 메워줍니다.

작동 방식

이 프로젝트는 Agent Skills 형식을 따르는 스킬 패키지(documd-visuals)로 구성되어 있습니다. 이는 라우터 역할을 하여 AI 에이전트를 31개의 서로 다른 목표 도메인(예: 소프트웨어 설계, 클라우드 아키텍처, 비즈니스 보고)과 183개의 시나리오로 안내합니다.

에이전트가 요청을 받으면 SKILL.md 라우터를 사용하여 사용자의 의도를 특정 목표 도메인과 일치시킨 다음, 시나리오에 따라 적절한 렌더링 엔진을 선택합니다:

• PlantUML/puml: UML, ArchiMate, BPMN 및 네트워크/보안 아키텍처용.
• Vega/Vega-Lite: 통계 변환이 포함된 데이터 기반 차트용.
• ECharts: 보고서 수준의 대시보드 및 게이지용.
• Infographic: 템플릿 기반의 로드맵 및 비교용.
• HTML/CSS: 시스템 아키텍처 다이어그램 및 페이지 레이아웃용.

또한 이러한 Markdown 기반 시각 자료를 PDF, DOCX 또는 SVG와 같은 완성된 파일로 내보낼 수 있는 선택적 documd CLI 도구도 제공됩니다.

대상 사용자

• AI 에이전트 사용자: 코딩 에이전트를 사용하여 기술 문서를 생성하는 사용자.
• 테크니컬 라이터: 버전 관리를 용이하게 하기 위해 시각 자료를 Markdown 내의 텍스트로 유지하려는 사람.
• 개발자: AI를 통해 복잡한 시스템 다이어그램과 아키텍처 맵을 신속하게 생성해야 하는 엔지니어.

주요 특징

• 방대한 라이브러리: 31개 목표 도메인에 걸쳐 242개의 검증된 예제가 포함되어 있습니다.
• 에이전트 준비 완료: npx skills add를 통해 AI 코딩 에이전트와 통합되도록 특별히 설계되었습니다.
• 멀티 엔진 지원: UML부터 인포그래픽까지 모든 것을 다루는 5개의 서로 다른 렌더링 엔진을 통합합니다.
• 테마 스타일링: 시각적 일관성과 대비를 보장하기 위해 9개의 서로 다른 테마를 지원합니다.
• 내보내기 기능: Markdown 시각 자료를 전문적인 문서 형식으로 변환하기 위한 CLI를 제공합니다.