Установка potato-skill в вашем кодовом агенте
Установите potato-skill в Claude Code, Codex, Cursor или другой кодовый агент: команда установки и папка навыков для каждого агента.
potato-skill — это навык агента, то есть папка с инструкциями и вспомогательными скриптами, которую может загрузить любой кодовый агент, поддерживающий этот формат. Claude Code устанавливает potato-skill как плагин, а все остальные агенты получают папку командой npx skills add davidjurgens/potato-skill, где после --agent указано имя агента. У Claude Code, Codex и Cursor есть отдельные страницы настройки. potato-skill: создайте исследование с разметкой с помощью кодового агента описывает, что навык делает с исследованием.
Команды установки для каждого агента
| Агент | Установка | Папка, которую читает агент | Страница настройки |
|---|---|---|---|
| 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 |
| GitHub Copilot in VS Code | 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 импортируется. Дополнение для браузера и Chromium позволяют potato preview --screenshot и скрипту сквозной проверки навыка открывать задачу в браузере без интерфейса:
pip install 'potato-annotation[preview]'
playwright install chromiumskills CLI запускается через npx. Версии 1.7.6 CLI требуется Node.js 22.20 или новее.
Что записывает skills CLI
npx skills add копирует SKILL.md, 30 справочных файлов и девять вспомогательных скриптов в .agents/skills/potato-skill/ и записывает источник в skills-lock.json в корне проекта. Добавьте -g, чтобы установить в ~/.agents/skills/potato-skill/ для всех проектов на машине. Codex, Cursor, GitHub Copilot in VS Code, Gemini CLI и OpenCode читают .agents/skills/. Одна команда может назвать сразу несколько таких агентов, и тогда они пользуются одной общей копией:
npx skills add davidjurgens/potato-skill --agent codex cursor github-copilot gemini-cli opencodeВ таблице агентов CLI приведены имя для --agent и папка для остальных агентов, которые поддерживает CLI. Каждый агент на этой странице загружает навык и без команды, когда запрос соответствует описанию навыка, например просьба собрать задачу разметки.
GitHub Copilot in VS Code
VS Code читает .agents/skills/ и .claude/skills/ в локальных сессиях, рядом с собственной папкой Copilot .github/skills/. Навыки работают и в чате, и в режиме агента. Ввод /potato-skill в чате запускает навык.
Gemini CLI
Gemini CLI читает .agents/skills/ в рабочей области и ~/.agents/skills/ для пользователя. /skills list показывает навыки, которые нашёл Gemini. Gemini запускает подходящий навык без команды и просит подтверждения, прежде чем загрузить навык в разговор.
OpenCode
OpenCode читает .agents/skills/ в каждой папке от текущей до рабочего дерева git и ~/.agents/skills/ при глобальной установке. Агент загружает подходящий навык через инструмент skill в OpenCode.
Без skills CLI
В репозитории potato-skill в корне лежит AGENTS.md, короткая сводка правил навыка, которую Codex и Cursor читают по имени файла. Если скопировать файл в корень проекта, агент получит правила без установки. Файл ссылается на справочные файлы и скрипты, которые попадают на диск только при полной установке. potato-skill: создайте исследование с разметкой с помощью кодового агента сравнивает полную установку с копией 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 приводит команды обновления и удаления плагина.