slack-to-zoom-migrate

Category: Development & Coding | Uploader: zoom | Downloads: 0 | Version: v1.0（Latest）

Converts Slack apps to Zoom Team Chat. Accepts GitHub URL or local path, generates TypeScript code with API mappings, OAuth, webhooks, and docs. Invoke when user mentions migrating, converting, or porting a Slack app/bot to Zoom.

Changelog: Source: GitHub https://github.com/zoom/app-migration-skills

Directory Structure

Current level: skills/slack-to-zoom-migrate/

📁 .claude-plugin/
- 📄 plugin.json 312 B
📁 commands/
- 📄 slack-to-zoom-migrate.md 4.3 KB
📁 core/
- 📄 executor.md 97.0 KB
- 📄 instructions.md 33.6 KB
📁 docs/
- 📁 api-mapping/
  - 📄 events-webhooks.md 7.5 KB
  - 📄 formatting.md 6.5 KB
  - 📄 interactivity.md 4.7 KB
  - 📄 messaging-api.md 9.1 KB
  - 📄 oauth-auth.md 4.3 KB
  - 📄 slash-commands.md 3.4 KB
- 📁 code-examples/
  - 📄 button-handling.md 719 B
  - 📄 error-handling.md 952 B
  - 📄 markdown-conversion.md 7.1 KB
  - 📄 oauth-flow.md 1.1 KB
  - 📄 send-message.md 3.8 KB
  - 📄 slash-commands.md 1.2 KB
  - 📄 update-message.md 844 B
  - 📄 webhook-validation.md 1.5 KB
- 📄 API_MAPPING_REFERENCE.md 27.2 KB
- 📄 ASYNC_OPERATIONS.md 11.5 KB
- 📄 BUTTON_PATTERNS.md 6.4 KB
- 📄 COMMON_FIXES.md 4.5 KB
- 📄 CUSTOM_STRUCTURES.md 12.0 KB
- 📄 DYNAMIC_STRUCTURE_GUIDE.md 10.9 KB
- 📄 EMOJI_REFERENCE.md 9.9 KB
- 📄 OMITTED_FIELDS.md 14.4 KB
- 📄 README.md 6.4 KB
- 📄 RICH_FORMATTING_CHECKLIST.md 9.5 KB
- 📄 SLACK_DOCS_DIRECTORY.md 12.1 KB
- 📄 ZOOM_OFFICIAL_DOCS.md 7.9 KB
📁 examples/
- 📁 poker-planner-zoom/
  - 📁 src/
    
    📁 app/
    
    📄 storage.ts 1.3 KB
    
    📁 lib/
    
    📄 security.ts 401 B
    
    📄 utils.ts 2.6 KB
    
    📁 types/
    
    📄 index.ts 1.5 KB
    
    📁 zoom/
    
    📄 auth.ts 2.3 KB
    
    📄 messaging.ts 8.0 KB
    
    📄 tokens.ts 2.8 KB
    
    📄 webhook.ts 9.8 KB
    
    📄 config.ts 1.5 KB
    
    📄 server.ts 966 B
  - 📁 tests/
    
    📁 e2e/
    
    📄 live-api.test.ts 8.1 KB
    
    📁 helpers/
    
    📄 fixtures.ts 1.4 KB
    
    📄 mocks.ts 1.9 KB
    
    📁 integration/
    
    📄 messaging.test.ts 3.8 KB
    
    📄 webhook.test.ts 4.7 KB
    
    📁 unit/
    
    📄 config.test.ts 1.5 KB
    
    📄 setup.ts 646 B
  - 📄 .env.example 754 B
  - 📄 .gitignore 329 B
  - 📄 jest.config.js 900 B
  - 📄 MIGRATION_GUIDE.md 9.0 KB
  - 📄 package.json 952 B
  - 📄 README.md 6.1 KB
  - 📄 SETUP_CHECKLIST.md 9.1 KB
  - 📄 tsconfig.json 361 B
📁 reference/
- 📄 COMMON_BUGS.md 10.0 KB
- 📄 FAQ.md 7.4 KB
- 📄 QUICK_REFERENCE.md 5.5 KB
- 📄 VALIDATION_EXAMPLES.md 8.9 KB
📁 templates/
- 📁 general/
  - 📁 src/
    
    📁 lib/
    
    📄 security.ts 401 B
    
    📁 types/
    
    📄 index.ts 897 B
    
    📁 zoom/
    
    📄 auth.ts 2.3 KB
    
    📄 http-client.ts 694 B
    
    📄 messaging.ts 9.0 KB
    
    📄 tokens.ts 3.0 KB
    
    📄 webhook.ts 5.8 KB
    
    📄 config.ts 2.4 KB
    
    📄 server.ts 966 B
  - 📁 tests/
    
    📁 e2e/
    
    📄 live-api.test.ts 8.1 KB
    
    📁 helpers/
    
    📄 fixtures.ts 1.4 KB
    
    📄 mocks.ts 3.7 KB
    
    📁 integration/
    
    📄 messaging.test.ts 4.6 KB
    
    📄 webhook.test.ts 6.6 KB
    
    📁 unit/
    
    📄 config.test.ts 1.5 KB
    
    📄 setup.ts 646 B
  - 📄 .env.example 1.7 KB
  - 📄 jest.config.js 900 B
  - 📄 package.json 931 B
  - 📄 README.md 3.6 KB
  - 📄 tsconfig.json 361 B
- 📄 MIGRATION_GUIDE_TEMPLATE.md 4.7 KB
- 📄 README.md 6.4 KB
📄 README.md 17.9 KB
📄 SKILL.md 5.5 KB

SKILL.md

---
name: slack-to-zoom-migrate
description: Converts Slack apps to Zoom Team Chat. Accepts GitHub URL or local path, generates TypeScript code with API mappings, OAuth, webhooks, and docs. Invoke when user mentions migrating, converting, or porting a Slack app/bot to Zoom.
version: 1.0.0
---

# Slack to Zoom Team Chat Migration Skill

Automatically migrate Slack apps to Zoom Team Chat with intelligent analysis, API mapping, and production-ready code generation.

## What This Skill Does

When invoked, this skill will:
1. 🔍 **Analyze** the Slack app codebase (from GitHub or local path)
2. 🗺️ **Map** Slack APIs to Zoom Team Chat equivalents
3. 💻 **Generate** production-ready TypeScript/Node.js code with **rich markdown formatting**
4. 📊 **Calculate** feature parity percentage (typically 70-90%)
5. 📚 **Create** comprehensive documentation and setup guides
6. ✅ **Validate** the generated code with tests and server startup

## ⚠️ CRITICAL: Rich Formatting Required

**ALL generated messages MUST use rich formatting patterns.** Never generate plain messages.

**Quick Reference:** `docs/RICH_FORMATTING_CHECKLIST.md`

**🚨 CRITICAL STRUCTURE:**
- ✅ Use **multiple body items** (separate sections)
- ❌ NEVER concatenate into single text field

**Required patterns:**
- ✅ Visual separators (`━━━━━━`)
- ✅ Bold titles with emojis (`*🎯 Title*`) - Single asterisk!
- ✅ Individual status (not just counts)
- ✅ Emoji-rich headers (`*📊 Status*`)
- ✅ Button chunking (5 per row)
- ✅ Visual bars for results (`▰▰▰`)

**Correct Structure:**
```typescript
const body: any[] = [];
body.push({ type: 'message', text: `*🎯 Title*` });
body.push({ type: 'message', text: `━━━━━━━━━━━━━━━━━━━━` });
body.push({ type: 'message', text: `👤 _Creator_` });
// ... more sections
return { head: { text: 'App' }, body: body };
```

**Working example:** `examples/poker-planner-zoom/src/zoom/messaging.ts`

## Usage

```
/slack-to-zoom-migrate <github-url-or-path>
```

**Examples:**
```bash
/slack-to-zoom-migrate https://github.com/dgurkaynak/slack-poker-planner
/slack-to-zoom-migrate ./my-slack-app
/slack-to-zoom-migrate https://github.com/user/slack-bot
```

## Implementation Instructions

All file paths referenced in this skill are relative to the skill directory root (`skills/slack-to-zoom-migrate/`).

When this skill is invoked with arguments (GitHub URL or local path), follow these steps:

### Step 1: Parse Input
Extract the repository URL or local path from the arguments provided after the command.

### Step 2: Read Execution Instructions
Read the detailed execution flow from (relative to skill directory):
- `core/executor.md` - Demo-worthy execution flow with timing and progress
- `core/instructions.md` - Technical implementation details

### Step 3: Execute All 6 Phases

**MANDATORY: Complete all phases in order**

1. **Phase 1: Repository Analysis** (30-45s)
   - Clone/read the Slack app source code
   - Identify framework, language, and structure
   - Catalog all features (commands, buttons, events, modals)

2. **Phase 2: Feature Mapping** (30-45s)
   - Map Slack APIs to Zoom equivalents
   - Calculate feature parity percentage
   - Identify limitations and workarounds

3. **Phase 3: Code Generation** (60-90s)
   - Use templates from `templates/general/` as foundation
   - Generate app-specific business logic
   - Apply all Zoom-specific fixes
   - Create complete TypeScript project

4. **Phase 4: Documentation** (30-45s)
   - Generate README.md with setup instructions
   - Create MIGRATION_GUIDE.md with feature analysis
   - Generate SETUP_CHECKLIST.md for Zoom Marketplace

5. **Phase 5: Validation** (MANDATORY)
   - Ask user for credentials (using AskUserQuestion)
   - Run npm install and npm test
   - Start server and test endpoints
   - Apply auto-fixes if needed

6. **Phase 6: Final Summary** (5-10s)
   - Display comprehensive results
   - Show validation status
   - Provide next steps

### Step 4: Use Available Resources

Reference documentation (relative to skill directory):
- `docs/API_MAPPING_REFERENCE.md` - Complete API mappings
- `docs/ASYNC_OPERATIONS.md` - State management patterns
- `docs/BUTTON_PATTERNS.md` - **CRITICAL:** Button context patterns (restart, multi-step flows)
- `docs/OMITTED_FIELDS.md` - Field availability reference
- `docs/code-examples/` - Implementation examples

### Step 5: Output

Generate the Zoom app in: `./slack-to-zoom-migrate-output/` or `<app-name>-zoom/`

## What You Get

**Generated Code:**
- Complete TypeScript/Node.js project
- OAuth authentication flow
- Webhook handlers (slash commands, buttons)
- Message sending with markdown
- Session/state management (if needed)
- Comprehensive test suite

**Documentation:**
- README.md - Setup and deployment guide
- MIGRATION_GUIDE.md - Feature parity analysis
- SETUP_CHECKLIST.md - Zoom Marketplace configuration
- .env.example - Configuration template

**Typical Results:**
- ✅ 70-90% feature parity (varies by app)
- ✅ 0-5 manual fixes required
- ✅ Production-ready code
- ✅ ~10 minute setup time

## Known Limitations

**Cannot migrate:**
- Apps requiring passive message listening
- Complex multi-step modal workflows
- App Home tabs
- Rich text formatting (colors, fonts)

**Partial migration:**
- Simple modals → Inline message cards
- Block Kit → Markdown approximation

**Full migration:**
- Slash commands
- Interactive buttons
- Basic messages
- OAuth flows
- Webhooks
- Session state

## Skill Metadata

- **Version:** 1.0.0
- **Author:** Zoom
- **Required Tools:** Bash, Read, Write, Glob, Grep, Task

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

slack-to-zoom-migrate

Directory Structure

SKILL.md

Report

Notice