Skip to content

pstack: fix poteto-mode skill name to satisfy identifier constraint - #241

Open
austinchennn wants to merge 1 commit into
cursor:mainfrom
austinchennn:fix-poteto-mode-skill-name
Open

pstack: fix poteto-mode skill name to satisfy identifier constraint#241
austinchennn wants to merge 1 commit into
cursor:mainfrom
austinchennn:fix-poteto-mode-skill-name

Conversation

@austinchennn

@austinchennn austinchennn commented Aug 21, 2026

Copy link
Copy Markdown

Summary

Fixes #237.

pstack/skills/poteto-mode/SKILL.md declares name: Poteto Mode, which violates Cursor's own documented Agent Skills frontmatter constraint (name must be lowercase letters/numbers/hyphens only, and must match the parent folder name — poteto-mode). It's the only one of pstack's skills that doesn't conform.

This was introduced deliberately in #149 to give the skill a nicer slash-menu label, on the reasoning that routing derives from the folder path so the field is "just" a display label inside Cursor. That holds inside Cursor, but the Agent Skills spec defines name as the identifier, not a display label, and other spec-conformant harnesses (verified on Kiro) fail to register the skill at all when it doesn't match — silently, with no error surfaced. It also fails the skills-ref conformance validator.

Fix

Applying suggested fix option 1 from the issue: set name: poteto-mode (matches the folder, conformant) and move the human-readable label into metadata, which the documented frontmatter table designates for client-specific extras:

name: poteto-mode
metadata:
  cursor-display-name: Poteto Mode

Note

Per the issue: metadata.cursor-display-name fixes the portability break (the identifier is now spec-conformant everywhere), but I don't know whether Cursor's client currently reads that key to render the slash-menu label — if not, the menu entry may show poteto-mode instead of Poteto Mode until/unless Cursor adds that lookup (the issue's suggested fix option 2, first-class displayName support for skill frontmatter, would need Cursor-side work beyond this PR's scope).

Testing

  • No other file in the repo references this skill's name field value, so this is a self-contained, non-breaking change.
  • Not in the path set that .github/workflows/validate-plugins.yml triggers on (.cursor-plugin/marketplace.json, **/plugin.json, schemas/**), so no CI job runs against this diff; verified the YAML frontmatter parses correctly by hand.

Note

Low Risk
Frontmatter-only identifier fix on one skill file; no runtime, auth, or data-handling changes.

Overview
Makes the poteto-mode skill register on spec-conformant harnesses by setting name to poteto-mode (matching the folder) instead of the display string Poteto Mode.

The human-readable label moves to metadata.cursor-display-name. Skill body is unchanged. Cursor may still show the hyphenated identifier in the slash menu until it honors that metadata key.

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

Cursor's Agent Skills spec requires the frontmatter name field to be lowercase letters, numbers, and hyphens only, and to match the parent folder name. poteto-mode declared name: Poteto Mode, which breaks on other spec-conformant harnesses (skill fails to register silently) and fails the reference conformance validator, even though it loads fine in Cursor. Fixes cursor#237.
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.

pstack: poteto-mode name breaks the documented identifier constraint and fails to load on other harnesses

1 participant