Habilidade Mote
A habilidade mote ensina agentes de IA quando e como publicar Markdown com Mote — ela não contém implementação de upload própria (aciona a CLI ou as ferramentas MCP).
Habilidades são instaláveis através do ecossistema skills CLI.
Instalação
npx skills add flc1125/mote
Variantes úteis:
# Visualizar o que o repositório oferece
npx skills add flc1125/mote --list
# Instalar para agentes específicos
npx skills add flc1125/mote -a claude-code -a codex
# Não interativo (CI)
npx skills add flc1125/mote --skill mote -g -a claude-code -y
A habilidade está em skills/mote/SKILL.md neste repositório.
Ela inclui metadados de exibição do Codex em agents/openai.yaml e ícones Mote agrupados
em assets/, para que a marca permaneça disponível quando apenas o diretório da habilidade for
instalado. Outros clientes podem usar SKILL.md sem esses metadados de interface opcionais.
A arte da marca é mantida em docs/assets; execute node scripts/brand/sync.mjs
após alterá-la. A verificação de marca existente também confirma as cópias dos ícones da habilidade.
O que faz
Uma vez instalado, um agente solicitado a publicar Markdown online ou criar uma URL compartilhável irá:
- Verificar imagens locais e escolher um caminho de publicação configurado.
publish_markdownaceita texto e URLs de imagens remotas; imagens locais exigem a CLI oupublish_markdown_filelocal, com caminhos resolvidos relativamente ao arquivo Markdown. - Publicar e analisar o resultado
- Retornar a URL exatamente como fornecida
Também codifica as proteções: nunca publicar credenciais/segredos (URLs Mote são capacidades e documentos são imutáveis), respeitar limites de tamanho e relatar erros honestamente.
Ler, editar ou visualizar um documento local por si só não aciona a publicação. Links para outros documentos locais não publicam esses documentos automaticamente. Para fórmulas, diagramas e outras extensões, consulte a referência de compatibilidade e o exemplo ao vivo. Sintaxe não suportada pode permanecer como código-fonte legível mesmo quando a publicação é bem-sucedida.
Requisitos
A habilidade em si é apenas instruções — publicar ainda precisa de:
- O pacote mote-cli ou uma compilação a partir da fonte, com configuração de autenticação explícita ou um login OAuth Mote válido (consulte a referência da CLI e autenticação). Usuários auto-hospedados devem manter sua configuração de instância pretendida, ou
- Um servidor MCP Mote conectado (consulte o guia MCP)
Apenas o servidor local expõe publish_markdown_file. Falhas de autenticação devem ser informadas ao usuário; a habilidade não cria credenciais, inicia login no navegador sem autorização, lê o chaveiro de outro cliente ou alterna para um token antigo. Solicitações explícitas de ajuda para login podem ser tratadas dentro do escopo autorizado do usuário. Não repita uma publicação após um tempo limite ou resultado desconhecido sem antes resolver se ela foi bem-sucedida.