스킬 원클릭 설치 — $skill-installer로 공식 카탈로그에서 한 줄

학습목표 / 사전지식: 이 레슨의 목표는 $skill-installer를 불러 공식 카탈로그에서 Skills를 한 줄로 설치하고, 설치한 Skills가 어느 위치의 설정보다 먼저 읽히는지 확인하는 것이다. [KO-05, OF-08]

사전지식은 없어도 된다. [KO-05, OF-08] 이 수업에서는 Skills를 “코덱스에게 특정 일을 더 잘하게 만드는 작업 레시피”로, 카탈로그를 “가져다 쓸 수 있는 레시피 진열대”로, 저장 우선순위를 “같은 이름의 레시피가 여러 장 있을 때 어떤 장을 먼저 펼칠지 정하는 순서”로 읽는다. [KO-05, OF-08]

1. 왜 필요한가 — 개념·배경을 초보자 눈높이로

비개발자에게 Skills 설치가 중요한 이유는 길게 설정 파일을 만지지 않고도 필요한 작업 방식을 코덱스에 더할 수 있기 때문이다. [KO-05] Skills는 $skill-installer 한 줄로 공식 카탈로그에서 원클릭 설치할 수 있으며, 이 장의 핵심 문장은 “모든 스킬은 Codex에서 한 줄이면 설치돼요”이다. [KO-05]

Skills를 사람에 빗대면 “업무 매뉴얼을 미리 읽어 둔 조수”에 가깝다. [KO-05] 회의록 정리, 문서 작성, 코드 점검처럼 반복되는 일을 매번 길게 설명하는 대신, 그 일을 맡을 Skills를 설치해 불러오는 흐름이라고 보면 된다. [KO-05]

설치 다음에 꼭 봐야 할 것은 저장 우선순위다. [OF-08] 스킬 저장 우선순위는 CWD -> REPO_ROOT -> HOME -> /etc/codex -> 번들이며, 같은 이름의 Skills가 여러 위치에 있을 때 이 순서가 앞선 쪽이 먼저 고려된다고 이해하면 된다. [OF-08]

어려운 용어를 먼저 풀면, CWD는 지금 작업 중인 폴더, REPO_ROOT는 프로젝트의 뿌리 폴더, HOME은 사용자 개인 폴더, /etc/codex는 시스템 쪽 코덱스 폴더, 번들은 코덱스에 함께 들어 있는 기본 묶음이라고 읽으면 된다. [OF-08]

2. 준비 — 코덱스 어디로 들어가 무엇을 누르나

이 실습은 코덱스의 입력 줄에 $skill-installer를 쓰는 장면에서 시작한다. [KO-05] Skills는 $skill-installer 한 줄로 공식 카탈로그에서 원클릭 설치할 수 있으므로, 촬영 화면은 “입력한다, 목록을 본다, 한 줄로 설치한다, 우선순위를 확인한다”의 네 장면으로 구성한다. [KO-05, OF-08]

화면에는 세 가지가 보이면 충분하다. [KO-05, OF-08] 첫째는 $skill-installer를 입력할 수 있는 코덱스 입력 줄이고, 둘째는 공식 카탈로그에서 고를 Skills 이름이며, 셋째는 CWD -> REPO_ROOT -> HOME -> /etc/codex -> 번들 순서가 적힌 확인 메모다. [KO-05, OF-08]

3. 따라하기 — 단계별로 아주 세세하게

1단계에서는 공식 카탈로그를 먼저 보겠다고 요청한다. [KO-05] 입력 줄에 아래 문장을 붙여넣으면, 촬영 흐름상 $skill-installer를 호출해 설치 가능한 Skills를 찾는 장면이 된다. [KO-05]

$skill-installer
공식 카탈로그에서 설치할 수 있는 Skills를 보여줘.

화면에서 기대할 것은 “설치할 후보를 고를 수 있는 목록”이다. [KO-05] 이때 바로 설치하지 말고 이름을 정확히 확인하는 이유는 Skills가 $skill-installer 한 줄로 설치되는 구조라서, 한 줄 안의 이름이 실제 선택이 되기 때문이다. [KO-05]

2단계에서는 목록에서 고른 이름을 한 줄 설치 문장에 넣는다. [KO-05] 아래 템플릿의 <skill-name> 자리에 화면에 보인 실제 Skills 이름을 넣으면 된다. [KO-05]

$skill-installer install <skill-name> from the official catalog.

이 장면에서 강사는 “모든 스킬은 Codex에서 한 줄이면 설치돼요”라는 문장을 소리 내어 말한다. [KO-05] 이 문장이 이 클립의 기억 문장이며, 공식 카탈로그와 한 줄 설치를 함께 떠올리게 해 준다. [KO-05]

3단계에서는 설치 후 바로 우선순위를 확인한다. [OF-08] 아래 문장은 코덱스에게 현재 작업 위치에서 Skills가 어떤 순서로 읽히는지 설명해 달라고 묻는 확인용 프롬프트다. [OF-08]

현재 작업 위치에서 Skills 저장 우선순위를 보여줘.
CWD, REPO_ROOT, HOME, /etc/codex, 번들 순서로 설명해줘.

확인해야 할 정답은 CWD -> REPO_ROOT -> HOME -> /etc/codex -> 번들이다. [OF-08] 원문 경로 힌트로는 "$CWD/.agents/skills ... /etc/codex/skills"를 기억하면 된다. [OF-08]

4단계에서는 같은 이름의 Skills가 여러 위치에 있을 수 있다고 생각하고, 앞선 우선순위 위치부터 차례로 보는 충돌 의심 연습을 한다. [OF-08]

4. 복붙 템플릿 — 그대로 쓰는 프롬프트/Skill + 해설

카탈로그를 볼 때는 아래처럼 짧게 시작한다. [KO-05] $skill-installer를 먼저 쓰는 이유는 Skills를 공식 카탈로그에서 한 줄로 설치하는 흐름의 출발점이기 때문이다. [KO-05]

$skill-installer
공식 카탈로그에서 설치 가능한 Skills를 보여줘.

설치할 때는 아래 한 줄을 쓴다. [KO-05] <skill-name>은 목록에서 고른 실제 이름을 넣는 자리이며, 핵심은 $skill-installer와 공식 카탈로그 설치를 한 문장에 담는 것이다. [KO-05]

$skill-installer install <skill-name> from the official catalog.

우선순위 확인은 아래처럼 요청한다. [OF-08] 이 질문의 기준표는 CWD -> REPO_ROOT -> HOME -> /etc/codex -> 번들이다. [OF-08]

이 작업공간에서 Skills 저장 우선순위를 확인해줘.
같은 이름의 Skills가 여러 위치에 있을 때 어떤 위치가 먼저인지도 설명해줘.

이 세 문장을 합치면 “찾기, 설치, 확인”의 최소 루틴이 된다. [KO-05, OF-08] Skills 설치는 $skill-installer 한 줄로 공식 카탈로그에서 끝내고, 결과가 이상해 보이면 저장 우선순위를 CWD -> REPO_ROOT -> HOME -> /etc/codex -> 번들 순서로 다시 본다. [KO-05, OF-08]

5. 응용·함정 — 변형, 자주 막히는 곳과 해결

첫 번째 함정은 목록도 안 보고 이름을 어림짐작해서 설치 문장을 쓰는 것이다. [KO-05] 이 수업에서는 공식 카탈로그를 먼저 펼쳐 보고, 거기서 고른 이름으로 한 줄 설치를 실행한다. [KO-05]

다음 함정은 설치 뒤 동작이 기대와 다를 때 무조건 설치 실패로 단정하는 것이다. [OF-08] 이럴 땐 저장 우선순위가 CWD -> REPO_ROOT -> HOME -> /etc/codex -> 번들이라는 점부터 짚어 본다. [OF-08]

마지막 함정은 HOME에 깔린 Skills만 보고 어디서나 똑같다고 믿어 버리는 것이다. [OF-08] 저장 우선순위에서 CWD와 REPO_ROOT가 HOME보다 앞에 있으므로, 작업 폴더나 프로젝트 뿌리 쪽에 같은 이름이 있으면 그쪽부터 봐야 한다. [OF-08]

응용할 때는 팀 작업과 개인 작업을 구분해서 생각하면 쉽다. [OF-08] 지금 작업 폴더에 가까운 위치일수록 앞에서 읽히고, 개인 폴더나 시스템 폴더로 갈수록 뒤에서 읽힌다는 그림으로 기억한다. [OF-08]

6. 정리·체크리스트

오늘의 한 문장은 “모든 스킬은 Codex에서 한 줄이면 설치돼요”이다. [KO-05] Skills는 $skill-installer 한 줄로 공식 카탈로그에서 원클릭 설치할 수 있다. [KO-05]

설치 후의 한 문장은 “우선순위는 가까운 곳부터 본다”이다. [OF-08] 스킬 저장 우선순위는 CWD -> REPO_ROOT -> HOME -> /etc/codex -> 번들이다. [OF-08]

체크리스트는 네 줄이면 된다. [KO-05, OF-08] $skill-installer를 호출했는가, 공식 카탈로그 목록에서 이름을 골랐는가, 한 줄 설치 문장에 정확한 이름을 넣었는가, 저장 우선순위를 CWD -> REPO_ROOT -> HOME -> /etc/codex -> 번들로 확인했는가. [KO-05, OF-08]

출처

본문의 [...] 표기는 아래 근거에서 확인할 수 있습니다.

• KO-05 — Skills는 $skill-installer 한 줄로 공식 카탈로그에서 원클릭 설치 · https://www.gpters.org/dev/post/complete-guide-using-codex-nutBXkvgxKmQuPK
• OF-08 — 스킬 저장 우선순위: CWD->REPO_ROOT->HOME->/etc/codex->번들 · https://developers.openai.com/codex/skills