Install potato-skill in Your Coding Agent

potato-skill is an Agent Skill, a folder of instructions and helper scripts that any coding agent supporting the format can load. Claude Code installs potato-skill as a plugin, and every other agent gets the folder from npx skills add davidjurgens/potato-skill with the agent's name after --agent. Claude Code, Codex, and Cursor each have a setup page of their own. Quick Start with a Coding Agent covers what the skill does with a study.

Install commands by agent

potato-skill was written for Claude Code, and the skill's SKILL.md names the install folders for Codex and Cursor as well. GitHub Copilot, Gemini CLI, and OpenCode load the same files. Open the first task an agent builds in your browser and label a few items yourself before inviting annotators.

Before you install

Potato goes in the Python environment that the agent's shell uses. The skill's helper scripts import Potato's registries and call the potato command, and the skill's first step checks that Potato imports. The browser extra and Chromium let potato preview --screenshot and the skill's walk-through script open the task in a headless browser:

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

The skills CLI runs through npx. Version 1.7.6 of the CLI requires Node.js 22.20 or later.

What the skills CLI writes

npx skills add copies SKILL.md, the 30 reference files, and the nine helper scripts into .agents/skills/potato-skill/, and records the source in skills-lock.json at the project root. Add -g to install into ~/.agents/skills/potato-skill/ for every project on the machine. Codex, Cursor, GitHub Copilot in VS Code, Gemini CLI, and OpenCode all read .agents/skills/. One command can name several of those agents, and the agents then share a single copy:

npx skills add davidjurgens/potato-skill --agent codex cursor github-copilot gemini-cli opencode

The CLI's agent table gives the --agent name and folder for the other agents the CLI supports. Every agent on this page also loads the skill without a command when a request fits the skill's description, such as a request to build an annotation task.

GitHub Copilot in VS Code

VS Code reads .agents/skills/ and .claude/skills/ in local sessions, beside Copilot's own .github/skills/. Skills work in both chat and agent mode. Typing /potato-skill in chat starts the skill.

Gemini CLI

Gemini CLI reads .agents/skills/ in the workspace and ~/.agents/skills/ for the user. /skills list shows the skills Gemini found. Gemini starts a matching skill without a command, and asks you to confirm before loading the skill into the conversation.

OpenCode

OpenCode reads .agents/skills/ in every folder from the current one up to the git worktree, and ~/.agents/skills/ for a global install. The agent loads a matching skill through OpenCode's skill tool.

Without the skills CLI

The potato-skill repository has an AGENTS.md at the repository root, a short summary of the skill's rules that Codex and Cursor read by filename. Copying the file into your project root gives an agent the rules with no install step. The file points at reference files and scripts that only a full install puts on disk. The Quick Start with a Coding Agent compares the full install with the AGENTS.md copy. The reference files are also published at davidjurgens.github.io/potato-skill. An agent that can read web pages can use the published copy, and you can read the files there before installing.

Updating and removing the skill

The skills CLI updates and removes the skill by name. Add -g to either command for a global install:

npx skills update potato-skill
npx skills remove potato-skill

update checks the installed copy against the GitHub repository and replaces the copy when the repository has changed. remove deletes .agents/skills/potato-skill/ and the skill's entry in skills-lock.json. The Claude Code page gives the update and removal commands for the plugin.

Further reading

• Quick Start with a Coding Agent
• Set Up potato-skill in Claude Code
• Set Up potato-skill in Codex
• Set Up potato-skill in Cursor
• potato-skill on GitHub