flc1125/docs

Mote 스킬

mote 스킬은 AI 에이전트가 Markdown을 Mote로 게시하는 시기와 방법을 가르칩니다. 자체적인 업로드 구현은 없으며 CLI 또는 MCP 도구를 구동합니다.

스킬은 skills 에코시스템 CLI를 통해 설치할 수 있습니다.

설치

npx skills add flc1125/mote

유용한 변형:

# 저장소가 제공하는 항목 미리보기
npx skills add flc1125/mote --list

# 특정 에이전트에 설치
npx skills add flc1125/mote -a claude-code -a codex

# 비대화형 (CI)
npx skills add flc1125/mote --skill mote -g -a claude-code -y

스킬은 이 저장소의 skills/mote/SKILL.md에 위치합니다.

agents/openai.yaml에 Codex 표시 메타데이터가 포함되어 있고, assets/에 번들된 Mote 아이콘이 있으므로 스킬 디렉토리만 설치되어 있어도 브랜딩을 유지할 수 있습니다. 다른 클라이언트는 이 선택적 UI 메타데이터 없이 SKILL.md를 사용할 수 있습니다. 브랜드 아트워크는 docs/assets에서 관리되며, 변경 후 node scripts/brand/sync.mjs를 실행하세요. 기존 브랜드 검사는 스킬의 아이콘 복사본도 확인합니다.

하는 일

설치 후, 에이전트가 Markdown을 온라인에 게시하거나 공유 가능한 URL을 만들라는 요청을 받으면:

1. 로컬 이미지를 확인하고 구성된 게시 경로를 선택합니다. publish_markdown은 텍스트와 원격 이미지 URL을 허용합니다. 로컬 이미지는 CLI 또는 로컬 publish_markdown_file이 필요하며, 경로는 Markdown 파일 기준으로 해석됩니다.
2. 게시하고 결과를 파싱합니다.
3. URL을 그대로 반환합니다.

또한 보호 조치를 인코딩합니다: 자격 증명/비밀은 절대 게시하지 않으며(Mote URL은 기능이며 문서는 변경 불가능), 크기 제한을 준수하고, 오류를 정직하게 보고합니다.

로컬 문서를 읽거나 편집하거나 미리보기만 해도 게시가 촉발되지 않습니다. 다른 로컬 문서에 대한 링크는 해당 문서를 자동으로 게시하지 않습니다. 수식, 다이어그램 및 기타 확장 기능은 호환성 참조와 라이브 견본을 참조하세요. 지원되지 않는 구문은 게시에 성공하더라도 읽을 수 있는 소스로 남을 수 있습니다.

요구 사항

스킬 자체는 단지 명령어일 뿐입니다. 게시를 위해서는 여전히 다음이 필요합니다:

• 명시적 인증 구성 또는 유효한 Mote OAuth 로그인이 포함된 mote-cli 패키지 또는 소스 빌드 (CLI 참조 및 인증 참조). 자체 호스팅 사용자는 의도한 인스턴스 구성을 유지해야 합니다. 또는
• 연결된 Mote MCP 서버 (MCP 가이드 참조)

로컬 서버만 publish_markdown_file을 노출합니다. 인증 실패는 사용자에게 알려야 합니다. 스킬은 자격 증명을 만들지 않으며, 승인 없이 브라우저 로그인을 시작하지 않고, 다른 클라이언트의 키체인을 읽지 않으며, 이전 토큰으로 전환하지 않습니다. 로그인 지원에 대한 명시적 요청은 사용자의 승인된 범위 내에서 처리할 수 있습니다. 타임아웃이나 알 수 없는 결과 후에 성공 여부를 확인하지 않고 게시를 반복하지 마십시오.