VisActor/skills

VisActor / skills – AI 에이전트를 위한 플러그인 "스킬"

개요 – 언어 모델 기반 에이전트(예: Codex, Claude Code 또는 도구 사용이 가능한 호환 에이전트)가 원시 데이터 파일을 시각적 결과물로 변환할 수 있게 해주는 3가지 에이전트 스킬 모음입니다:

스킬	기능	일반적인 출력
vchart-skill	VChart 차트 생성, 구성 문제 진단, 차트 이미지 복제, 즉시 사용 가능한 React 컴포넌트 제공.	브라우저에서 인터랙티브 차트를 렌더링하는 JavaScript/HTML.
vtable-skill	정렬 가능한 테이블, 피벗 테이블 및 피벗 차트 구축, 인터랙티브 동작 추가, 구성 오류 감지.	검색 및 정렬 가능한 테이블 또는 피벗 차트용 HTML/JS.
data-storytelling	데이터 분석 수행, 내러티브 설계, 스크롤텔링 페이지 및 "Web-PPT" 프레젠테이션 생성.	독립형 HTML 스토리 또는 브라우저 기반 프레젠테이션(`.pptx` 파일 없음).

이 세 가지 스킬은 모두 완전히 로컬에서 작동하며, 필요한 템플릿, 스크립트 및 참조 파일이 포함되어 있습니다. 별도의 VisActor 서버, API 키 또는 호스팅 서비스가 필요하지 않으며, 호스트 에이전트가 LLM 모델과 셸/FS 명령 실행 기능을 제공합니다.

프로젝트에 스킬을 추가하는 방법

# 필요한 스킬 선택
npx skills add VisActor/skills --skill vchart-skill
npx skills add VisActor/skills --skill vtable-skill
npx skills add VisActor/skills --skill data-storytelling

설치 프로그램은 Codex를 사용하는지 Claude Code를 사용하는지 묻고, 스킬 디렉토리(SKILL.md, 템플릿, Python/JS 헬퍼 스크립트 포함)를 에이전트의 스킬 폴더로 복사합니다.

전제 조건

Node ≥ 14 및 npm (npx skills CLI용).
모델을 호출할 수 있는 파일 시스템 지원 에이전트.
VChart/VTable용 Python 3.9+; data-storytelling용 Python 3.10+ 및 Node.js(Python 부분은 표준 라이브러리만 사용).
인터넷 접속이 가능한 최신 브라우저 – 생성된 페이지는 VChart/VTable, React, Monaco, VSeed, GSAP 등을 공개 unpkg CDN에서 가져옵니다.

스킬 사용 방법

설치 후 에이전트에게 데이터와 함께 스킬을 실행하도록 요청하기만 하면 됩니다. 예:

"VChart를 사용하여 이 CSV의 지역별 및 분기별 매출을 비교해 줘. 편집 가능한 소스와 HTML을 줘."

"VTable을 사용하여 이 파일의 모든 행을 사용하는 정렬 가능한 상세 테이블을 만들어 줘."

"data-storytelling을 사용하여 이 CSV의 유지율 변화를 성장 담당자에게 설명하는 공유 가능한 HTML 스토리를 만들어 줘."

에이전트는 다음을 수행합니다:

CSV(또는 기타 지원되는 파일)를 로드합니다.
적절한 스킬 스크립트를 호출하여 차트/테이블/스토리를 생성합니다.
생성된 소스 코드(HTML/JS)를 반환하고, 가능한 경우 렌더링된 미리보기를 제공합니다.

출력은 실행 가능한 JavaScript/HTML이며 로컬에서 열 수 있습니다. 저장소에서는 평가용 브라우저가 신뢰할 수 없는 코드를 위한 샌드박스가 아님을 명시하고 있습니다. 생성된 결과물은 실행하기 전에 검토해야 합니다.

개발 및 테스트 (기여자용)

주요 개발 브랜치는 develop입니다.
체크아웃에서 로컬 설치 시 npx skills add ./skills/<skill>을 사용합니다.
테스트는 Python 3.12+에서 uv(빠른 패키지 관리자)를 사용하여 실행됩니다:
```
uv sync --locked
uv run pytest tests -q
uv run ruff check skills tests evals/scripts
```
브라우저 스모크 테스트 세트가 evals/smoke/에 있으며, 각 스킬이 예상되는 시각적 출력을 생성하는지 확인합니다.
더 깊은 디버깅을 위해 선택적인 model-API harness(OpenAI 호환 Chat Completion)를 사용하여 Codex/Claude 없이 고정된 사례를 실행할 수 있습니다. 이는 유지 관리자를 위한 것이며 최종 사용자를 위한 것이 아니며 API 비용이 발생할 수 있습니다.

릴리스 모델

세 가지 스킬 모두 단일 저장소 버전을 공유합니다. Git 태그는 스킬 지침, 참조 파일, 템플릿 및 스크립트가 포함된 공식 릴리스를 표시합니다. 개별 라이브러리(예: VTable 1.26.8)는 별도로 버전이 관리되며 스킬 메타데이터에서 참조됩니다.

라이선스

MIT – 스킬을 자유롭게 사용, 수정 및 재배포할 수 있습니다.

요약

VisActor/skills는 LLM 기반 에이전트가 데이터 파일을 인터랙티브 차트, 테이블 및 내러티브 HTML 스토리로 변환할 수 있는 능력을 갖추게 하는 실제 설치 가능한 툴킷입니다. 독점적인 백엔드 없이 데이터 시각화 및 스토리텔링 기능이 내장된 AI 에이전트를 구축하려는 개발자를 대상으로 합니다.