Skip to content

fix(skills): quote v4→v5 migration skill description so it parses as YAML - #3779

Merged
VaguelySerious merged 1 commit into
vercel:mainfrom
SergioDiez:fix/skill-yaml-frontmatter-syntax
Aug 25, 2026
Merged

fix(skills): quote v4→v5 migration skill description so it parses as YAML#3779
VaguelySerious merged 1 commit into
vercel:mainfrom
SergioDiez:fix/skill-yaml-frontmatter-syntax

Conversation

@SergioDiez

Copy link
Copy Markdown
Contributor

Description

npx skills add vercel/workflow fails for every skill in the repo:

■  Nested mappings are not allowed in compact mappings at line 2, column 14:
│  description: Upgrades an app from Workflow SDK 4.x to 5.0. Use when bumping the…

The description in skills/migrating-workflow-v4-to-v5/SKILL.md is a plain YAML scalar that ends with `mode: 'client'`. The : inside it is parsed as a nested mapping, so the frontmatter is invalid. The skills CLI parses every SKILL.md, blocking all of 6 skills from being installed.

This PR turns the description into a folded block scalar (>-).

Fixes #3776.

How did you test your changes?

  • npx skills add <local clone> --list now enumerates all six skills; on main it aborts on this file.
  • Parsed the frontmatter with PyYAML: the description round-trips intact.

PR Checklist - Required to merge

  • 📦 pnpm changeset was run to create a changelog for this PR
    • Use the correct semver bump type: patch for bug fixes, minor for new features, major for breaking changes.
    • Use pnpm changeset --empty if you are changing documentation or workbench apps
  • 🔒 DCO sign-off passes (run git commit --signoff on your commits)
  • 📝 Ping @vercel/workflow in a comment once the PR is ready, and the above checklist is complete
@SergioDiez
SergioDiez requested a review from a team as a code owner August 25, 2026 12:33
@changeset-bot

changeset-bot Bot commented Aug 25, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: e909e0c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel

vercel Bot commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

@SergioDiez is attempting to deploy a commit to the Vercel Labs Team on Vercel.

A member of the Team first needs to authorize it.

…YAML

Signed-off-by: Sergio Diez <sergiodiez@users.noreply.github.com>
@SergioDiez
SergioDiez force-pushed the fix/skill-yaml-frontmatter-syntax branch from bc1ec73 to e909e0c Compare August 25, 2026 12:44

@VaguelySerious VaguelySerious left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ty

@VaguelySerious
VaguelySerious merged commit 66af295 into vercel:main Aug 25, 2026
5 of 23 checks passed
@SergioDiez
SergioDiez deleted the fix/skill-yaml-frontmatter-syntax branch August 25, 2026 20:23
@github-actions

Copy link
Copy Markdown
Contributor

No backport to stable for 66af295 (AI decision).

The only substantive change is to skills/migrating-workflow-v4-to-v5/SKILL.md, and skills/ is not maintained on the stable branch; the other file is an empty changeset (release plumbing). The skill itself describes migrating from v4 to v5, which is meaningless content for the maintenance line.

To override, re-run the Backport to stable workflow manually via workflow_dispatch and paste this commit SHA into the ref input:

66af29559073f7c5849d053c8c70c5fae3203369
VaguelySerious added a commit that referenced this pull request Aug 25, 2026
#3779 fixed the app migration skill, whose description ended with
`mode: 'client'`. The colon-space made the plain scalar parse as a nested
mapping, and the skills CLI dropped the file: `Found 5 skills`, and
`--skill migrating-workflow-v4-to-v5` answered `No matching skills
found`, which is the command whats-new.mdx tells readers to run.

The World skill's description has no colon-space today, so it parses.
It is also 590 characters of backticked identifiers, and any future
edit naming a field with its value reintroduces the break. Fold it the
same way now, while the value is known good. Verified with the yaml
package that the folded scalar is byte-identical, and with
`skills add . --skill migrating-world-v4-to-v5` that the CLI still
finds all six.

Signed-off-by: Peter Wielander <peter.wielander@vercel.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

2 participants