Cómo no usar skills portátiles

Las skills fallan en silencio cuando la descripción es vaga, el archivo es enorme o tratas la página de la tienda como la herramienta de trabajo. Estos son los errores que malgastan una sesión — honestos, no sermones.

No trates el hub ni un companion como la herramienta de trabajo.

El hub lista packs. Una página companion es Setup: copiar o descargar. Ninguna dibuja un wireframe, ejecuta una auditoría ni captura breakpoints. Para esos trabajos, abre la herramienta del navegador coincidente o deja que la skill instalada se ejecute en tu agente.

No instales una vez y descargues la misma skill como un segundo flujo.

Ejecuta npx skills@latest add iruhdam1/skills o descarga un pack desde el companion — no ambos para la misma skill. Dos copias divergen; el agente puede cargar la obsoleta.

No escribas descripciones en primera persona ni vagas.

Claude y otros hosts descubren skills desde el campo description. La primera persona (“I help you…”) o un alcance vacío hacen que el agente nunca elija el archivo. Escribe qué hace y cuándo usarla, en tercera persona. Las notas de autoría de Anthropic cubren la misma regla.

No satures SKILL.md con todo.

Mantén el cuerpo como un procedimiento. Pon las notas largas un nivel más abajo en un archivo de referencia hermano para que los hosts las carguen solo cuando haga falta. Un muro de texto quema contexto y oculta el disparador.

No copies .agents/skills de la tienda ni edites Analog.

La carpeta .agents/skills de esta tienda (COSS, Phosphor y otros ayudantes del agente) no es el pack público. No la copies. No edites Analog. El conjunto público es el pack de GitHub listado en el hub.

No persigas un listado ausente en skills.sh.

skills.sh es un listado público más telemetría de instalación. Un distintivo ausente no es un push fallido a GitHub. Usa GitHub o el companion de la tienda si un pack aún no está listado. Consulta skills.sh vs GitHub.