Revisar si un SKILL.md es portable entre asistentes

Copia el prompt, pégalo en tu chatbot y sustituye los textos entre corchetes por tu material. El asistente responderá en español.

Escribe toda tu respuesta en español. Mantén en su idioma original cualquier texto citado de las fuentes.

Revisas el archivo principal de una Agent Skill para detectar problemas de portabilidad y errores comunes, solo leyendo. Cita la línea que hay detrás de cada hallazgo. Nunca afirmes que el skill es válida o portable y no inventes hallazgos.

Comprueba:
1. Errores: encabezado (frontmatter) ausente o sin cerrar; encabezado que un analizador YAML estricto rechazaría (un ": " o " #" sin comillas dentro de la descripción, una comilla sin cerrar, una línea con sangría suelta); falta de name o de description; un name que no sea de letras minúsculas, dígitos y guiones simples o que supere los 64 caracteres (y, si puedes saberlo, que no coincida con el nombre de la carpeta); una descripción de más de 1024 caracteres; enlaces markdown a archivos que probablemente no existen.
2. Advertencias: claves del encabezado distintas de name y description (license, compatibility y metadata son claves de la especificación: anótalas; allowed-tools y otras son propias de cada herramienta); una descripción que no dice cuándo usar el skill ("Úsala cuando el usuario diga ..."); nombres de herramientas de un fabricante (WebFetch, Skill tool, Bash(...), mcp__) y rutas de un fabricante (.claude/, .cursor/); un cuerpo que depende de la web, de una consola o de un script pero nunca dice qué hacer cuando no está disponible; texto como $ARGUMENTS o $0 que algunas herramientas sustituyen; un cuerpo que parece superar las 500 líneas.
3. Para cada hallazgo da la línea, por qué importa en una frase y el texto exacto de reemplazo.
4. Termina con lo que no pudiste comprobar leyendo (si las instrucciones funcionan, si el skill se activa, los archivos que no estén en lo que pegué).
No edites nada.

Este es mi archivo de el skill:

Our own public skills repository on 2026-10-04: it had grown to 15 skills, and a new one was skipped by npx skills add proskillpacks/skills --list with a YAML error. The same rule, run over our whole tree of 57 skills, found 7 descriptions with an unquoted colon (now fixed), and the checker's other warnings led us to add fallback sentences and remove a vendor tool name.

After (skill output, excerpt):
$ python3 scripts/skill_check.py proskillpacks-skills/skills --quiet
skill errors warnings lines scripts
accessibility-quick-audit 0 0 39 -
changelog-from-commits 0 0 39 -
readme-first-run-check 0 0 39 -
agent-ready-quick-check 0 0 64 Python
late-payment-chaser-uk 0 0 109 Python
...
15 skill(s): 0 error(s), 0 warning(s)

$ python3 scripts/skill_check.py examples/bad-yaml-colon/SKILL.md
ERROR frontmatter: line 3: description: unquoted ': ' inside the value (strict YAML reads it as a nested mapping). Quote the value or reword

• Lee archivos; no puede saber si las instrucciones de un skill funcionan ni si se activa.
• Las advertencias son riesgos de portabilidad, no prueba de que algo falle.
• Las listas de patrones propios de cada fabricante no son exhaustivas.