zalo-mini-app-skills
💡 摘要
一个为AI代理提供在Zalo Mini App平台上开发应用程序所需知识和参考的技能。
🎯 适合人群
🤖 AI 吐槽: “这个技能是针对小众平台的全面指南,但它基本上就是一个加了额外安装步骤的、美化了的文档书签。”
该技能本身是一个知识库,直接风险极低。然而,其引用的自动化Zalo消息的`zca-cli`工具,天然涉及处理敏感的用户凭证和会话数据。如果该技能的指导导致集成此类工具,则会引入凭证管理和潜在未授权访问风险。缓解措施:始终将凭证存储在安全的、环境特定的保险库中,切勿存储在代码中,并在使用前审查任何第三方CLI工具的安全模型。
Zalo Mini App Skill
Build Zalo Mini Apps - lightweight web apps running inside the Zalo super-app platform.
Features
- ZaUI Components - Button, Input, Modal, Tabs, Avatar, Calendar, List, and 50+ more
- JavaScript APIs - authorize, getUserInfo, getPhoneNumber, getLocation, Storage, Camera
- Checkout SDK - Payment integration for Vietnamese market
- Design Guidelines - Colors, typography, spacing, icons following Zalo standards
- Development Tools - zmp-cli, VSCode extension, debugging
Installation
Option 1: Using add-skill CLI (Recommended)
# Install to current project npx add-skill suminhthanh/zalo-mini-app-skills # Install globally npx add-skill suminhthanh/zalo-mini-app-skills -g # Install for specific agent npx add-skill suminhthanh/zalo-mini-app-skills -a claude-code
Option 2: Manual Installation
For Claude Code:
# Clone to Claude Code skills directory git clone https://github.com/suminhthanh/zalo-mini-app-skills.git cp -r zalo-mini-app-skills/skills/zalo-mini-app ~/.claude/skills/
For Project-level:
mkdir -p .claude/skills cp -r zalo-mini-app-skills/skills/zalo-mini-app .claude/skills/
Option 3: Direct Download
# Download and extract curl -L https://github.com/suminhthanh/zalo-mini-app-skills/archive/main.zip -o skill.zip unzip skill.zip cp -r zalo-mini-app-skills-main/skills/zalo-mini-app ~/.claude/skills/
Supported Agents
| Agent | Skills Directory |
|-------|-----------------|
| Claude Code | ~/.claude/skills/ or .claude/skills/ |
| Cursor | ~/.cursor/skills/ or .cursor/skills/ |
| OpenCode | ~/.opencode/skill/ |
| GitHub Copilot | .github/copilot/skills/ |
| Windsurf | ~/.windsurf/skills/ |
Usage
Once installed, the skill activates automatically when you:
- Build new Zalo Mini Apps
- Use ZaUI components
- Call Zalo SDK APIs
- Integrate payments with Checkout SDK
- Follow Zalo design guidelines
Quick Start
npm install -g zmp-cli zmp create my-app && cd my-app && zmp start
Example Prompts
- "Create a Zalo Mini App with bottom navigation"
- "Add user authentication using Zalo authorize API"
- "Implement a product list with ZaUI components"
- "Integrate Checkout SDK for payment"
Skill Structure
zalo-mini-app/
├── SKILL.md # Main skill file
└── references/
├── getting-started.md # Setup & deployment
├── api-overview.md # API categories
├── api-user.md # User APIs
├── api-storage.md # Storage APIs
├── api-ui.md # UI APIs
├── api-device.md # Device APIs
├── api-zalo.md # Zalo integration
├── zaui-overview.md # Components overview
├── zaui-layout.md # Layout components
├── zaui-display.md # Display components
├── zaui-form.md # Form components
├── zaui-overlay.md # Overlay components
├── design-guidelines.md # Design standards
├── web-design-guidelines.md # Accessibility, forms, animations, touch, i18n
└── react-best-practices.md # Waterfalls, bundle size, re-renders, JS performance
Related Projects
zca-cli - Zalo CLI for Developers
A powerful command-line interface for the Zalo messaging platform. Automate messaging, manage groups, and build custom integrations directly from your terminal.
Features:
- QR code login with multi-account support
- Send text, images, videos, voice messages, and stickers
- Group management (create, rename, add/remove members)
- Real-time message listener with webhook integration
- Batch operations and URL download support
Quick Install:
# macOS / Linux curl -fsSL https://get.zca-cli.dev/install.sh | bash # Windows (PowerShell) irm https://get.zca-cli.dev/install.ps1 | iex
Clawdbot - AI Agent with Zalo Integration
A powerful agentic AI assistant with multi-channel messaging support. The Zalo User channel uses zca-cli under the hood to automate personal Zalo accounts.
Features:
- Uses
zca listenfor receiving messages andzca msgfor replies - Text, media, and link messaging support
- Access control with pairing mode, allowlist, and group policies
- Multi-account support via zca profiles
- WebSocket gateway with tool execution and session management
Resources
License
MIT
优点
- 针对特定且不断增长的平台(Zalo)具有高实用性
- 结构良好的参考文档,涵盖API、UI和设计
- 为各种AI代理提供了清晰的多选项安装指南
缺点
- 新颖性有限,因为它主要重新打包了现有文档
- 实用性在地理上局限于越南/Zalo用户
- 由于大量的参考文件可能导致技能臃肿
相关技能
免责声明:本内容来源于 GitHub 开源项目,仅供展示和评分分析使用。
版权归原作者所有 suminhthanh.
