Codex에서 potato-skill 설정하기
npx 명령 하나로 potato-skill을 Codex 프로젝트에 추가하고, $potato-skill로 스킬을 시작하고, 기본 샌드박스가 막는 명령을 승인합니다.
Codex는 저장소의 .agents/skills/에서 스킬을 읽으며, npx skills add davidjurgens/potato-skill --agent codex가 potato-skill을 그곳에 복사합니다. Codex는 재시작 없이 스킬을 인식하고, CLI와 IDE 확장에서 $potato-skill로 스킬을 시작합니다. 스킬이 연구를 어떻게 다루는지는 코딩 에이전트로 빠르게 시작하기에서, 다른 에이전트는 코딩 에이전트에 potato-skill 설치하기에서 설명합니다.
설치하기 전에
Potato는 Codex의 셸이 사용하는 Python 환경에 설치합니다. 스킬의 도우미 스크립트는 Potato의 레지스트리를 임포트하고 potato 명령을 호출하며, 스킬의 첫 단계는 Potato를 임포트할 수 있는지 확인합니다. 브라우저용 extra와 Chromium이 있으면 potato preview --screenshot과 스킬의 워크스루 스크립트가 헤드리스 브라우저에서 작업을 열 수 있습니다.
pip install 'potato-annotation[preview]'
playwright install chromiumCodex의 기본 샌드박스에는 네트워크 접근이 없습니다. 시작하기 전에 둘 다 설치해 두면 승인을 한 번 줄일 수 있습니다. skills CLI는 npx로 실행하며 Node.js 22.20 이상이 필요합니다.
스킬 설치하기
저장소에서 설치를 실행합니다.
npx skills add davidjurgens/potato-skill --agent codex이 명령은 SKILL.md, 참조 파일 30개, 도우미 스크립트 9개를 .agents/skills/potato-skill/에 복사하고, 출처를 저장소 루트의 skills-lock.json에 기록합니다. Codex는 현재 폴더에서 저장소 루트까지의 모든 폴더에서 .agents/skills/를 검색하므로, 저장소의 하위 폴더에서 시작한 세션도 스킬을 찾습니다. .agents/skills/를 커밋하면 협업자는 설치 단계 없이 스킬을 쓸 수 있습니다.
대신 그 컴퓨터의 모든 저장소에 스킬을 설치하려면 -g를 붙입니다.
npx skills add davidjurgens/potato-skill --agent codex -g전역 설치는 Codex가 읽는 사용자 수준 스킬 폴더인 ~/.agents/skills/potato-skill/에 놓입니다. Codex는 재시작 없이 새 스킬을 감지합니다. 스킬이 나타나지 않으면 Codex를 재시작하십시오.
설치 확인하기
Codex CLI나 IDE 확장에서 /skills는 Codex가 찾은 스킬을 나열하며, 목록에 potato-skill이 나타납니다. ChatGPT 데스크톱 앱에서는 사이드바의 Skills에 프로젝트 전체의 스킬이 표시됩니다.
연구 시작하기
$potato-skill로 스킬을 지정하고 연구를 설명합니다.
$potato-skill I want 200 tweets labeled for sentiment on a 5-point scale by three annotators each, with a consent page and two attention checks. Build it and start it.어노테이션 작업을 만들어 달라거나, Potato config.yaml을 고쳐 달라거나, 실행 중인 연구를 확인해 달라는 요청처럼 요청이 스킬의 설명과 맞으면 Codex는 지정하지 않아도 스킬을 불러옵니다.
샌드박스와 승인
Codex는 샌드박스에서 명령을 실행합니다. 기본 모드인 workspace-write는 명령이 작업 공간 안에 쓸 수 있게 하되 네트워크 접근을 끕니다. 네트워크를 결정하는 설정은 sandbox_workspace_write.network_access이며 기본값은 false입니다. 승인 정책이 on-request이면 Codex는 샌드박스 안에서 작업하고, 명령이 샌드박스 밖으로 나가려 할 때 묻습니다.
스킬은 연구를 만드는 동안 Codex에게 설정 검증, 사용자의 컴퓨터에서 Potato 서버 시작, 헤드리스 브라우저에서 작업 열기, 스킬의 도우미 스크립트 실행을 시킵니다. pip install에는 네트워크가 필요한데 기본 샌드박스에는 네트워크가 없습니다. Codex가 물으면 명령을 읽어 본 뒤에 샌드박스 밖에서의 실행을 승인하십시오. CLI에서는 /permissions가 권한 선택기를 엽니다. IDE 확장과 앱에서는 같은 선택지가 입력창 아래에 Ask for approval, Approve for me, Full access로 있습니다. 각 모드는 Codex의 샌드박스 문서에 설명되어 있습니다.
AGENTS.md
Codex는 AGENTS.md를 파일 이름으로 읽습니다. potato-skill 저장소의 루트에는 스킬의 규칙을 짧게 요약한 AGENTS.md가 있습니다. 이 파일을 저장소 루트에 복사하면 설치 단계 없이 Codex에 규칙을 전달할 수 있습니다. 다만 이 파일이 가리키는 참조 파일과 스크립트는 전체 설치에서만 디스크에 놓입니다. 연구를 만들 때는 skills CLI 설치를 사용하십시오. 저장소에 이미 AGENTS.md가 있다면 파일을 교체하지 말고 그 파일에 요약을 추가하십시오.
스킬 업데이트와 제거
skills CLI는 이름으로 스킬을 업데이트하고 제거합니다. 전역 설치라면 두 명령 모두에 -g를 붙입니다.
npx skills update potato-skill
npx skills remove potato-skillupdate는 설치된 사본을 GitHub 저장소와 비교하여, 저장소가 바뀌었으면 사본을 교체합니다. remove는 .agents/skills/potato-skill/와 skills-lock.json에 있는 스킬 항목을 삭제합니다.
스킬을 삭제하지 않고 끄려면 ~/.codex/config.toml에 스킬의 SKILL.md 절대 경로를 적은 항목을 추가하고 Codex를 재시작합니다. 항목에 쓸 수 있는 다른 설정은 Codex의 스킬 문서에 나와 있습니다.
[[skills.config]]
path = "/path/to/your/repo/.agents/skills/potato-skill/SKILL.md"
enabled = false