flc1125/mote

La compétence « mote » apprend aux agents IA **quand et comment** publier du Markdown avec Mote — elle ne contient aucune implémentation de téléversement propre (elle pilote le CLI ou les outils MCP).

Qu'est-ce que mote ?

Cette compétence (skill) est conçue pour des agents IA comme Claude Code, Cursor ou Codex. Elle leur donne la capacité de publier du contenu Markdown en ligne via Mote, en générant une URL partageable. La compétence ne fait que fournir les instructions métier (décider quand publier, vérifier les images locales, respecter les limites, éviter de fuiter des secrets) et délègue l'implémentation réelle de téléversement au CLI `mote-cli` ou à un serveur MCP Mote. Elle prend en charge les environnements locaux avec `publish_markdown_file` pour les images locales et fonctionne avec des URLs distantes directement. L'installation se fait via la commande `npx skills add flc1125/mote` et la compétence peut être configurée pour différents agents en ligne de commande. Elle inclut des métadonnées d'affichage pour Codex et des icônes Mote, mais SKILL.md reste utilisable sans ces éléments optionnels.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/flc1125/mote/tree/main/docs

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence Mote

La compétence mote apprend aux agents IA quand et comment publier du Markdown avec Mote — elle ne contient aucune implémentation de téléversement propre (elle pilote le CLI ou les outils MCP).

Les compétences sont installables via le CLI de l'écosystème skills.

Installation

npx skills add flc1125/mote

Variantes utiles :

# Prévisualiser ce que le dépôt offre
npx skills add flc1125/mote --list

# Installer pour des agents spécifiques
npx skills add flc1125/mote -a claude-code -a codex

# Non interactif (CI)
npx skills add flc1125/mote --skill mote -g -a claude-code -y

La compétence se trouve dans skills/mote/SKILL.md dans ce dépôt.

Elle inclut des métadonnées d'affichage Codex dans agents/openai.yaml et des icônes Mote regroupées dans assets/, de sorte que la marque reste disponible lorsque seul le répertoire de la compétence est installé. Les autres clients peuvent utiliser SKILL.md sans ces métadonnées d'interface optionnelles. Les éléments graphiques de la marque sont maintenus dans docs/assets ; exécutez node scripts/brand/sync.mjs après les avoir modifiés. La vérification de marque existante contrôle également les copies d'icônes de la compétence.

Ce qu'elle fait

Une fois installée, lorsqu'un agent est invité à publier du Markdown en ligne ou à créer une URL partageable, il :

  1. Vérifie la présence d'images locales et choisit un chemin de publication configuré. publish_markdown accepte le texte et les URLs d'images distantes ; les images locales nécessitent le CLI ou publish_markdown_file local, avec les chemins résolus par rapport au fichier Markdown.
  2. Publie et analyse le résultat
  3. Renvoie l'URL textuellement

Elle encode également les garde-fous : ne jamais publier d'identifiants/secrets (les URLs Mote sont des capabilities et les documents sont immuables), respecter les limites de taille et signaler les erreurs honnêtement.

La lecture, l'édition ou la prévisualisation d'un document local seul ne déclenche pas de publication. Les liens vers d'autres documents locaux ne publient pas ces documents automatiquement. Pour les formules, diagrammes et autres extensions, voir la référence de compatibilité et le spécimen en direct. Une syntaxe non prise en charge peut rester une source lisible même lorsque la publication réussit.

Prérequis

La compétence elle-même n'est que des instructions — la publication nécessite encore :

  • Le paquet mote-cli ou une compilation source, avec une configuration d'authentification explicite ou une connexion OAuth Mote valide (voir référence CLI et authentification). Les utilisateurs auto-hébergés doivent conserver leur configuration d'instance prévue, ou
  • Un serveur MCP Mote connecté (voir guide MCP)

Seul le serveur local expose publish_markdown_file. Les échecs d'authentification doivent être signalés à l'utilisateur ; la compétence ne crée pas d'identifiants, n'initie pas de connexion navigateur sans autorisation, ne lit pas le trousseau d'un autre client ni ne bascule vers un ancien jeton. Les demandes explicites d'aide à la connexion peuvent être traitées dans le cadre autorisé de l'utilisateur. Ne répétez pas une publication après un délai d'attente ou un résultat inconnu sans avoir résolu la question de sa réussite.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés