Habilidad Mote
La habilidad mote enseña a los agentes de IA cuándo y cómo publicar Markdown con Mote — no contiene implementación de carga propia (impulsa la CLI o las herramientas MCP).
Las habilidades se instalan mediante el ecosistema de la CLI skills.
Instalación
npx skills add flc1125/mote
Variantes útiles:
# Vista previa de lo que ofrece el repositorio
npx skills add flc1125/mote --list
# Instalar en agentes específicos
npx skills add flc1125/mote -a claude-code -a codex
# No interactivo (CI)
npx skills add flc1125/mote --skill mote -g -a claude-code -y
La habilidad se encuentra en skills/mote/SKILL.md en este repositorio.
Incluye metadatos de visualización de Codex en agents/openai.yaml e iconos de Mote empaquetados
en assets/, de modo que la marca permanezca disponible cuando solo se instala el directorio de la habilidad.
Otros clientes pueden usar SKILL.md sin estos metadatos de interfaz opcionales.
El arte de la marca se mantiene en docs/assets; ejecute node scripts/brand/sync.mjs
después de modificarlo. La verificación de marca existente también comprueba las copias de los iconos de la habilidad.
Qué hace
Una vez instalado, un agente al que se le pida publicar Markdown en línea o crear una URL compartible:
- Verifica las imágenes locales y elige una ruta de publicación configurada.
publish_markdownacepta texto y URLs de imágenes remotas; las imágenes locales requieren la CLI opublish_markdown_filelocal, con rutas resueltas relativas al archivo Markdown. - Publica y analiza el resultado
- Devuelve la URL textualmente
También codifica los guardarraíles: nunca publicar credenciales/secretos (las URLs de Mote son capacidades y los documentos son inmutables), respetar los límites de tamaño e informar errores de forma honesta.
Leer, editar o previsualizar un documento local por sí solo no desencadena la publicación. Los enlaces a otros documentos locales no publican esos documentos automáticamente. Para fórmulas, diagramas y otras extensiones, consulte la referencia de compatibilidad y el ejemplar en vivo. La sintaxis no compatible puede permanecer como código fuente legible incluso cuando la publicación tiene éxito.
Requisitos
La habilidad en sí es solo instrucciones — publicar aún necesita:
- El paquete mote-cli o una compilación desde el código fuente, con configuración de autenticación explícita o un inicio de sesión OAuth de Mote válido (consulte la referencia de CLI y autenticación). Los usuarios autohospedados deben mantener su configuración de instancia prevista, o
- Un servidor MCP de Mote conectado (consulte la guía MCP)
Solo el servidor local expone publish_markdown_file. Los fallos de autenticación deben comunicarse al usuario; la habilidad no crea credenciales, inicia un inicio de sesión en el navegador sin autorización, lee el llavero de otro cliente ni cambia a un token antiguo. Las solicitudes explícitas de asistencia para iniciar sesión pueden gestionarse dentro del ámbito autorizado del usuario. No repita una publicación después de un tiempo de espera o un resultado desconocido sin resolver si tuvo éxito.