Перейти к содержимому

Настройка potato-skill в Claude Code

Установите potato-skill как плагин Claude Code, выберите область, которая определяет, кто получит плагин, и одобряйте команды, которые запускает навык.

Claude Code устанавливает potato-skill как плагин командами /plugin marketplace add davidjurgens/potato-skill и /plugin install potato-skill@potato. Плагин добавляет один навык, без агентов, хуков и серверов MCP, и Claude загружает навык всякий раз, когда запрос касается сборки или запуска исследования с разметкой. potato-skill написан для Claude Code, и этот путь даёт все части навыка в том виде, как они задуманы. potato-skill: создайте исследование с разметкой с помощью кодового агента описывает, что навык делает с исследованием, а Установка potato-skill в вашем кодовом агенте рассказывает о других агентах.

Перед установкой

Potato ставится в окружение Python, которое использует оболочка Claude Code. Вспомогательные скрипты навыка импортируют реестры Potato и вызывают команду potato, а первый шаг навыка проверяет, что Potato импортируется. Дополнение для браузера и Chromium позволяют potato preview --screenshot и скрипту сквозной проверки навыка открывать задачу в браузере без интерфейса:

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

Установка плагина

В сессии Claude Code добавьте маркетплейс, а затем установите плагин:

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

Команда установки открывает сведения о плагине в панели /plugin и спрашивает область:

ОбластьКто получает навыкГде Claude Code записывает плагин
Пользовательвы, в каждом проекте на этой машине~/.claude/settings.json
Проектвсе, кто работает в репозитории.claude/settings.json, который вы коммитите
Локальнаявы, только в этом репозитории.claude/settings.local.json

Область «Пользователь» подходит исследователю, который собирает исследования в нескольких папках проектов. Область «Проект» подходит лаборатории, чьи исследования лежат в одном репозитории. Если закоммитить .claude/settings.json, плагин включится у коллег, но не скачается на их машины. Каждый коллега выполняет установку один раз:

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

Скрипт настройки может выполнить те же два шага из оболочки, не открывая сессию:

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

Плагин, установленный из оболочки, загружается при следующем запуске Claude Code или после /reload-plugins в уже открытой сессии. Терминал, локальные сессии настольного приложения и расширение VS Code на одном компьютере читают одни и те же файлы настроек. Установка в области «Пользователь» в любом из трёх доходит и до двух остальных.

Проверка установки

claude plugin list в оболочке выводит плагин с его версией, областью и состоянием:

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

claude plugin details potato-skill перечисляет один навык и ни одного агента, хука или сервера MCP. Эта же команда оценивает стоимость навыка в контексте примерно в 220 токенов в каждой сессии, за имя и описание навыка, и примерно в 10 900 токенов при каждой загрузке навыка.

Запуск исследования

Опишите исследование обычным языком. Claude загружает навык без команды, когда запрос соответствует описанию навыка, например просьба собрать задачу разметки, изменить config.yaml Potato или проверить идущее исследование:

Хочу, чтобы 200 твитов разметили по тональности по 5-балльной шкале, по три разметчика на твит, со страницей согласия и двумя проверками внимательности. Собери и запусти.

Навыки плагинов получают имя по плагину. Если ввести /potato-skill:potato-skill перед запросом, навык загрузится напрямую. Ввод / показывает имя в меню команд, а /skills перечисляет все навыки, которые загрузил Claude Code.

Одобрение команд, которые запускает навык

Навык просит Claude проверить конфигурацию, запустить сервер Potato, открыть задачу в браузере без интерфейса и выполнить вспомогательные скрипты навыка. Каждое из этих действий — команда оболочки. В режиме Manual по умолчанию Claude Code спрашивает разрешения перед запуском команды оболочки, а ответ "Yes, and don't ask again" сохраняет правило для этой команды в этом репозитории.

При сборке исследования potato validate и potato preview запускаются много раз. Правила allow в .claude/settings.json заранее одобряют эти две команды, а всё остальное оставляют на запрос:

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

/permissions показывает все правила и файл настроек, из которого пришло каждое. potato-skill не объявляет allowed-tools. Каждая команда, которую просит навык, проходит через ваши настройки разрешений. Документация по разрешениям Claude Code описывает синтаксис правил и другие режимы разрешений.

Установка без системы плагинов

skills CLI кладёт те же файлы в .claude/skills/potato-skill/ вашего проекта, откуда Claude Code читает навыки проекта:

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

Навык проекта называется без префикса плагина, поэтому /potato-skill загружает навык. Если закоммитить .claude/skills/, коллеги получат навык без установки. .claude/skills/ читают также Cursor, GitHub Copilot in VS Code и OpenCode. CLI требуется Node.js 22.20 или новее. Облачные сессии Claude Code не загружают плагины, установленные на вашей машине. Облачные сессии работают в браузере, на claude.ai/code.

Обновление и удаление плагина

Claude Code обновляет плагин автоматически, только если у маркетплейса плагина включено автообновление, а для маркетплейса, добавленного вручную, например davidjurgens/potato-skill, автообновление выключено. Обновите плагин из оболочки:

bash
claude plugin update potato-skill@potato

Чтобы обновлять автоматически, выполните /plugin, откройте вкладку Marketplaces, выберите potato и нажмите Enable auto-update. Идущая сессия сохраняет версию, которую загрузила, а следующая сессия загрузит новую.

claude plugin uninstall potato-skill@potato удаляет плагин. /plugin marketplace remove potato удаляет маркетплейс и все плагины, установленные из него. Документация по плагинам Claude Code полностью описывает панель /plugin.

Дополнительные материалы