Skills
Skill là gì?
Skill là các gói kiến thức chuyên biệt được thiết kế để cung cấp ngữ cảnh (context) cho AI agent — giúp agent hiểu sâu hơn về framework, thư viện, và quy trình phát triển ứng dụng trên nền tảng V-App.
Khi bạn làm việc với AI agent (Claude Code, Cursor, GitHub Copilot, ...), agent chỉ có kiến thức chung. Skill bổ sung cho agent kiến thức cụ thể về:
- Cách sử dụng API và component của V-App (MiniApp & AI App)
- Các pattern và best practice khi phát triển ứng dụng
- Cấu trúc project, CLI commands, và quy trình deploy
- Quy tắc thiết kế UI, design tokens, và theming
- Kiến trúc MCP Server, widgets, và skill authoring (AI App)
Nhờ đó, AI agent có thể sinh code chính xác hơn, đúng chuẩn hơn và phù hợp với hệ sinh thái V-App.
Các skill hiện có
| Skill | Mô tả | Package chính | GitHub |
|---|---|---|---|
| MiniApp | CLI, build/deploy, JavaScript APIs (auth, payment, storage, ...) | @v-miniapp/cli, @v-miniapp/apis | v-mini-app-skills |
| UI React | 60+ UI components, design tokens, routing, i18n | @v-miniapp/ui-react | ui-react-skills |
| AI App | MCP Server, React widgets, imperative APIs cho AI App | @v-miniapp/ai | ai-app-skills |
Cài đặt
Cách 1: Sử dụng skills CLI (Khuyến nghị)
# Cài vào project hiện tại
npx skills add v-open-platform/<skill-name>
# Cài global
npx skills add v-open-platform/<skill-name> -g
# Cài cho agent cụ thể
npx skills add v-open-platform/<skill-name> -a claude-code
Cách 2: Cài đặt thủ công
Clone repo chứa skill và copy thư mục skill vào đúng vị trí của agent bạn đang sử dụng:
git clone https://github.com/v-open-platform/<skill-repo>
cp -r <skill-repo>/skills/<skill-name> <agent-skills-dir>/
Agent được hỗ trợ
| Agent | Thư mục Skills |
|---|---|
| Claude Code | ~/.claude/skills/ hoặc .claude/skills/ |
| Cursor | ~/.cursor/skills/ hoặc .cursor/skills/ |
| OpenCode | ~/.opencode/skill/ |
| GitHub Copilot | .github/copilot/skills/ |
| Windsurf | ~/.windsurf/skills/ |
- Global (
~/.<agent>/skills/): Skill có hiệu lực cho tất cả project. - Project-level (
.<agent>/skills/): Skill chỉ có hiệu lực trong project hiện tại.
Cách hoạt động
Mỗi skill gồm một file SKILL.md chính và thư mục references/ chứa tài liệu tham khảo chi tiết:
<skill-name>/
├── SKILL.md # File skill chính — mô tả khả năng và hướng dẫn cho agent
└── references/
├── setup.md # Hướng dẫn cài đặt
├── api.md # Tham khảo API
└── ... # Các tài liệu khác
Khi bạn tương tác với AI agent, agent sẽ tự động đọc SKILL.md và các file tham khảo liên quan để hiểu ngữ cảnh, từ đó đưa ra gợi ý và sinh code phù hợp.