shoelace-style/webawesome

Claude doesn't like XML tags in SKILL.md

Open

#2558 aperta il 26 giu 2026

Vedi su GitHub
 (0 commenti) (0 reazioni) (0 assegnatari)TypeScript (157 fork)github user discovery
buggood first issuehelp wanted

Metriche repository

Star
 (1104 star)
Metriche merge PR
 (Metriche PR in attesa)

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