M5-4. Claude 플러그인 변환 — 5분 만에 M365 패키지

한 줄 요약 — Claude Code 플러그인이 있다면 변환 스크립트 한 줄로 M365 패키지가 됩니다. 크로스 플랫폼을 노린다면 Claude 구조(슈퍼셋)로 개발 → 변환이 정석입니다.

변환 매핑 — Claude 플러그인 → M365 패키지

1. 변환 스크립트

.\Convert-ClaudePluginToMOS3.ps1 -PluginPath ./my-claude-plugin -OutputPath ./output

(스크립트 다운로드)

옵션: -AppId <guid>(GUID 고정) · -DefaultAuthType Auto|None|OAuthPluginVault|ApiKeyPluginVault · -DetailedOutput

2. 변환 매핑표

Claude 아티팩트	M365 대응	비고
`.claude-plugin/plugin.json`	`manifest.json`	이름·설명·author 매핑 · GUID는 UUID v5 결정적 생성
`skills/*/SKILL.md`	`agentSkills[]` + skills/	그대로 복사 — 동일 포맷
`.mcp.json` 서버	`agentConnectors[]`	URL·인증 타입 자동 감지 (외부 HTTPS → OAuthPluginVault 기본)
`color.png`/`outline.png`	아이콘	없으면 플레이스홀더 생성 — 스토어 제출 전 교체

3. 변환되지 않는 것

commands/(슬래시 명령) · agents/(서브에이전트) · hooks/ — 아직 미지원. settings.json·bin/ — 해당 없음.

4. 크로스 플랫폼 전략

my-plugin/                  # Claude 구조로 개발 (슈퍼셋)
├── .claude-plugin/plugin.json
├── skills/*/SKILL.md       # ← Claude Code와 M365 양쪽에서 동작
└── .mcp.json
        │
        └─ Convert-ClaudePluginToMOS3.ps1 → M365 App Store용 ZIP

Cowork 패키지의 스킬을 역방향으로 Claude Code에서 쓰려면 .claude/skills/에 복사하면 끝
2026-07부터는 Customize 업로드 시 Claude ZIP 자동 변환도 지원 (M2-6c) — 스크립트는 CI·대량·세부 제어가 필요할 때

출처

출처: Build plugins — Convert an existing Claude plugin (MS Learn) · What’s New — July 2026