yjz211/vivid-figures-skill

让 AI 用你的数据生成科研图表：108 个配方，鲜艳与稳重两种风格，多套配色，交付图片与源码。仅限个人非商业使用。

무엇인가요

Vivid Figures 는 Agent Skill 입니다. 데이터 기반의 차트 템플릿과 색상 팔레트의 모음으로, AI 어시스턴트가 과학적 그림을 자동으로 생성하는 데 사용할 수 있습니다. 리포지토리는 다음을 포함합니다:

143개의 완성된 차트 "레시피" (예: 리지 플롯, 히트맵, 3D 그룹 바 차트, SHAP 중요도 시각화 등)
7개의 색상 팔레트 팩 (각 팩에 5~8개의 색상)을 하나의 JSON 파일에 저장
레시피를 읽고 사용자의 CSV/Excel/JSON 데이터를 로드하며, 적절한 차트 유형을 선택하고, 그림을 렌더링하며, PNG, PDF 및 재현 가능한 소스 스크립트를 출력하는 Python 코드

이 스킬은 Agent Skills 오픈 사양을 따르므로, 파일을 읽고 Python을 실행하며 이미지를 표시할 수 있는 모든 AI 어시스턴트 플랫폼에 쉽게 통합할 수 있습니다.

누구를 위한가요

논문, 경진대회 보고서, 모델링 노트북을 작성하는 연구자.
원시 데이터(표, 모델 출력, 공간 좌표 등)를 보유하고 있지만, 차트 유형을 수동으로 선택하거나 색상을 조정하고 싶지 않은 사람.
Agent Skills 형식을 지원하는 AI 어시스턴트 (예: Claude 기반 봇, OpenAI 함수 호출 에이전트, 또는 커스텀 "어시스턴트 앤드어서비스" 도구).

작동 방식 (개요)

스킬 로드 – 어시스턴트가 vivid-figures-skill 폴더 전체를 가져옵니다.

사용자 프롬프트 – 원하는 것을 말합니다. 예:

vivid-figures-skill로 results.csv를 읽고, 다양한 방법의 점수 분포를 비교해줘. 코랄 그린 색상 팔레트를 사용해.

데이터 파싱 – Python 헬퍼가 CSV/Excel 파일을 읽고, 컬럼의 의미를 추론하여 차트 템플릿과 매칭합니다.
템플릿 선택 – 데이터의 형태와 사용자의 의도에 따라 143개의 레시피 카드 중 하나를 선택합니다 (각 카드에는 마크다운 설명, 미리보기 이미지, 전체 소스 코드가 포함되어 있습니다).
렌더링 – 관련 Python 스크립트가 실행되어, 빠른 미리보기용 PNG, 출판용 PDF, 그리고 나중에 편집할 수 있는 전체 소스 코드 (Matplotlib/Seaborn/Plotly 등)를 생성합니다.
후처리 – 어시스턴트는 지시에 따라 범례, 폰트 크기, 요소 위치를 조정할 수 있으며, 원래의 색상 팔레트와 디자인 의도를 유지합니다.

주요 기능

풍부한 차트 레시피 라이브러리 – 기본 플롯(산점도, 바이올린 플롯, 히스토그램)부터 고급 시각화(3D 그룹 바, 다중 Y축 그라디언트 히스토그램, SHAP 종속성 및 기여 맵, 리프레시 스타일 상관 히트맵)까지 커버합니다.
7개의 큐레이션된 색상 팔레트 – 각 팔레트는 JSON 파일입니다. 기본은 Olive-Apricot이지만, 간단한 자연어 명령으로 어떤 팔레트든 선택 가능합니다.
오픈 Agent-Skill 형식 – SKILL.md (YAML + 마크다운)에 메타데이터가 포함되어 있으며, 모든 자산은 상대 경로로 참조되어, 다양한 AI 어시스턴트 호스트 간에 이식 가능합니다.
출력 유연성 – 빠른 확인용 PNG, LaTeX/Word 삽입용 PDF, 그리고 사용자가 나중에 재현하거나 수정할 수 있는 정확한 Python 소스 코드 제공.
비영리, 개인 사용 라이선스 – 학술 또는 개인 프로젝트에서는 무료이지만, 서면 허가 없이 상업적 재배포는 금지됩니다.
자기 검증 기능 – 각 템플릿에는 "정확도 포인트"가 포함되어 있어, 어시스턴트가 (예: 그라디언트 유지, 레이어 순서 유지)를 검증할 수 있어 디자인의 과도한 단순화를 방지합니다.

시작하기 (빠른 체크리스트)

사전 요구 사항 – Python 3.10+, Git, Bash (Windows에서는 Git Bash). 옵션: 로컬에서 HTML 카탈로그를 브라우저할 경우 Node.js 22+ 필요.
설치 – docs/INSTALL.md를 따르세요 (리포지토리 클론 후 pip install -r requirements.txt 실행).
AI 어시스턴트에 로드 – 어시스턴트가 Agent Skills를 기대하는 폴더에 폴더를 배치하거나, 호스트 전용 임포트 명령어를 사용합니다.
프롬프트 실행 – README에 나와 있는 대로, 어시스턴트에게 데이터 파일에서 그림을 생성하도록 요청합니다.
결과 확인 – 어시스턴트가 figures/ 디렉터리를 생성하여 PNG, PDF, Python 스크립트를 포함합니다.

유용하지 않을 경우

143개의 템플릿으로 커버되지 않는 완전히 커스텀 시각화가 필요한 경우, 여전히 직접 코드를 작성해야 합니다.
이 스킬은 Python을 실행하고 이미지를 표시할 수 있는 AI 어시스턴트를 대상으로 설계되었습니다. LLM이 없는 단순 CLI 도구는 선택 로직을 제어할 수 없습니다.
상업적 사용은 별도 라이선스 없이 금지됩니다.

결론

Vivid Figures는 즉시 사용 가능한 AI 주도의 차트 생성 스킬로, 언어 모델이 최소한의 프롬프트로 원시 데이터를 출판 수준의 그림으로 변환할 수 있게 해줍니다. 풍부한 사전 테스트된 템플릿, 색상 팔레트, 재현 가능한 Python 파이프라인을 오픈된 Agent Skills 사양에 포장하여 제공합니다.