SKILL.md starts with HTML comment, breaks strict frontmatter parsers
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 68/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Quiet
- Tech stack
- javascript
- Domain
- tooling
Research direction
Start by locating the generator that produces SKILL.md files and reproduce the failure with npx skills add Shopify/agent-skills --skill shopify-hydrogen. Update the generated output so the opening --- is line 1, then rerun the command and confirm the skill is detected by the strict parser.
Written by the indexing model from the issue text.
Description
All SKILL.md files lead with the AUTO-GENERATED banner before the --- delimiter. Strict parsers (incl. vercel-labs/skills) require --- at line 1.
Repro:
npx skills add Shopify/agent-skills --skill shopify-hydrogen
# Repository cloned
# No valid skills found. Skills require a SKILL.md with name and description.
Fix options in the generator (either works):
- Move the banner inside the frontmatter as a YAML comment:
# AUTO-GENERATED ... - Move it after the closing
---.
- Dominant language
- JavaScript
- Stars
- 82
- Forks
- 20
- PR merge metrics
- No merged PRs in 30d
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Shopify/agent-skills
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
Shopify/agent-skills#8 · 1 reaction ·
-
Difficulty 5/5 Over a week Newbie friendliness 42/100
Shopify/agent-skills#9 · 3 comments ·
-
Difficulty 3/5 1-2 days Newbie friendliness 52/100
Shopify/agent-skills#7 ·
-
Difficulty 3/5 1-2 days Newbie friendliness 72/100
Shopify/agent-skills#6 · 1 reaction ·
-
Difficulty 4/5 3-5 days Newbie friendliness 48/100
Shopify/agent-skills#5 ·
All issues in Shopify/agent-skills
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
HarperFast/skills#96 ·
-
[Block] Latest Posts [Type] Bug
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Automattic/studio#4908 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
sugarlabs/musicblocks#8847 ·