shoelace-style/webawesome

Claude doesn't like XML tags in SKILL.md

Aperta

#2558 aperta il 26 giu 2026

 (0 commenti) (1 reazione) (0 assegnatari)TypeScript (185 fork)github user discovery
buggood first issuehelp wanted

Metriche repository

Star
 (1293 stelle)
Metriche merge PR
 (Merge medio 1g 15h) (67 PR mergiate in 30 g)

Descrizione

From Discord:


I am just starting to experiment with the Web Awesome AI skills. I ran into one issue right away. When I tried to upload the webawesome-design skill in Claude.ai > Customize > Skills, I got an error:

SKILL.md description cannot contain XML tags

The problem turned out to be the use of angle brackets in mentions of <wa-tag> in the SKILL.md YAML description. Apparently the Claude.ai validator didn't like that. The solution is to remove the angle brackets and just use wa-tag in the skill description. Note the angle brackets are only an issue in the YAML description not in the body.

This is probably not an issue for using the skill locally in Claude Code. But it is an issue for using the skill in Claude.ai Projects and possibly in Claude Design. Here are the details in a Claude conversation:

https://claude.ai/share/860bc4b3-bbe0-4935-ba69-802b2f53af1c

Guida contributor