Repository navigation
feat: rewrite poteto-help for Claude Code and lint relative links - #15
Merged
Merged
Conversation
lucasheriques
force-pushed
the
help-and-link-lint
branch
2 times, most recently
from
October 6, 2026 21:35
4ed3da8 to
b0c6ad0
Compare
lucasheriques
marked this pull request as ready for review
October 6, 2026 21:36
poteto-help was dropped as Cursor-only. This ports it: install and update via claude plugin, models.md instead of /setup-pstack, the README's merge-policy section, /pstack: command names, and public GitHub links. The Cursor-specific setup, Custom Modes, and guide pages are gone. check-port.ts now fails on a relative markdown link that does not resolve, which is how dead principle links shipped in the last sync. Tested: bun test ./scripts/check-port.test.ts (50 pass, red first for the new rule); bun scripts/check-port.ts (0 findings); claude plugin validate .; claude -p probe of /pstack:poteto-help answered the question without starting work. The probe also caught that the merge-policy README section only exists in the CI PR, so this branch is stacked on it.
…ode folklore from poteto-help The link rule ignored fenced blocks and inline code wrongly, missed titled links, and skipped the README. poteto-help no longer says a new-task phrase resets the mode, and its playbook triggers match poteto-mode's own wording. It tells the model to link repo-relative paths. Tested: bun test ./scripts/check-port.test.ts (54 pass, red first); bun scripts/check-port.ts (0 findings).
…arry-overs Recipes that opened mid-sentence with /pstack:how or /pstack:arena never expanded the slash command, and those skills are not model-invocable. The new-task phrase, the restart row, and the /loop duration wording came from Cursor modes. The plugin-update overwrite of models.md is now documented. Tested: bun scripts/check-port.ts (0 findings); bun test ./scripts/check-port.test.ts (54 pass).
lucasheriques
force-pushed
the
help-and-link-lint
branch
from
October 6, 2026 21:54
b0c6ad0 to
1513737
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
poteto-helpwas dropped as Cursor-only, which leaves new users with no router to the right skill. The last sync also shipped dead principle links because nothing checked them.What changed
skills/poteto-help/rewritten for Claude Code:claude plugininstall and update,models.mdfor model choice, the README's merge-policy section,/pstack:command names, public GitHub links, and a troubleshooting row formerge-gaterefusals.prompting.mdandrecipes.mdcarried over with namespaced commands.check-port.tsfails on a relative markdown link that does not resolve.sync-upstream, andtranslation.mdrecord that the skill is rewritten, not mirrored.Scope
Stacked on #14, which adds the README section this skill points at. Retargets to
mainwhen #14 merges.Verification
bun test ./scripts/check-port.test.ts: 50 pass, red first for the link rule.bun scripts/check-port.ts: 0 findings.claude plugin validate .passes.claude -p "/pstack:poteto-help which skill reviews a PR, and how do I let agents merge?"answered without starting work, and caught the missing README section that motivated the stack.