코덱스 CLI에 스킬 설치하는 방법

Node.js 18 이상이 필요한데, 코덱스 CLI가 설치되어 있다면 이미 있습니다. --agent codex는 코덱스 전용 폴더에 쓰고, -y는 기본값을 받아들입니다. 소유자, 저장소, 스킬 이름은 이 사이트의 스킬 페이지에서 가져오세요.

저장소 전체를 둘러보려면 @스킬 부분을 빼세요. npx skills add obra/superpowers --agent codex를 실행하면 그 안의 모든 스킬을 고르는 화면이 열립니다.

npx skills add obra/superpowers@systematic-debugging --agent codex -y

-g를 붙이면 스킬이 ~/.codex/skills/<이름>/에 들어가고 codex를 실행하는 모든 디렉터리에 적용됩니다. 없으면 현재 저장소의 .agents/skills/<이름>/에 들어갑니다. 코덱스는 작업 디렉터리에서 위로 올라가며 찾으므로 프로젝트 스킬은 저장소의 어느 하위 폴더에서도 발견됩니다.

코덱스는 공용 위치인 ~/.agents/skills/도 읽으므로 --agent 없이 설치한 스킬도 동작할 수 있습니다. 한 컴퓨터에서 여러 에이전트를 쓰며 각각 다른 스킬 조합을 원한다면 전용 폴더가 더 예측 가능합니다.

npx skills add obra/superpowers@systematic-debugging --agent codex -g -y

# Global:  ~/.codex/skills/systematic-debugging/SKILL.md
# Project: .agents/skills/systematic-debugging/SKILL.md

코덱스는 세션이 시작될 때 스킬 폴더를 읽습니다. 이미 codex가 실행 중이면 새 세션을 시작하세요(/new 명령, 또는 종료 후 다시 실행). 그다음 /skills를 입력하면 발견된 스킬이 설명과 함께 나열됩니다. 목록에 없는 스킬은 디스크에서 찾지 못했거나 머리말이 잘못된 것입니다.

코덱스가 /skills를 모르는 명령이라고 하면 스킬 지원 이전 버전입니다. npm install -g @openai/codex@latest로 갱신하고 다시 시도하세요.

codex
/skills

요청이 설명과 맞으면 코덱스가 자동으로 스킬을 불러옵니다. 명시적으로 부르려면 프롬프트 어디든 달러 기호로 언급하세요. $systematic-debugging 다음에 요청을 씁니다. 설명이 비었거나 모호한 스킬은 명시적 호출이 확실한 방법이고, 새 스킬이 무엇을 하는지 배우기에도 좋습니다.

AGENTS.md는 스킬이 아닙니다. 코덱스는 AGENTS.md를 매 턴 상시 지침으로 읽고, 스킬은 필요할 때만 읽습니다. AGENTS.md는 짧게 두고 긴 절차는 스킬로 옮겨 메시지마다 토큰이 들지 않게 하세요.

$systematic-debugging the login test fails only on CI, find out why before changing anything

코덱스는 기본적으로 네트워크를 막고 쓰기를 작업 디렉터리로 제한하는 샌드박스 안에서 명령을 실행합니다. 마크다운만 있는 스킬은 영향이 없습니다. 실행 시 URL을 받아오거나 스크립트가 패키지를 설치하는 스킬은 기본 정책에서 조용히 실패합니다. 설치 전에 스킬 페이지의 스크립트 표시를 확인하고, 믿을 만하다면 그 세션만 덜 제한적인 샌드박스로 codex를 실행하세요.

읽어 보지 않은 스킬 때문에 샌드박스를 풀지 마세요. 스킬은 내 권한으로 실행되며, 지침 파일과 내 컴퓨터 사이에 있는 유일한 방벽이 샌드박스입니다.

npx skills update는 CLI가 설치한 모든 스킬을 갱신합니다. 삭제하려면 ~/.codex/skills/나 프로젝트의 .agents/skills/에서 폴더를 지우고 새 세션을 시작하세요. 코덱스에는 별도 등록부가 없습니다. 폴더가 기록의 전부입니다.

npx skills update

설치했는데 /skills에 없다: 먼저 새 세션을 시작하세요. 코덱스는 세션 중에 다시 훑지 않습니다. 그래도 없으면 폴더를 열어 최상위에 SKILL.md가 있고 머리말에 name과 description이 있는지 확인하세요. 한 단계 더 깊이 들어간 스킬은 찾지 못합니다.

CLI가 No valid skills found를 출력한다: 저장소의 SKILL.md에 머리말이 없거나 제작자가 스킬을 옮긴 것입니다. 스킬 페이지의 저장소 링크에서 현재 경로를 확인하거나 폴더를 .agents/skills/에 직접 복사하세요.

목록에는 있는데 쓰이지 않는다: 코덱스는 요청을 설명 문구와 대조합니다. 맞게 바꿔 말하거나 $이름 형식을 쓰세요. 다른 폴더에 같은 이름의 스킬이 둘 있으면 서로 가리므로 하나의 이름을 바꾸세요.

윈도우: Node.js가 PATH에 있는 PowerShell이나 Git Bash에서 설치하세요. 전역 설치는 심볼릭 링크를 만들 수 있고 이는 개발자 모드가 필요합니다. 권한 오류가 나면 설정에서 켜거나 관리자로 한 번 실행하세요.