Skip to content
  1. How-to
  2. Tools and setup
  3. Using it in Codex and other tools

Using it in Codex and other tools

In one lineInstall with one command, run setup once to pick models, then start with $poteto-mode.

5 minutes to install, 6 to readFor: You use Codex, OpenCode, Pi, or another tool that supports Agent SkillsFull guide step 1: Install pstack

One command to install

Each pstack skill is a SKILL.md in the common Agent Skill format, so it installs without Cursor. In your terminal, type:

It needs Node.js 22.20 or newer. If you’re not sure, run node -v first.

Check the skills you want, then pick which tools to install into. If you don’t know which to check, select all. For just a few, see Install only a few skills.

Install for every project

By default it installs only into the current project folder. To make it available in every project, add -g:

Check where it installed

Look in the matching folder for subfolders like poteto-mode:

Tool This project All projects (-g)
Codex and others .agents/skills/ ~/.agents/skills/
Claude Code .claude/skills/ ~/.claude/skills/
Pi .pi/skills/ ~/.pi/agent/skills/
Cursor .cursor/skills/ ~/.cursor/skills/

Codex also reads ~/.codex/skills/.

Skills don’t start on their own. Except for setup-pstack, each one runs only when you name it.

Pick models

After installing, run setup-pstack once. It lists the models you can use, asks about your reasoning budget (how long models think), then writes one file:

Where the settings file lives
~/.agents/pstack-models.md

The skills read it themselves when they pick a model, so you don’t need a new conversation.

Run setup at least once

pstack’s default model names are written for Cursor. If your tool lacks a name, the skill switches to the closest one. If there’s nothing close, it uses your current conversation’s model and says so. Run setup once, and every role gets a model you actually have.

Your first task

In Codex, you name a skill with $ plus its name, like $poteto-mode. Commands on this site are written for Claude Code by default (/pstack:poteto-mode). Pick Codex here, and every command on the site switches to the $ form:

I use

Commands on this site are shown for this tool, so copying just works

Shown as: /pstack:poteto-mode

Send your first task like this:

In Codex, name a skill with $
$poteto-mode add a --json flag to this command. The existing text output must stay byte-for-byte identical. Verify both outputs.

You can also say “use the poteto-mode skill for this.” In other tools, use their syntax instead. For how to write this message well, see Your first task.

What your tool lacks, it works around

The skills use Cursor’s names, and the AI translates them. A few things you’ll notice:

  • No way to send out helpers (subagents): steps meant to run side by side run one at a time, a bit slower.
  • No question tool: it lists numbered options in the chat.
  • No /loop: it uses a timed wait command and checks again later.
  • No Custom Mode: only Cursor has it. Write poteto-mode at the start of each new task.

deslop, control-cli, and control-ui come from another Cursor plugin. Without them, the AI uses the tools you have, like Playwright or tmux.

Stuck?

npx skills errors out and won't run.

Run node -v first. If it’s below 22.20, upgrade Node.js and try again.

I can't find pstack's skills in another project.

By default it only installs into the project you were in. Run it again in the new project, or add -g to install for every project.

I changed the model settings, but it doesn't seem to apply.

Open ~/.agents/pstack-models.md and check the line shows the model you chose. Then check that name exists in your tool. If it doesn’t, the skill switches to the closest one and says so in the reply.

An unofficial beginner's guide to pstack, not its official docs. pstack is made by poteto; the official repo is the source of truth for commands and behavior. The original guide source is on GitHub.

Hosted by airali. Adapted from Xiaoxiaodong's MIT-licensed guide.