Skip to content

feat(pstack): add prompting references to /poteto-help - #507

Merged
poteto merged 1 commit into
mainfrom
lauren/poteto-help-tips
Oct 5, 2026
Merged

poteto merged 1 commit into
mainfrom
lauren/poteto-help-tips

Conversation

@poteto

@poteto poteto commented Oct 5, 2026 •

Copy link
Copy Markdown
Collaborator

Why

/poteto-help tells the user that a good prompt states the goal and how to tell it's done, then links the guide. The agent that answers has no dense rules or templates to draft a prompt from. This PR packs the prompting advice from the guide and the prompting post into two reference files.

What changed

  • Add pstack/skills/poteto-help/references/prompting.md, the rules for a prompt: the goal, the done check, the constraints, the context, design before the plan, short follow-ups, stepping away, and one-line steers.
  • Add pstack/skills/poteto-help/references/recipes.md, short prompt templates for each kind of job.
  • SKILL.md points at the two files in four places and keeps disable-model-invocation: true. Bump pstack to 0.15.12.

Scope

  • The files name no person and copy no long passage.
  • The README, the guide, and the skill table do not change.

Blast Radius

Only a typed /poteto-help reads the new files. Other sessions do not change.

Verification

  • quick-validate.mjs, lint-skill-frontmatter.mjs, and scripts/validate-plugins.mjs pass.
  • A check script resolves all 44 relative links and matches all 113 slash commands to a pstack skill. It finds no internal names, long dashes, or curly quotes.

Note

Low Risk
Documentation and skill-routing only inside /poteto-help; no runtime or workflow code changes.

Overview
Adds dense prompting guidance so /poteto-help can draft user prompts instead of only pointing at the guide.

New reference docs: references/prompting.md covers what to put in a prompt (goal, pass/fail done check, proof, constraints), what to omit, context-loading habits, design-before-plan, short follow-ups, overnight//loop setup, and one-line steers when a run drifts. references/recipes.md lists copy-ready templates by job (understand, build, design/plan, review/ship, away/back).

poteto-help SKILL.md now routes setup, /poteto-mode wording, drift recovery, and reply examples through those files. Plugin version bumps to 0.15.12.

Only sessions that invoke /poteto-help load the new content; other skills and the README/guide are unchanged.

Reviewed by Cursor Bugbot for commit a7c26a7. Bugbot is set up for automated code reviews on this repo. Configure here.

Pack the guide and the prompting post into two dense reference files.
prompting.md holds the rules for a prompt: the goal, the done check, the
constraints, the context, and one-line steers. recipes.md holds short
prompt templates for each kind of job.

SKILL.md stays lean and points at the files where a user words a
prompt, steers a run, or needs an example. Bump pstack to 0.15.12.
@poteto
poteto merged commit 807c031 into main Oct 5, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants