1. 저장소 전체와 Skill 하나는 다릅니다

GitHub 저장소는 여러 파일을 묶어 관리하는 공간입니다. README에는 프로젝트 소개가, 파일 목록에는 코드와 자료가, 변경 기록에는 수정 내역이 있습니다. Skill 저장소에도 여러 Skill, 설치 도구, 문서, 테스트가 함께 들어 있는 경우가 많습니다. GitHub 화면을 처음 본다면 「위니브 Skill 모음」 교안의 GitHub 소개를 먼저 읽으세요.

1.1 파일을 보는 순서

먼저 README에서 목적과 지원 환경을 확인하고 Skill 파일이 있는 위치로 이동합니다. 그다음 SKILL.md에서 연결한 자료를 따라갑니다. 실행 스크립트가 있다면 어떤 입력을 읽고 어떤 파일을 쓰는지 확인합니다. 마지막으로 라이선스와 변경 기록을 읽습니다.

스크립트를 읽기 어렵다면 Claude에게 읽기만 요청할 수 있습니다.

첨부한 외부 Skill을 설치하거나 실행하지 말고 구조를 설명해줘.
입력 파일, 출력 파일, 외부 네트워크 요청, 추가 패키지,
파일 삭제·외부 전송 동작이 있는 위치를 파일 경로와 함께 정리해줘.
README의 주장과 실제 코드에서 확인한 사실을 구분해줘.

위험을 자동으로 판정해 달라는 요청이 아니라 코드 검토를 돕는 요청입니다. “문제없다”는 한 줄 답변 대신 근거 위치를 확인하세요.

1.2 내려받은 ZIP 점검

GitHub의 저장소 ZIP에는 보통 저장소 이름을 가진 바깥 폴더가 있고, 그 아래 skills/meeting-minutes 같은 경로가 있습니다. 이것을 그대로 Claude의 Skill 등록 화면에 올리면 하나의 Skill 폴더를 기대하는 형식과 맞지 않습니다.

필요한 Skill 폴더를 찾고 그 안의 SKILL.md와 실제 참조 자료를 함께 묶습니다. 단, 상위 디렉터리의 공통 스크립트를 참조하는 프로젝트라면 폴더 하나만 떼어서는 작동하지 않습니다. 상대 경로와 설치 문서를 먼저 확인하세요.

1.3 버전은 이름보다 구체적으로 남기기

“어제 받은 최신 버전”만 적으면 다시 재현할 수 없습니다. 저장소 주소, 커밋 식별자나 릴리스 태그, 확인일, 설치한 파일의 이름을 기록합니다. 같은 이름의 Skill도 업데이트 뒤에는 결과가 달라질 수 있습니다.

로컬에서 고쳤다면 원본 버전과 수정 사항을 나눠 기록하세요. 원본을 덮어쓴 뒤 무엇을 바꿨는지 기억에만 의존하면 업데이트할 때 수정이 사라집니다.

1.4 공개와 재배포를 구분하기

웹에서 읽을 수 있다는 것과 내 교재 ZIP에 넣어 나눠 줄 수 있다는 것은 다릅니다. 저장소 전체와 하위 폴더의 라이선스가 다른 경우도 있습니다. 이 책의 외부 사례는 링크와 설계 관찰 대상으로만 제공하며, 저자 표시와 재배포 조건은 해당 프로젝트의 문서에서 확인합니다.

실습 산출물은 내려받은 파일이 아니라 “어느 버전에서 무엇을 확인했고 어떤 폴더가 필요한가”를 적은 검토 메모입니다.