Claude Code에서 potato-skill 설정하기

Claude Code는 potato-skill을 플러그인으로 설치합니다. /plugin marketplace add davidjurgens/potato-skill을 실행한 다음 /plugin install potato-skill@potato를 실행합니다. 플러그인에는 스킬 하나만 들어 있으며 에이전트, 훅, MCP 서버는 없습니다. Claude는 어노테이션 연구를 만들거나 실행하는 요청이 올 때마다 이 스킬을 불러옵니다. potato-skill은 Claude Code용으로 작성되었으며, 이 경로를 쓰면 스킬의 모든 부분을 설계된 대로 사용할 수 있습니다. 스킬이 연구를 어떻게 다루는지는 코딩 에이전트로 빠르게 시작하기에서, 다른 에이전트는 코딩 에이전트에 potato-skill 설치하기에서 설명합니다.

설치하기 전에

Potato는 Claude Code의 셸이 사용하는 Python 환경에 설치합니다. 스킬의 도우미 스크립트는 Potato의 레지스트리를 임포트하고 potato 명령을 호출하며, 스킬의 첫 단계는 Potato를 임포트할 수 있는지 확인합니다. 브라우저용 extra와 Chromium이 있으면 potato preview --screenshot과 스킬의 워크스루 스크립트가 헤드리스 브라우저에서 작업을 열 수 있습니다.

pip install 'potato-annotation[preview]'
playwright install chromium

플러그인 설치하기

Claude Code 세션에서 마켓플레이스를 추가한 다음 플러그인을 설치합니다.

/plugin marketplace add davidjurgens/potato-skill
/plugin install potato-skill@potato

설치 명령을 실행하면 /plugin 패널에 플러그인 상세 정보가 열리고 범위를 묻습니다.

User 범위는 여러 프로젝트 폴더에서 연구를 만드는 연구자에게 맞습니다. Project 범위는 여러 연구가 저장소 하나를 공유하는 연구실에 맞습니다. .claude/settings.json을 커밋하면 협업자에게도 플러그인이 켜지지만, 협업자의 컴퓨터에 플러그인이 다운로드되지는 않습니다. 협업자는 각자 설치를 한 번 실행해야 합니다.

claude plugin install potato-skill@potato --scope project

설정 스크립트에서는 세션을 열지 않고 셸에서 같은 두 단계를 실행할 수 있습니다.

claude plugin marketplace add davidjurgens/potato-skill
claude plugin install potato-skill@potato

셸에서 설치한 플러그인은 다음에 Claude Code를 시작할 때 불러와지며, 이미 열려 있는 세션에서는 /reload-plugins를 실행한 뒤에 불러와집니다. 같은 컴퓨터의 터미널, 데스크톱 앱의 로컬 세션, VS Code 확장은 같은 설정 파일을 읽습니다. 이 셋 중 어느 하나에서 User 범위로 설치하면 나머지 둘에도 적용됩니다.

설치 확인하기

셸에서 claude plugin list를 실행하면 플러그인의 버전, 범위, 상태가 출력됩니다.

  ❯ potato-skill@potato
    Version: 1.2.0
    Scope: user
    Status: ✔ enabled

claude plugin details potato-skill은 스킬 하나를 보여 주며 에이전트, 훅, MCP 서버는 보여 주지 않습니다. 같은 명령이 스킬의 컨텍스트 비용도 추정하여 알려 줍니다. 스킬의 이름과 설명이 모든 세션에서 약 220토큰, 스킬을 불러올 때마다 약 10,900토큰입니다.

연구 시작하기

연구를 평범한 말로 설명합니다. 어노테이션 작업을 만들어 달라거나, Potato config.yaml을 고쳐 달라거나, 실행 중인 연구를 확인해 달라는 요청처럼 요청이 스킬의 설명과 맞으면 Claude는 명령 없이도 스킬을 불러옵니다.

트윗 200개에 대해 어노테이터 3명이 각각 5점 척도로 감정 레이블을 붙이게 하고 싶어. 동의 페이지와 주의력 확인 문항 2개를 넣어 줘. 만들어서 시작해 줘.

플러그인의 스킬 이름은 플러그인 이름을 앞에 붙입니다. 요청 앞에 /potato-skill:potato-skill을 입력하면 스킬을 바로 불러옵니다. /를 입력하면 명령 메뉴에 이름이 표시되고, /skills는 Claude Code가 불러온 모든 스킬을 보여 줍니다.

스킬이 실행하는 명령 승인하기

스킬은 Claude에게 설정 검증, Potato 서버 시작, 헤드리스 브라우저에서 작업 열기, 스킬의 도우미 스크립트 실행을 시킵니다. 이들은 모두 셸 명령입니다. 기본 Manual 모드에서 Claude Code는 셸 명령을 실행하기 전에 묻고, "Yes, and don't ask again"을 선택하면 그 저장소에서 해당 명령에 대한 규칙이 저장됩니다.

연구를 만드는 동안 potato validate와 potato preview를 여러 번 실행합니다. .claude/settings.json에 허용 규칙을 두면 이 두 명령만 미리 승인하고 나머지는 모두 확인을 거치게 할 수 있습니다.

{
  "permissions": {
    "allow": [
      "Bash(potato validate *)",
      "Bash(potato preview *)"
    ]
  }
}

/permissions는 모든 규칙과 각 규칙이 어느 설정 파일에서 왔는지 보여 줍니다. potato-skill은 allowed-tools를 선언하지 않습니다. 스킬이 요청하는 모든 명령은 사용자의 권한 설정을 거칩니다. 규칙 문법과 다른 권한 모드는 Claude Code의 권한 문서에 설명되어 있습니다.

플러그인 시스템 없이 설치하기

skills CLI는 같은 파일을 프로젝트의 .claude/skills/potato-skill/에 둡니다. Claude Code는 그곳에서 프로젝트 스킬을 읽습니다.

npx skills add davidjurgens/potato-skill --agent claude-code

프로젝트 스킬에는 플러그인 접두사가 붙지 않으므로 /potato-skill로 스킬을 불러옵니다. .claude/skills/를 커밋하면 협업자는 설치 단계 없이 스킬을 쓸 수 있습니다. Cursor, VS Code의 GitHub Copilot, OpenCode도 .claude/skills/를 읽습니다. CLI에는 Node.js 22.20 이상이 필요합니다. Claude Code의 클라우드 세션은 사용자의 컴퓨터에 설치한 플러그인을 불러오지 않습니다. 클라우드 세션은 claude.ai/code의 브라우저에서 실행됩니다.

플러그인 업데이트와 제거

Claude Code가 플러그인을 자동으로 업데이트하는 것은 플러그인의 마켓플레이스에서 자동 업데이트가 켜져 있을 때뿐이며, davidjurgens/potato-skill처럼 직접 추가한 마켓플레이스는 자동 업데이트가 꺼진 상태로 시작합니다. 플러그인은 셸에서 업데이트합니다.

claude plugin update potato-skill@potato

대신 자동으로 업데이트하려면 /plugin을 실행하고 Marketplaces 탭을 열어 potato를 선택한 다음 Enable auto-update를 선택합니다. 실행 중인 세션은 불러온 시점의 버전을 유지하고, 다음 세션에서 새 버전을 불러옵니다.

claude plugin uninstall potato-skill@potato는 플러그인을 제거합니다. /plugin marketplace remove potato는 마켓플레이스와 그 마켓플레이스에서 설치한 모든 플러그인을 제거합니다. /plugin 패널의 자세한 내용은 Claude Code의 플러그인 문서에 있습니다.

더 읽어보기

• 코딩 에이전트로 빠르게 시작하기
• Claude Code, Codex, Cursor로 어노테이션 연구 만들기
• Codex에서 potato-skill 설정하기
• Cursor에서 potato-skill 설정하기
• 코딩 에이전트가 점검할 수 있는 설정