Skip to content

react-view-transitions: plain-prose description for upload validator#244

Open
mvanhorn wants to merge 1 commit intovercel-labs:mainfrom
mvanhorn:fix/214-skill-description-xml-tags
Open

react-view-transitions: plain-prose description for upload validator#244
mvanhorn wants to merge 1 commit intovercel-labs:mainfrom
mvanhorn:fix/214-skill-description-xml-tags

Conversation

@mvanhorn
Copy link
Copy Markdown
Contributor

Closes #214.

Claude's skill upload validator rejects SKILL.md when the description: frontmatter contains XML tags ("SKILL.md description cannot contain XML tags"). The react-view-transitions description had backtick-wrapped XML-style tokens like `<ViewTransition>` that the validator treats as XML.

Change

skills/react-view-transitions/SKILL.md:

-description: Guide for implementing smooth, native-feeling animations using React's View Transition API (`<ViewTransition>` component, `addTransitionType`, ...).
+description: Guide for implementing smooth, native-feeling animations using React's View Transition API (the `ViewTransition` component, `addTransitionType`, ...).

Same intent, same trigger phrases (the description still mentions ViewTransition, startViewTransition, transition types, etc.), no < / > characters.

Repackaged skills/react-view-transitions.zip from the updated source so the published artifact matches.

Sweep

Checked every skills/*/SKILL.md description: field; only this one was affected.

Note (out of scope for this PR)

If the maintainers want to enforce this at build time, a check in packages/react-best-practices-build/src/validate.ts (or a sibling skill validator) could reject XML tokens in description: fields before zipping. Happy to file a follow-up PR if interested.

…ator

Closes vercel-labs#214.

Claude's skill upload validator rejects SKILL.md when the description
frontmatter field contains XML tags ("SKILL.md description cannot
contain XML tags"). The description had backtick-wrapped XML-style
tokens like \`<ViewTransition>\` that the validator treats as XML.

Rewrites the offending tokens in plain prose ("the `ViewTransition`
component" instead of "`<ViewTransition>` component"), preserving the
same intent and trigger phrases. Other places in the SKILL.md that
already used the bare component name (`ViewTransition`) are unchanged.

Repackaged skills/react-view-transitions.zip from the updated source.
Swept all other skills/*/SKILL.md descriptions; none had the same
issue.
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 27, 2026

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

A member of the Team first needs to authorize it.

@mvanhorn mvanhorn changed the title fix(react-view-transitions): plain-prose description for upload validator react-view-transitions: plain-prose description for upload validator Apr 27, 2026
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.

Upload Fails with "SKILL.md description cannot contain XML tags" Error

1 participant