Parser rejects SKILL.md with leading HTML comments

Author: tomrccCreated May 29, 2026Updated May 29, 2026

skills add fails when SKILL.md has anything before the opening ---, even an HTML comment.

Repro:
npx skills add Shopify/agent-skills --skill shopify-hydrogen # Repository cloned
# No valid skills found.

Each Shopify SKILL.md starts with a <!-- AUTO-GENERATED ... --> banner above valid frontmatter. gray-matter, Jekyll, Hugo all skip leading whitespace and HTML comments before locating the block — could this parser do the same? Would unblock any source that prefixes generated banners, not just Shopify's.

Source: vercel-labs/agent-skills