agentleFS
ForgeyClapForgeyClap/Forge-Core/.claude/skills/poteto-mode/SKILL.md

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

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.
  • ianclearySkill

    poteto-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

  • bnemaSkill

    setup-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

  • eryzerzSkill

    make-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

  • tristanphvnSkill

    ketchup-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

  • ianclearySkill

    principle-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

  • TheOnlyFusionCubeSkill

    statechart

    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

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
  1. Distinctive:

    If the evidence rules out the change the owner asked for, show the evidence and stop there.

    line 20
  2. Distinctive:

    Put the same goal sentence at the top of every Boss or Workflow agent brief and of the final report.

    line 21
  3. Distinctive:

    Every claim carries its label in the same sentence: measured, inferred or guess.

    line 88

“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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

  1. 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.
  2. If the evidence rules out the change the owner asked for, show the evidence and stop there.
  3. 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.

PrincipleApply whenForge home
Laziness protocolsizing a diff, tempted to add a layerponytail
Foundational thinkingbefore logic: core types, data shapes, what concurrent actors shareforge-brainstorm
Redesign from first principlesa new requirement meets an old designforge-brainstorm
Attack the premisetwo fixes on one premise failedforge-debug (3-strike rule)
Subtract before you addsequencing an addition or rewrite: remove dead weight firstponytail
Minimise reader loadcode hard to trace: collapse one-caller wrappers, shrink mutable scopeforge-code-review
Outcome-oriented executionplanned migrations: converge on the target, no throwaway compatibility statesforge-migration
Experience firstproduct or UX trade-offsforge-craft
Exhaust the design spacea novel decision with no precedent: two or three prototypes, then compareforge-brainstorm, forge-council
Build the levernon-trivial work: write the script that does or proves ita tested .cjs in .claude/forge-bin/
Model the domainstateful or branchy code: one structure (state machine, table, reducer) instead of scattered conditionalsBuild Boss
Boundary disciplinevalidation and error handling: guard at the boundary, trust internal typesforge-security-review
Type-system disciplinedesigning types: illegal states unrepresentable, parse external data at the edgeBuild Boss
Idempotent operationscommands and loops that can crash and retryforge-n8n, forge-payments
Migrate callers, then delete the legacy APIa new internal API while old callers exist: one waveforge-migration
Separate before serialising shared stateconcurrent writers on one file, branch or key: remove the sharing firstforge-worktrees
Prove it worksbefore "done": the real artifact, not a proxyforge-verify
Fix root causesdebuggingforge-debug
Sequence verifiable unitsmulti-step work: each small unit ends in a checkforge-team-orchestration
Test behaviour, not implementationwriting or keeping a testforge-testing
Explain the numberbefore trusting or reporting any measured number/forge-autoresearch
Guard the context windowbig outputs and fan-out: bulk work to fresh agents, summaries in the main threadforge-context
Never block on the ownerreversible work: proceed, show the resultthe autonomy rules
Encode lessons in structurethe same instruction written a second time: make it a check, test or scriptthe 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 humanizer when it is client-facing; code comments keep only a non-obvious why.

Upstream playbooks and their Forge equivalents

pstack playbookForge
Investigationforge-deeplearn (read-only)
Bug fix, runtime forensicsforge-debug
Perf issue, Hillclimb/forge-autoresearch
Feature, Refactoringforge-router with the matching playbook, ponytail
Prototypea sketch in _scratch/ or a worktree
Authoring a skill, Evalforge-skill-authoring, forge-skill-testing
Multi-phase plan, Orchestrate/forge-plan-large, forge-team-orchestration
Autonomous runforge-nightshift (opt-in queue)
Pause safely, Session pickupforge-snapshot, forge-context
Babysit, Shipping, Opening a PR, Autopilotnot 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.

SourcePathPinned SHALicenceTakenExcluded
cursor/plugins (pstack, Lauren Tan)harness/pstack/claude-code/skills/poteto-mode/SKILL.md, docs/guide/08-principles.md, agents/poteto-agent.mdbb68f2365eceafa0cb2d253112f675acf5f144ccMITgoal 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 labelseverything in "Excluded from upstream" above; the 24 leaf principle skills and the playbook files themselves were not adopted
michael-denyer/pstack-claudeREADME.md2f789d9d483d7bd800da4bbf3bc0ea7b27e907d9MITvetting only: confirms the port tracks upstream and adds a routing SessionStart hookthe 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.