Skip to content

fix: switch Windsurf SKILL header to YAML frontmatter#272

Open
ruslanlap wants to merge 6 commits intonextlevelbuilder:mainfrom
ruslanlap:fix/windsurf-frontmatter
Open

fix: switch Windsurf SKILL header to YAML frontmatter#272
ruslanlap wants to merge 6 commits intonextlevelbuilder:mainfrom
ruslanlap:fix/windsurf-frontmatter

Conversation

@ruslanlap
Copy link
Copy Markdown

@ruslanlap ruslanlap commented Apr 21, 2026

Summary

The original Windsurf issue was caused by generated SKILL.md header format. This PR keeps the Windsurf YAML-frontmatter fix and adds repo-level safeguards so similar template drift does not affect other platforms.

What changed

  • ensure Windsurf template keeps YAML frontmatter generation (name + description)
  • expand sync:assets to sync all platform templates from src/ui-ux-pro-max/templates/platforms to cli/assets/templates/platforms
  • add validate-platform-templates guard to verify:
    • src/assets platform template file lists match
    • every src/assets platform template JSON is identical
    • frontmatter shape is valid when present
    • Windsurf specifically still requires non-empty frontmatter
  • enforce guard in both:
    • cli/package.json prepublishOnly
    • .github/workflows/template-guard.yml on PRs/pushes

User impact

  • Windsurf users get the correct SKILL.md header format by default
  • template mismatches for any platform are caught before publish/merge, reducing the chance of broken generated skills for other users

Windsurf requires the generated SKILL.md header to use the corrected\nname and description metadata so the skill loads reliably.\n\nSync the Windsurf template change in both the source template and\nthe bundled CLI assets.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@ruslanlap ruslanlap changed the title fix: correct Windsurf skill frontmatter metadata fix: generate YAML frontmatter for Windsurf skill Apr 21, 2026
Align the Windsurf skill description with the canonical data used by\nsearch: 161 color palettes and 16 technology stacks.\n\nKeep the YAML frontmatter fix, but avoid introducing stale counts in\nthe generated SKILL.md metadata.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@ruslanlap ruslanlap changed the title fix: generate YAML frontmatter for Windsurf skill fix: switch Windsurf SKILL header to YAML frontmatter Apr 21, 2026
ruslanlap and others added 4 commits April 22, 2026 02:25
Prevent Windsurf SKILL.md header regressions by enforcing template\nfrontmatter checks and source->asset sync checks.\n\n- add sync script for windsurf template into cli/assets\n- add validation script that requires frontmatter and src/assets parity\n- run sync+validation in prepublishOnly\n- add CI workflow to fail if Windsurf template drifts or frontmatter is missing

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Expand template guard from Windsurf-only to all platform templates.\n\n- sync all platform template JSON files from src to cli/assets\n- validate src/assets parity for every platform template file\n- keep Windsurf-specific frontmatter requirement for SKILL.md compatibility\n- enforce guard in CI and prepublish pipeline

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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.

1 participant