Unity Uitoolkit Add Tutorial

unity-uitoolkit-add-tutorial

*한국어 · [English](README.en.md)*

Unity UIToolkit 기반 **EditorWindow** 또는 **CustomEditor 인스펙터**에 첫 실행 시 자동으로 표시되는 **패시브 코치마크 튜토리얼**을 추가하는 [Claude Code](https://claude.com/claude-code) 스킬입니다.

대상 `.cs` 파일 하나를 지정하면 다음을 자동으로 수행합니다.

• 같은 폴더에 {ClassName}Tutorial.cs 오버레이 클래스를 생성
• 대상 클래스에 RestartTutorial(), BuildTutorialSteps() 메서드를 주입
• 상단 Toolbar(EditorWindow) 또는 인스펙터 헤더 행(CustomEditor) 우측에 "튜토리얼" 버튼을 배치
• 진입점 끝에 ShowIfNeeded(...) 호출을 삽입해 첫 실행 시 한 번만 자동 표시
• UI 요소를 분석해 4~7개의 단계 초안을 생성 (문구는 검토용 초안)

결과물 미리보기


*SVN 보조 창에 추가한 튜토리얼의 3번째 단계입니다. 리비전 필드를 강조하고 그 의미를 툴팁으로 설명합니다.*

생성되는 튜토리얼은 다음처럼 동작합니다.

• 반투명 검은 오버레이가 창 전체를 덮어 입력을 차단합니다 (패시브).
• 현재 단계의 대상 요소를 노란 테두리로 강조하고, 그 옆에 툴팁을 배치합니다.
• 툴팁에는 Step n / N, 제목, 설명, 자동 진행 타이머, 건너뛰기 / 이전 / 다음 버튼이 있습니다.
• 각 단계는 8초 후 자동으로 다음 단계로 넘어갑니다.
• 완료 또는 건너뛰기 시 EditorPrefs 에 기록되어 다시 자동 표시되지 않습니다. "튜토리얼" 버튼으로는 언제든 재실행할 수 있습니다.

요구 사항

항목	내용
Claude Code	스킬(SKILL.md)을 지원하는 버전
Unity	UIToolkit 에디터 API(UnityEditor.UIElements)를 지원하는 버전. Unity 6 (6000.3) 에서 사용 중이며, 2021.3 LTS 이상이면 동작할 것으로 예상하나 그 외 버전은 검증하지 않았습니다
대상 도구	CreateGUI() / CreateInspectorGUI() 로 UIToolkit 트리를 구성하는 도구. IMGUI 전용(OnGUI / OnInspectorGUI 만 있는 경우)은 대상이 아닙니다

설치

Claude Code는 `.claude/skills/<스킬명>/SKILL.md` 를 스킬로 인식합니다. 이 저장소는 루트에 `SKILL.md` 가 있으므로 폴더째로 그 위치에 두면 됩니다.

프로젝트 로컬 설치

git clone https://github.com/ez8801/unity-uitoolkit-add-tutorial.git .claude/skills/unity-uitoolkit-add-tutorial

전역 설치 (모든 프로젝트에서 사용)

git clone https://github.com/ez8801/unity-uitoolkit-add-tutorial.git ~/.claude/skills/unity-uitoolkit-add-tutorial

Windows PowerShell 에서는 `~` 대신 `$env:USERPROFILE` 을 사용합니다.

수동 복사

`SKILL.md` 와 `templates/` 두 항목만 있어도 동작합니다. `examples/` 는 스킬이 패턴을 참고하는 용도이므로 함께 두는 것을 권장합니다.

사용법

Claude Code 세션에서 대상 파일 경로 또는 클래스명을 넘겨 호출합니