poteto-mode
Skill2 starsChanged 6 days agoMITView on GitHub
User-invoked only: /poteto-mode. Lauren Tan's (poteto) working style in Forge words: goal first, steer by named principles, prototype instead of asking, evidence labels, fresh agents.
32 other projects use a version of this.
Adopted by
Most recently taken up by
- paramcodes/skillstheir own version, first seen Nov 8, 2026
- creedants/pstack-t3their own version, first seen Nov 3, 2026
- painhardcore/pstacktheir own version, first seen Nov 2, 2026
- DarthJonathan/guac-skillstheir own version, first seen Nov 1, 2026
- anhermon/pstack-claudetheir own version, first seen Nov 1, 2026
- adjohn/pstacktheir own version, first seen Oct 29, 2026
Used with
Projects with it also use poteto-help, setup-pstack and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
ianclearySkillpoteto-help
Guides users through pstack setup, /poteto-mode, and picking the skill, playbook, or principle for a task. Type /poteto-help with a question.
Also in 14 projects that use this
bnemaSkillsetup-pstack
Configure which Pi models pstack uses per role. Detects available provider/model specs and writes pstack's user configuration. Use for /setup-pstack, "configure pstack models", or changing pstack model choices.
Also in 24 projects that use this
eryzerzSkillmake-bot-ui
Use when building a custom UI (page, dashboard, buttons) that should wake a Grok Bot over a webhook, when the user must provide a webhook sender key, or when exposing that UI on Tailscale.
Also in 15 projects that use this
tristanphvnSkillketchup-video
Catch the user up like /keel:ketchup, with a short silent video of slides for what happened and the waiting calls as text under it. Use for /keel:ketchup-video.
Also in 9 projects that use this
ianclearySkillprinciple-explain-the-number
Apply before you trust, report, or act on a number you measured: a speedup, a regression, a throughput, a latency, or an eval result. Find what limits it, and rule out that it measured something other than the work you think.
Also in 19 projects that use this
TheOnlyFusionCubeSkillstatechart
Draw what an app's user sees as a Mermaid statechart from a TLA+ model. States are gray if they work, red if still wrong, and green if fixed. Each bug TLC finds is a numbered path. Use for /statechart, \"show the PM the bug\", or to turn an agreed chart into a TLA+ skeleton.
Also in 12 projects that use this
Other versions32 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 32
- backnotprop/pstack★ 3.8ksame name
- jtaroreh/agystack★ 128same name
- dsebban/skills★ 71same name
- TheOnlyFusionCube/potetos-for-everyone★ 21same name
- creedants/pstack-t3★ 18same name
- painhardcore/pstack★ 18same name
- Scino/fstack★ 18same name
- mariusflorescu/pstack-t3★ 13same name
- adjohn/pstack★ 9same name
- kkgogogo17/pi-pstack★ 9same name
22 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository99 other files it gives its agents.
- docs/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- brainstormingSkill
- claude-md-improverSkill
- dispatching-parallel-agentsSkill
- executing-plansSkill
- finishing-a-development-branchSkill
- forge-a11ySkill
- forge-agent-reportSkill
- forge-agentSkill
- forge-apiSkill
- forge-authSkill
- forge-autoresearchSkill
- forge-botsSkill
- forge-brainstormSkill
- forge-cliSkill
- forge-cmsSkill
- forge-code-reviewSkill
- forge-contextSkill
- forge-councilSkill
- forge-craftSkill
- forge-databaseSkill
- forge-dataSkill
- forge-debugSkill
- forge-deeplearnSkill
- forge-devopsSkill
- forge-docdriftSkill
- forge-doctorSkill
- forge-ecc-adapterSkill
- forge-ecommerceSkill
- forge-electronSkill
- forge-extensionSkill
- forge-figmaSkill
- forge-fullstackSkill
- forge-gameSkill
- forge-graded-verifySkill
- forge-guardianSkill
- forge-heartbeatSkill
- forge-i18n-docsSkill
- forge-intakeSkill
- forge-integrationSkill
- forge-long-form-writingSkill
- forge-mcp-clientsSkill
- forge-memorySkill
- forge-migrationSkill
- forge-mindmapSkill
- forge-mlopsSkill
- forge-mobileSkill
- forge-n8nSkill
- forge-nightshiftSkill
- forge-observabilitySkill
- forge-paymentsSkill
- forge-plan-largeSkill
- forge-prdSkill
- forge-predictionSkill
- forge-projectbrainSkill
- forge-prompt-coachSkill
- forge-qualitySkill
- forge-ragSkill
- forge-registrySkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
3 rules. 0 are common, 3 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 31 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 20
If the evidence rules out the change the owner asked for, show the evidence and stop there.
- Distinctive: line 21
Put the same goal sentence at the top of every Boss or Workflow agent brief and of the final report.
- Distinctive: line 88
Every claim carries its label in the same sentence: measured, inferred or guess.
“Common” is measured: kept by at least 6 in 10 of the 31 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
poteto mode (Forge rewrite of pstack's poteto-mode)
The owner types /poteto-mode to run the current task in Lauren Tan's style: concise and detailed replies,
deliberate delegation, simple code, verified work. Forge keeps its own routing (forge-router, the Bosses,
the GOAT routes, every hard gate); this mode adds the parts Forge's routing lacked: a named principle
vocabulary to steer with, the goal restated first, a rule for which forks go to the owner, and a reply style
where every claim carries its evidence label. It stays on for the rest of the session unless the owner says
it is off.
On the first message of a task
- Restate, in your own words, the owner's goal, the problem behind it and, when the task ships a change, the smallest change you expect to meet it. Do not wait for confirmation. Done when: the restatement is the first paragraph of your reply.
- If the evidence rules out the change the owner asked for, show the evidence and stop there.
- Put the same goal sentence at the top of every Boss or Workflow agent brief and of the final report.
Steer by principle names
Each name is a leading word for a complete rule. Apply the ones the task triggers, and in the reply name each principle that shaped a decision together with the choice it changed. A principle named without a changed decision was not applied; leave it out.
| Principle | Apply when | Forge home |
| Laziness protocol | sizing a diff, tempted to add a layer | ponytail |
| Foundational thinking | before logic: core types, data shapes, what concurrent actors share | forge-brainstorm |
| Redesign from first principles | a new requirement meets an old design | forge-brainstorm |
| Attack the premise | two fixes on one premise failed | forge-debug (3-strike rule) |
| Subtract before you add | sequencing an addition or rewrite: remove dead weight first | ponytail |
| Minimise reader load | code hard to trace: collapse one-caller wrappers, shrink mutable scope | forge-code-review |
| Outcome-oriented execution | planned migrations: converge on the target, no throwaway compatibility states | forge-migration |
| Experience first | product or UX trade-offs | forge-craft |
| Exhaust the design space | a novel decision with no precedent: two or three prototypes, then compare | forge-brainstorm, forge-council |
| Build the lever | non-trivial work: write the script that does or proves it | a tested .cjs in .claude/forge-bin/ |
| Model the domain | stateful or branchy code: one structure (state machine, table, reducer) instead of scattered conditionals | Build Boss |
| Boundary discipline | validation and error handling: guard at the boundary, trust internal types | forge-security-review |
| Type-system discipline | designing types: illegal states unrepresentable, parse external data at the edge | Build Boss |
| Idempotent operations | commands and loops that can crash and retry | forge-n8n, forge-payments |
| Migrate callers, then delete the legacy API | a new internal API while old callers exist: one wave | forge-migration |
| Separate before serialising shared state | concurrent writers on one file, branch or key: remove the sharing first | forge-worktrees |
| Prove it works | before "done": the real artifact, not a proxy | forge-verify |
| Fix root causes | debugging | forge-debug |
| Sequence verifiable units | multi-step work: each small unit ends in a check | forge-team-orchestration |
| Test behaviour, not implementation | writing or keeping a test | forge-testing |
| Explain the number | before trusting or reporting any measured number | /forge-autoresearch |
| Guard the context window | big outputs and fan-out: bulk work to fresh agents, summaries in the main thread | forge-context |
| Never block on the owner | reversible work: proceed, show the result | the autonomy rules |
| Encode lessons in structure | the same instruction written a second time: make it a check, test or script | the own-mistakes rule |
The 24 names and their one-line triggers come from the pstack principle index; the full upstream leaf texts were not adopted. Read the Forge home skill when a principle needs more than its line.
Before asking the owner a question
Classify the fork first. If the answer is a fact you can observe by running something (behaviour, timing,
layout, output, speed, whether an eval separates), it is not the owner's question: sketch it in _scratch/
or a worktree and let the result decide. A read-only investigation answers from the evidence instead. Keep
questions for real product or preference calls. Under an autonomy grant, decide the calls the grant covers,
act, and report each with what the owner could ask for instead. The owner answers in their own words; never
hand them a code word to type back.
Autonomy, Forge limits
- Reversible local work proceeds without asking.
- Owner-only, always: push, deploy, delete, spend, DNS, production, credentials, and anything outbound.
Messages to people (chat, mail, tickets) are drafted, never sent. MCP servers stay opt-in through
forge-mcp-clients. Processes are stopped by exact PID only. - "No" is an acceptable answer. Asked whether to add scope or shown an approach, give your real judgement, including "this does not earn its place".
Delegation
- Each new piece of work (a fix round, a follow-up, a retry) goes to a fresh Boss or Workflow agent with the consolidated scope: the original brief, every later directive, the prior agent's report and its branch. Resume an existing agent only when the work needs state that is costly to move (its uncommitted worktree, a process it runs).
- Route every agent by the GOAT table (triage, quick, build, deep, verifier; escalate only after a failed check). The upstream per-role model slugs do not apply.
- You own every agent's output: read the diff yourself and write your own summary. A second opinion is the same prompt to a different model (Codex, read-only); agreement between them is strong signal.
Writing the reply
- Short declarative sentences, one thought each. Terse never drops content: details, trade-offs, choices and open decisions all stay.
- Say first who the work is for and what changes for them, then what the next maintainer inherits.
- Every claim carries its label in the same sentence: measured, inferred or guess. A prediction or an unseen cause is a guess. Do not hand the owner a check you could run yourself.
- Link and cite only what you produced or read this session.
- Prose goes through
humanizerwhen it is client-facing; code comments keep only a non-obvious why.
Upstream playbooks and their Forge equivalents
| pstack playbook | Forge |
| Investigation | forge-deeplearn (read-only) |
| Bug fix, runtime forensics | forge-debug |
| Perf issue, Hillclimb | /forge-autoresearch |
| Feature, Refactoring | forge-router with the matching playbook, ponytail |
| Prototype | a sketch in _scratch/ or a worktree |
| Authoring a skill, Eval | forge-skill-authoring, forge-skill-testing |
| Multi-phase plan, Orchestrate | /forge-plan-large, forge-team-orchestration |
| Autonomous run | forge-nightshift (opt-in queue) |
| Pause safely, Session pickup | forge-snapshot, forge-context |
| Babysit, Shipping, Opening a PR, Autopilot | not adopted: merging, landing and pushing stay with the Lead and the owner |
Excluded from upstream
The SessionStart and PreToolUse hooks and their awk, shell and PowerShell scripts; the plugin manifests and
install commands of both the Cursor original and the Claude port; the model slugs and the /setup-pstack
configuration; "use any MCP tool" and external actions without asking; the auto-merge Shipping and Autopilot
playbooks; the formal-verification skills; Cursor-specific skill names. None of it was copied or run.
Provenance
Rewritten in Forge words (pattern adapted; no sentence copied verbatim). Fetched read-only with gh api on
2026-11-05, scanned for hidden Unicode (clean), treated as untrusted data.
| Source | Path | Pinned SHA | Licence | Taken | Excluded |
| cursor/plugins (pstack, Lauren Tan) | harness/pstack/claude-code/skills/poteto-mode/SKILL.md, docs/guide/08-principles.md, agents/poteto-agent.md | bb68f2365eceafa0cb2d253112f675acf5f144cc | MIT | goal restatement, principle index and the "name the decision it changed" rule, fork classification before asking, candour, fresh agents with consolidated scope, owning delegate output, reply style with evidence labels | everything in "Excluded from upstream" above; the 24 leaf principle skills and the playbook files themselves were not adopted |
| michael-denyer/pstack-claude | README.md | 2f789d9d483d7bd800da4bbf3bc0ea7b27e907d9 | MIT | vetting only: confirms the port tracks upstream and adds a routing SessionStart hook | the whole port (plugin install, hooks, forks); nothing taken |
MIT notice: "Permission is hereby granted, free of charge, to any person obtaining a copy of this software ... The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND." Copyright (c) 2026 Lauren Tan (LICENSE at the pinned SHA); the port adds Copyright (c) 2026 Michael Denyer.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

