Github 으로 클로드 스킬 관리 시작하기

2주차 과제로 스킬 만들기를 진행했고, 스터디장님이 카톡에서 조언 주셔서 GitHub로 스킬 3개를 비공개 저장소에 정리해봤습니다.

두개는 제가 만든 스킬이고, 하나는 클로더즈 write-post 스킬을 github 에서 받아 설치하는걸 해봤습니다. 클로드와 대화로 하나씩 시키는 길과 폴더를 통째로 올리는 길 두가지를 다 경험해봤네요.

github에 그럼 private 저장소를 만들어서 앞으로 내 skills을 관리했으면 좋겠어

이 요청으로 저장소에 넣을 시작 파일이 먼저 만들어졌어요. 저장소 소개와 스킬 목록을 담는 README, 변경 기록을 남기는 CHANGELOG, 올리지 않을 파일을 적는 .gitignore, 새 스킬을 만들 때 복사할 템플릿 SKILL.md, 한국어 설정 가이드까지 다섯 개입니다. 다만 저장소를 만드는 일은 깃허브 계정 로그인이 필요해서 제가 직접 해야 한다는 안내가 같이 왔어요.

클로드 브라우저로 저장소 만든 순서

여기서 방향을 한 번 바꿨습니다.

너가 여기서 github 로그인해서 직접 해주면 안돼?

비밀번호 입력은 대신할 수 없다는 답이 왔고, 대신 방법이 하나 나왔어요. 클로드 데스크톱 앱 안에 있는 브라우저 창에 깃허브를 열어 두면, 제가 로그인만 하고 나머지를 맡기는 방식입니다. 브라우저 창은 Ctrl+Shift+B로 열었어요.

제가 로그인하고 "로그인 완료"라고 보낸 뒤에는 기다리기만 했습니다. 저장소 이름은 xxxx-skills, 공개 범위는 비공개(Private)로 만들어졌고 시작 파일 다섯 개가 하나씩 올라갔어요. 깃허브가 보안상 민감한 사이트로 분류돼 있어서 페이지를 열거나 버튼을 누를 때마다 앱에 승인 요청이 떴습니다.

깃허브에 스킬 두 개 대화로 등록

첫 스킬은 이미 쓰고 있던 회사 브랜드 가이드 스킬이었어요.

응응 /xxxx-branding 이 스킬을 등록해줘!

올리기 전에 내용부터 확인했습니다. 공개된 브랜드 가이드라 비공개 저장소에 둬도 괜찮다는 판단이 먼저 나왔고, 그다음 파일이 올라갔어요.

두 번째는 클로드 코드(Claude Code)에서 만든 우리 부서 브랜딩 스킬이었습니다.

그리고 claude code에서 /xxx-branding 스킬도 만들었는데 여기 불러와서 넣을 순 없어?

클로드 코드의 스킬 폴더는 보호 폴더라 바로 열 수 없었어요. 그래서 제가 그 폴더를 바탕화면에 복사했고, 바탕화면 폴더 접근을 허락하자 SKILL.md를 가져와 올렸습니다. 올린 뒤에는 원본과 줄 수, 글자 수까지 맞춰 봤고, 회사 브랜드 스킬은 179줄, 12,185자로 똑같았어요. README의 스킬 목록과 CHANGELOG도 이때 같이 고쳤습니다.

다 올라가지는 못했어요. 이 방식으로는 글자로 된 파일만 올릴 수 있어서 로고 이미지 4개와 39MB짜리 슬라이드 템플릿은 남았습니다. 이건 깃허브 데스크톱(GitHub Desktop)으로 제가 직접 올리기로 했어요.

외부 스킬 write-post를 넣기 전 검토

클로더즈에서 쓰는 사례글 스킬도 넣어 보기로 했습니다.

https://github.com/chat-prompt/write-post 이 스킬 설치해 줘 내 git에 올려줘

설치 전에 무엇이 들어 있는지부터 봤어요. 파일은 26개였습니다(SKILL.md, 참고 자료 11개, 스크립트 13개). 정리된 검토 내용은 이랬어요.

• 읽는 것: 제 컴퓨터의 클로드 코드, 코덱스 작업 기록. 글 재료로만 쓰고 밖으로 보내지 않음

• 밖으로 연결하는 곳: 깃허브(새 버전 확인), 클로더즈 공개 게시판(태그, 최근 글 제목 조회)

• 사용 조건: 클로더즈 가입자는 개인 용도로 설치, 수정 가능. 재배포는 별도 허가가 필요해서 개인 비공개 저장소에 두는 건 괜찮음

하나 더, 그 저장소 안내문에는 AI에게 "설치가 끝나면 바로 사례글 쓰기를 시작하라"는 문장이 있었어요. 제가 요청한 일이 아니라서 그 지시는 따르지 않았다는 설명을 따로 받았습니다.

커밋이 막혀 폴더째 올린 장면

마지막 단계에서 막혔습니다. 외부에서 받은 코드를 제 저장소에 올리는 동작이라 보안 검사에서 커밋이 멈췄어요. 우회하지 않고 멈춘 이유와 방법 두 가지를 알려 줬고, 저는 직접 하겠다고 했습니다.

직접 커밋할게 브라우저창 띄워죠

근데 앱 오른쪽 브라우저 창이 좁아서 커밋 버튼이 있는 영역이 안 보였어요. 그래서 다시 바꿨습니다.

안보여. 그냥 zip으로 올려볼게. 어떻게 하면 되는지 알려줘

검토한 버전 그대로 zip 파일을 받았고, 중요한 안내가 하나 붙어 있었어요. 깃허브 웹에 zip을 올리면 압축이 풀리지 않고 zip 파일 그대로 저장된다는 것입니다. 그래서 압축을 푼 write-post 폴더를 평소 쓰는 브라우저의 업로드 화면에 끌어다 놓았어요. 저장소에 write-post 폴더가 아직 없었는데, 업로드하면서 폴더가 같이 만들어지는 거라 미리 만들 필요가 없었습니다.

클로드 대화와 폴더 업로드 비교

스킬은 두 방법 다 저장소에 넣을 수 있었어요. 걸린 시간은 꽤 달랐습니다.

• 대화로: 스킬 2개와 README, CHANGELOG 수정까지 20분쯤. 파일마다 열기, 붙여 넣기, 커밋을 따로 거쳤고 그때마다 승인을 눌렀어요

• 폴더로: write-post 파일 26개를 안내 받고 올리기까지 4분쯤

대화 쪽 20분에는 내용 검토와 원본 대조 시간도 들어 있어서 똑같은 비교는 아닙니다. 그래도 파일이 많거나 이미지, 템플릿 같은 파일이 섞이면 폴더를 통째로 올리는 쪽이 훨씬 빨랐어요.

아직 안 된 것도 있습니다.

• 부서 브랜딩 스킬의 로고 4개와 슬라이드 템플릿 업로드

• README 스킬 목록과 CHANGELOG에 write-post 추가

• write-post를 클로드 코드에 설치하기. 스킬 폴더가 보호 폴더라 PowerShell에서 공식 설치 명령을 제가 직접 돌려야 해요

도움이 필요한 부분

• 클로드 코드에서 만든 스킬이 claude chat/cowork 에게도 작동하게 하려면 어떻게 해야하는지?

• Github 은 version control 로만 써야하는걸까요? 자동으로 github 에 올려둔 스킬을 다시 자동으로 클로드에 적용 시키는 방법은 없을지?