코딩 에이전트에 potato-skill 설치하기
Claude Code, Codex, Cursor 등 코딩 에이전트에 potato-skill을 설치합니다. 에이전트별 설치 명령과 스킬 폴더를 함께 안내합니다.
potato-skill은 에이전트 스킬(Agent Skill)입니다. 지침과 도우미 스크립트를 담은 폴더이며, 이 형식을 지원하는 코딩 에이전트라면 어디서든 불러올 수 있습니다. Claude Code는 potato-skill을 플러그인으로 설치하고, 그 밖의 에이전트는 npx skills add davidjurgens/potato-skill로 폴더를 받습니다. --agent 뒤에는 에이전트 이름을 붙입니다. Claude Code, Codex, Cursor에는 각각 별도의 설정 페이지가 있습니다. 스킬이 연구를 어떻게 다루는지는 코딩 에이전트로 빠르게 시작하기에서 설명합니다.
에이전트별 설치 명령
| 에이전트 | 설치 | 에이전트가 읽는 폴더 | 설정 페이지 |
|---|---|---|---|
| Claude Code | /plugin marketplace add davidjurgens/potato-skill, 이어서 /plugin install potato-skill@potato | Claude Code의 플러그인 캐시 | Claude Code |
| Codex | npx skills add davidjurgens/potato-skill --agent codex | .agents/skills/ | Codex |
| Cursor | npx skills add davidjurgens/potato-skill --agent cursor | .agents/skills/ | Cursor |
| VS Code의 GitHub Copilot | npx skills add davidjurgens/potato-skill --agent github-copilot | .agents/skills/ | 아래 |
| Gemini CLI | npx skills add davidjurgens/potato-skill --agent gemini-cli | .agents/skills/ | 아래 |
| OpenCode | npx skills add davidjurgens/potato-skill --agent opencode | .agents/skills/ | 아래 |
potato-skill은 Claude Code용으로 작성되었으며, 스킬의 SKILL.md에는 Codex와 Cursor의 설치 폴더도 적혀 있습니다. GitHub Copilot, Gemini CLI, OpenCode는 같은 파일을 불러옵니다. 어노테이터를 초대하기 전에, 에이전트가 처음 만든 작업을 브라우저에서 열고 몇 개 항목에 직접 레이블을 붙여 보십시오.
설치하기 전에
Potato는 에이전트의 셸이 사용하는 Python 환경에 설치합니다. 스킬의 도우미 스크립트는 Potato의 레지스트리를 임포트하고 potato 명령을 호출하며, 스킬의 첫 단계는 Potato를 임포트할 수 있는지 확인합니다. 브라우저용 extra와 Chromium이 있으면 potato preview --screenshot과 스킬의 워크스루 스크립트가 헤드리스 브라우저에서 작업을 열 수 있습니다.
pip install 'potato-annotation[preview]'
playwright install chromiumskills CLI는 npx로 실행합니다. CLI 1.7.6 버전에는 Node.js 22.20 이상이 필요합니다.
skills CLI가 기록하는 내용
npx skills add는 SKILL.md, 참조 파일 30개, 도우미 스크립트 9개를 .agents/skills/potato-skill/에 복사하고, 출처를 프로젝트 루트의 skills-lock.json에 기록합니다. -g를 붙이면 ~/.agents/skills/potato-skill/에 설치되어 그 컴퓨터의 모든 프로젝트에서 쓸 수 있습니다. Codex, Cursor, VS Code의 GitHub Copilot, Gemini CLI, OpenCode는 모두 .agents/skills/를 읽습니다. 명령 하나에 이 에이전트 여러 개를 지정할 수 있으며, 이 경우 각 에이전트가 사본 하나를 공유합니다.
npx skills add davidjurgens/potato-skill --agent codex cursor github-copilot gemini-cli opencodeCLI가 지원하는 다른 에이전트의 --agent 이름과 폴더는 CLI의 에이전트 표에 나와 있습니다. 이 페이지에 나오는 에이전트는 모두, 어노테이션 작업을 만들어 달라는 요청처럼 요청이 스킬의 설명과 맞을 때는 명령 없이도 스킬을 불러옵니다.
VS Code의 GitHub Copilot
VS Code는 로컬 세션에서 Copilot 자체의 .github/skills/와 함께 .agents/skills/와 .claude/skills/를 읽습니다. 스킬은 채팅과 에이전트 모드에서 모두 동작합니다. 채팅에 /potato-skill을 입력하면 스킬이 시작됩니다.
Gemini CLI
Gemini CLI는 작업 공간의 .agents/skills/와 사용자의 ~/.agents/skills/를 읽습니다. /skills list를 실행하면 Gemini가 찾은 스킬이 표시됩니다. Gemini는 요청이 맞으면 명령 없이 스킬을 시작하며, 스킬을 대화에 불러오기 전에 확인을 요청합니다.
OpenCode
OpenCode는 현재 폴더에서 git 워크트리까지의 모든 폴더에 있는 .agents/skills/를 읽고, 전역 설치에서는 ~/.agents/skills/를 읽습니다. 에이전트는 OpenCode의 skill 도구를 통해 맞는 스킬을 불러옵니다.
skills CLI 없이 사용하기
potato-skill 저장소의 루트에는 AGENTS.md가 있습니다. 스킬의 규칙을 짧게 요약한 파일이며 Codex와 Cursor가 파일 이름으로 읽습니다. 이 파일을 프로젝트 루트에 복사하면 설치 단계 없이 에이전트에 규칙을 전달할 수 있습니다. 다만 이 파일이 가리키는 참조 파일과 스크립트는 전체 설치에서만 디스크에 놓입니다. 전체 설치와 AGENTS.md 복사의 비교는 코딩 에이전트로 빠르게 시작하기에 있습니다. 참조 파일은 davidjurgens.github.io/potato-skill에도 공개되어 있습니다. 웹 페이지를 읽을 수 있는 에이전트는 공개된 사본을 사용할 수 있고, 설치하기 전에 그곳에서 파일을 읽어 볼 수도 있습니다.
스킬 업데이트와 제거
skills CLI는 이름으로 스킬을 업데이트하고 제거합니다. 전역 설치라면 두 명령 모두에 -g를 붙입니다.
npx skills update potato-skill
npx skills remove potato-skillupdate는 설치된 사본을 GitHub 저장소와 비교하여, 저장소가 바뀌었으면 사본을 교체합니다. remove는 .agents/skills/potato-skill/와 skills-lock.json에 있는 스킬 항목을 삭제합니다. 플러그인의 업데이트와 제거 명령은 Claude Code 페이지에 있습니다.