shoelace-style/webawesome

Claude doesn't like XML tags in SKILL.md

Open

#2.558 aberto em 26 de jun. de 2026

Ver no GitHub
 (0 comments) (0 reactions) (0 assignees)TypeScript (157 forks)github user discovery
buggood first issuehelp wanted

Métricas do repositório

Stars
 (1.104 stars)
Métricas de merge de PR
 (Métricas PR pendentes)

Description

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

Guia do colaborador

Direção de pesquisa
Edite o arquivo SKILL.md para remover os colchetes angulares da descrição YAML. Substitua <wa tag> por wa tag.
Pilha de tecnologia
typescript
Domain
frontenddocumentation
Tipo Issue
Bug
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
1
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
Menos de 1 hora
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
Git
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
95