Communitygithub.com

XuToWei/Image-To-UI

게임 UI 스크린샷과 슬라이스된 스프라이트를 ui_structure.json으로 변환하는 Image-to-UI Codex 스킬입니다.

Image-To-UI란 무엇인가요?

이 스킬은 게임 개발자와 AI 에이전트(특히 Codex)가 게임 UI 스크린샷과 슬라이스된 스프라이트 이미지를 구조화된 JSON 데이터(ui_structure.json)로 변환할 수 있도록 지원합니다. 주로 게임 UI 프로토타이핑, 자동화된 UI 분석, 또는 디자인 시스템 추출에 유용합니다. 입력되는 이미지에서 UI 요소(버튼, 패널, 아이콘 등)를 인식하고, 각 요소의 위치, 크기, 텍스트, 스타일 정보를 추출하여 계층적인 구조로 표현합니다. Codex 플랫폼에서 동작하며, AI가 이미지 처리와 JSON 스키마 생성을 자동으로 수행합니다. 이 스킬을 사용하면 수동으로 UI 구조를 분석하고 문서화하는 번거로움을 줄이고, 게임 UI 관련 작업의 생산성을 크게 향상시킬 수 있습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add XuToWei/Image-To-UI

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Image-To-UI은(는) 무엇을 하나요?

Image-to-UI Codex 스킬: 게임 UI 스크린샷과 슬라이스된 스프라이트를 ui_structure.json으로 변환합니다.

개요

이 스킬은 게임 UI 이미지를 분석하여 구조화된 JSON 데이터로 변환합니다. 개발자는 이를 통해 게임 UI의 레이아웃과 구성 요소를 빠르게 파악하고, 자동화된 UI 생성 또는 분석 파이프라인에 활용할 수 있습니다.

주요 기능

  • UI 요소 인식: 버튼, 패널, 아이콘, 텍스트 등 다양한 UI 요소를 이미지에서 식별합니다.
  • 위치 및 크기 추출: 각 요소의 좌표(x, y)와 너비, 높이를 계산합니다.
  • 텍스트 인식: OCR을 통해 UI 내 텍스트 콘텐츠를 추출합니다.
  • 계층 구조 생성: 요소 간의 부모-자식 관계를 분석하여 트리 구조를 만듭니다.
  • JSON 출력: 표준화된 ui_structure.json 형식으로 결과를 제공합니다.

사용 방법

  1. 게임 UI 스크린샷 또는 슬라이스된 스프라이트 이미지를 준비합니다.
  2. Codex 환경에서 다음 명령어를 실행합니다:
codex run "이미지를 ui_structure.json으로 변환해줘"

또는 이미지 파일을 직접 업로드하고 프롬프트를 작성합니다.

지원 형식

  • 입력: PNG, JPEG, WebP
  • 출력: JSON (ui_structure.json)

JSON 스키마 예시

{
  "ui_version": "1.0",
  "elements": [
    {
      "type": "button",
      "id": "btn_start",
      "x": 100,
      "y": 200,
      "width": 150,
      "height": 50,
      "text": "시작",
      "children": []
    }
  ]
}

참고 사항

  • 이미지 품질이 좋을수록 인식 정확도가 높아집니다.
  • 슬라이스된 스프라이트는 개별 파일로 제공해야 합니다.
  • 복잡한 UI는 여러 번의 분석이 필요할 수 있습니다.

라이선스

이 스킬은 오픈 소스로 제공되며, 사용 시 원저작자를 표기해야 합니다.

관련 스킬