excel-to-json

name	excel_to_json
description	엑셀 파일(.xlsx)을 읽어 JSON 포맷으로 변환하는 스킬입니다.

excel_to_json 스킬

이 스킬은 제공된 엑셀 파일(.xlsx)의 첫 번째 시트 구조를 파악하고, 첫 번째 행을 키(Key)값으로 사용하여 나머지 데이터를 JSON 리스트 형태로 변환합니다. 변환된 JSON 파일은 한글이 깨지지 않도록 UTF-8 인코딩으로 저장됩니다.

⚠️ 필수 요구 사항 및 인코딩 설정

터미널(cmd)에서 이 스킬을 실행할 때 발생하는 유니코드 인코딩 오류(UnicodeEncodeError)를 방지하고 한글을 정상적으로 출력/저장하기 위해 반드시 아래 명령어를 사용하여 실행 환경을 UTF-8로 설정해야 합니다.

실행 명령어에 chcp 65001을 포함시키거나 실행 전에 코드 페이지를 변경하십시오.

cmd /c "chcp 65001 && set PYTHONIOENCODING=utf-8 && python c:\Users\USER\.gemini\antigravity\skills\excel_to_json\scripts\excel_to_json.py <엑셀파일경로> [-o <출력JSON경로>]"

사용 방법

• 기본 형식 (출력 파일명 자동 지정): 입력된 엑셀 파일명과 동일한 이름의 .json 파일이 같은 디렉토리에 자동으로 생성됩니다.

  cmd /c "chcp 65001 && set PYTHONIOENCODING=utf-8 && python c:\Users\USER\.gemini\antigravity\skills\excel_to_json\scripts\excel_to_json.py c:\Path\To\Input.xlsx"
  

• 출력 경로 직접 지정 옵션 (-o 또는 --output): 생성될 JSON 파일의 이름과 저장 경로를 직접 지정할 수 있습니다.

  cmd /c "chcp 65001 && set PYTHONIOENCODING=utf-8 && python c:\Users\USER\.gemini\antigravity\skills\excel_to_json\scripts\excel_to_json.py c:\Path\To\Input.xlsx -o c:\Path\To\Output.json"
  

스크립트 위치 및 구조

• 메인 파이썬 스크립트: c:\Users\USER\.gemini\antigravity\skills\excel_to_json\scripts\excel_to_json.py