# stitch-skills: nối AI viết code với Google Stitch để thiết kế giao diện — hướng dẫn cài đặt và dùng

> stitch-skills là bộ Agent Skills của Google Labs, chạy cùng Stitch MCP server. Nhờ nó, trợ lý AI lập trình có thể tạo màn hình giao diện, trích hệ thống thiết kế và đổi thiết kế Stitch thành code React. Cài bằng một lệnh npx, nhưng bạn phải cấu hình Stitch MCP trước.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-06 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/stitch-skills-ky-nang-ai-thiet-ke-giao-dien-google-stitch

stitch-skills là một thư viện kỹ năng (skill) cho trợ lý AI lập trình, do Google Labs làm, dùng chung với Google Stitch, công cụ thiết kế giao diện bằng AI của Google. Mỗi skill là một bộ hướng dẫn mà trợ lý như Claude Code, Cursor, Gemini CLI, Codex hay Antigravity đọc để biết cách làm một việc cụ thể với Stitch: tạo màn hình, sửa màn hình, trích hệ thống thiết kế, đổi thiết kế thành code.

Bạn nên xem repo này nếu bạn đã dùng một trợ lý AI để viết code và muốn nó làm được cả phần giao diện một cách có quy củ. Lập trình viên mới sẽ thấy dễ vì không phải tự học cách gọi Stitch. Người làm kinh doanh có ý tưởng app hay trang web cũng dùng được, miễn là chịu mở terminal gõ vài lệnh. Repo hiện có khoảng 8.751 sao và 1.055 fork, giấy phép Apache-2.0, và vẫn được cập nhật trong 3 tháng gần đây.

Điểm đáng giá nhất là bạn chỉ cần nói bằng lời, kiểu “làm cho mình màn hình đăng nhập có ô Ghi nhớ đăng nhập”, rồi trợ lý tự biết gọi Stitch, lưu lại hệ thống thiết kế và đổi sang React khi bạn cần. Bạn xem video ngắn bên dưới để thấy cách nó chạy, rồi quay lại đọc phần cài đặt.

```repo
- repo | google-labs-code/stitch-skills
- kind | Skill
- desc | Bộ skill giúp Claude Code, Gemini CLI, Cursor… làm việc với Google Stitch: tạo màn hình, trích DESIGN.md, đổi thiết kế thành code React.
- stars | 8.8k
- lang | TypeScript
- license | Apache-2.0
```

```video
- youtube | https://youtube.com/shorts/qw0AAIQ_8Ts
- facebook | https://www.facebook.com/reel/2730253044057530
- title | Video giới thiệu stitch-skills
```

## stitch-skills làm được gì

Repo chia thành ba plugin. Mỗi plugin gom một nhóm skill theo mục đích. Dưới đây là những ý chính, theo cách mình hiểu từ tư liệu.

### Nhóm thiết kế (stitch-design)

Nhóm này lo việc tạo và quản lý thiết kế trong Stitch.

- **generate-design**: tạo màn hình mới từ mô tả chữ hoặc ảnh, sửa màn hình đang có, hoặc tạo nhiều biến thể. Ví dụ bạn xin 3 biến thể của trang chủ, một bản nền tối, một bản mật độ cao. Bạn không phải làm lại từ đầu mỗi lần muốn thử một hướng.
- **manage-design-system**: tải file DESIGN.md (tài liệu mô tả màu, chữ, khoảng cách của sản phẩm) lên Stitch và áp lên các màn hình. Nhờ vậy các màn hình trông thống nhất.
- **extract-design-md**: đọc code giao diện có sẵn và rút ra DESIGN.md. Hợp khi bạn đã có app mà chưa ai ghi lại “bộ nhận diện” của nó.
- **code-to-design**: đưa code giao diện (React, Vue…) vào Stitch. Skill trích HTML, dựng hệ thống thiết kế rồi tải lên.
- **extract-static-html**: chụp một trang web đang chạy thành file HTML tĩnh, đã nhúng sẵn CSS và ảnh.
- **upload-to-stitch**: tải ảnh, bản mockup hoặc HTML trong máy lên một dự án Stitch.

### Nhóm xây dựng (stitch-build)

Nhóm này biến thiết kế thành sản phẩm chạy được.

- **react-components**: đổi các màn hình Stitch thành hệ thống component React, có kiểm tra tự động và giữ nhất quán các biến thiết kế.
- **react-native**: đổi thiết kế HTML của Stitch thành component React Native cho app điện thoại.
- **react-vite-dashboard**: dựng dashboard React + Vite từ màn hình Stitch.
- **remotion**: tạo video giới thiệu (walkthrough) từ một dự án Stitch, có hiệu ứng chuyển cảnh và zoom.
- **shadcn-ui**: hướng dẫn trợ lý dùng bộ component shadcn/ui.

### Nhóm tiện ích (stitch-utilities)

- **enhance-prompt**: biến câu mô tả mơ hồ như “làm trang cài đặt” thành prompt chi tiết, hợp với Stitch.
- **design-md**: phân tích một dự án Stitch rồi viết DESIGN.md.
- **stitch-loop**: tạo website nhiều trang từ một prompt, có kiểm tra tự động.
- **taste-design**: tạo DESIGN.md theo tiêu chuẩn giao diện “cao cấp, không na ná mẫu có sẵn”.

Lưu ý: các skill thường phụ thuộc lẫn nhau. Vì thế cách cài cả plugin là cách an toàn nhất cho người mới.

## Cần chuẩn bị gì

Tư liệu của repo nói khá ngắn gọn, nên mình chỉ liệt kê những gì có thật:

- **Một trợ lý AI lập trình** hỗ trợ chuẩn Agent Skills. README nêu: Codex, Antigravity, Gemini CLI, Claude Code, Cursor, và OpenCode (cài thủ công).
- **Stitch MCP server đã cấu hình và đang chạy** trong môi trường của trợ lý. Đây là điều kiện bắt buộc. Bạn làm theo trang hướng dẫn Stitch MCP trên trang chủ dự án (stitch.withgoogle.com/docs/mcp/setup), gồm việc đăng ký server và đặt biến môi trường, thông tin xác thực mà hướng dẫn đó yêu cầu.
- **Terminal** để gõ lệnh. Các lệnh cài của Claude Code và Cursor dùng `npx`, nên máy bạn cần có Node.js. README không ghi phiên bản Node cụ thể, nên mình không dám nói con số nào.

README không nói về hệ điều hành bắt buộc, phần cứng hay chi phí. Chỗ nào bạn phân vân, hãy xem trang hướng dẫn Stitch MCP.

```note
Thông tin xác thực của Stitch MCP (key, token) là của riêng bạn. Đừng dán vào chat, đừng đưa vào file được đưa lên GitHub. README cũng ghi rõ đây không phải sản phẩm được Google hỗ trợ chính thức, nên hãy thử trên dự án nhỏ trước.
```

## Cài đặt từng bước

```steps
- Cấu hình Stitch MCP | Làm theo trang hướng dẫn Stitch MCP để trợ lý nối được với Stitch
- Mở terminal đúng chỗ | Vào thư mục dự án (hoặc workspace) bạn định làm việc
- Cài plugin | Chạy một lệnh phù hợp với trợ lý bạn dùng (Claude Code, Cursor, Codex)
- Hoặc cài chọn lọc | Dùng npx skills add nếu chỉ muốn vài skill
- Mở lại trợ lý | Khởi động lại phiên để nó nạp skill mới
```

### Cấu hình Stitch MCP trước

Đây là bước người mới hay bỏ qua nhất. Skill chỉ là bộ hướng dẫn. Việc nói chuyện thật với Stitch do Stitch MCP server đảm nhận. Nếu chưa cấu hình, skill cài xong vẫn không làm được gì.

Bạn mở trang https://stitch.withgoogle.com/docs/mcp/setup và làm theo từng mục. README của repo không chép lại các bước này, nên mình cũng không viết thay.

### Cài cho Claude Code hoặc Cursor

Mở terminal ngay trong thư mục dự án của bạn. Nếu mở sai thư mục, skill sẽ cài nhầm chỗ. Với Claude Code, chạy lệnh sau để cài vào dự án hiện tại:

```bash
# Claude Code — installs into the current project
npx plugins add google-labs-code/stitch-skills --scope project --target claude-code
```

Với Cursor, lệnh sau cài vào workspace hiện tại:

```bash
# Cursor — installs into the current workspace
npx plugins add google-labs-code/stitch-skills --scope workspace --target cursor
```

`--scope` quyết định phạm vi cài (dự án hay workspace), `--target` chọn trợ lý đích. Dòng bắt đầu bằng `#` chỉ là ghi chú, bạn có thể bỏ khi gõ.

### Cài cho Codex

Codex dùng cơ chế “marketplace”. Bạn thêm marketplace của Stitch Skills trước, rồi mới cài từng plugin. Lệnh trong README:

```bash
codex plugin marketplace add google-labs-code/stitch-skills --ref main \
  --sparse .agents/plugins \
  --sparse plugins/stitch-design \
  --sparse plugins/stitch-build \
  --sparse plugins/stitch-utilities
```

Các cờ `--sparse` chỉ để tải nhanh hơn bằng cách lấy đúng những thư mục cần. README nói bạn có thể bỏ chúng để tải cả repo. Dấu `\` cuối dòng chỉ để ngắt dòng trong bash. Trên PowerShell bạn nên gõ lệnh trên một dòng liền.

Nếu thích giao diện, vào **Settings → Plugin Marketplaces → Add** trong Codex. Điền Source là `https://github.com/google-labs-code/stitch-skills`, Git ref là `main`, còn Sparse paths để trống hoặc điền các đường dẫn như trên. Sau đó cài `stitch-design`, `stitch-build`, `stitch-utilities` tuỳ nhu cầu.

### Cài chọn lọc từng skill

Nếu bạn chỉ cần vài skill, dùng lệnh này:

```bash
npx skills add google-labs-code/stitch-skills
```

README cảnh báo: skill của Stitch hay phụ thuộc nhau. Khi chọn lẻ, bạn phải chọn đủ các skill phụ thuộc. Người mới nên cài cả plugin cho đỡ thiếu.

Muốn xem hướng dẫn của hai công cụ cài:

```bash
npx plugins --help

npx skills --help
```

### Cài cho OpenCode (thủ công)

OpenCode không dùng `npx plugins` hay `npx skills`. Bạn tự chép thư mục skill vào chỗ OpenCode tìm được. Lệnh trong README, chạy ở thư mục chứa repo đã tải về:

```bash
# Project-local (recommended)
mkdir -p .opencode/skills
cp -R plugins/stitch-design/skills/generate-design .opencode/skills/generate-design
# repeat for other skills under plugins/*/skills/
```

Sau đó thêm Stitch MCP vào file `opencode.json` của dự án (hoặc `~/.config/opencode/opencode.json`):

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "stitch": {
      "type": "remote",
      "url": "YOUR_STITCH_MCP_URL",
      "enabled": true
    }
  }
}
```

Thay `YOUR_STITCH_MCP_URL` bằng địa chỉ bạn nhận được ở bước cấu hình Stitch MCP. OpenCode còn yêu cầu tên skill viết kiểu chữ thường nối gạch và trùng tên thư mục. Skill nào mang tên dạng `stitch::…` thì phải đổi cả trường `name` lẫn tên thư mục trước.

## Kiểm tra đã chạy được chưa

README không mô tả một lệnh kiểm tra riêng hay màn hình kết quả mong đợi. Cách kiểm tra thực tế là thử vài việc nhỏ:

1. Mở lại trợ lý trong thư mục bạn vừa cài và hỏi nó đang có những skill nào. Tên như `generate-design` hay `enhance-prompt` nên xuất hiện. Cách hỏi và nơi hiển thị tuỳ từng trợ lý.
2. Đưa một yêu cầu nhẹ, lấy từ ví dụ của README: *"Enhance this prompt: 'make a settings page'."* Nếu trợ lý trả về một prompt dài, chi tiết hơn nhiều, nghĩa là skill đã được nạp.
3. Thử một yêu cầu gọi Stitch thật, ví dụ tạo một màn hình đơn giản. Nếu trợ lý báo không kết nối được Stitch, lỗi nằm ở bước cấu hình MCP chứ không phải ở skill.

## Dùng vào việc thật

Các prompt dưới đây dựa trên ví dụ có trong README. Bạn chỉ cần đổi tên, đường dẫn và mã dự án cho đúng với mình.

### Chủ shop muốn có ý tưởng giao diện app nhanh

Bạn bán đồ handmade và muốn xem thử app đặt hàng trông thế nào trước khi thuê ai. Bạn nhờ trợ lý làm cho rõ ý trước:

```text
Enhance this prompt: 'make a settings page'
```

Skill `enhance-prompt` biến câu mơ hồ thành prompt đầy đủ hơn. Sau đó bạn nhờ `generate-design` tạo màn hình, ví dụ theo mẫu README: *"Make a browse tab for a mobile app for romance and date night ideas."* Kết quả là một màn hình trong Stitch để bạn xem và góp ý. Bạn có thể nhờ tiếp: *"Generate 3 design variants of the home screen with dark mode and high-density layouts."*

> Nói một câu bằng lời, nhận về một màn hình để chê hoặc khen. Việc khó nhất là mô tả cho đúng, và skill đã lo phần đó.
>
> — Ông T

### Dev đã có app, muốn ghi lại hệ thống thiết kế

Bạn là lập trình viên mới vào một dự án và không ai biết màu chính, cỡ chữ ở đâu ra. Bạn bảo trợ lý:

```text
Scan `/src` and extract the design system into `.stitch/DESIGN.md`.
```

Skill `extract-design-md` đọc code và ghi file `.stitch/DESIGN.md`. Sau đó bạn có thể nhờ `manage-design-system` tải file này lên Stitch: *"Upload our design system from `.stitch/DESIGN.md` and apply it to all screens."* Các màn hình mới tạo trong Stitch sẽ bám theo bộ nhận diện này.

### Chuyển thiết kế Stitch thành code React

Designer (hoặc chính bạn) đã chốt thiết kế trong Stitch. Bạn đưa mã dự án cho trợ lý:

```text
Convert all screens in Stitch project `projects/123` to React components.
```

Skill `react-components` biến các màn hình thành hệ thống component React, có kiểm tra và giữ token thiết kế nhất quán. Khi thiết kế đổi, bạn dùng câu kiểu README: *"Sync the app to the last updates of the Stitch project ..."* để cập nhật. Nếu làm app điện thoại, dùng `react-native` tương tự.

### Đưa trang web đang chạy vào Stitch để chỉnh lại

Công ty bạn có sẵn một trang web chạy ở máy. Bạn muốn thiết kế lại mà không vẽ lại từ đầu:

```text
Extract a static HTML snapshot of `http://localhost:3000/profile`.
```

Skill `extract-static-html` tạo file HTML tĩnh có sẵn CSS và ảnh. Rồi bạn nhờ `upload-to-stitch` đưa file lên dự án Stitch: *"Upload `.stitch/landing_page.html` to Stitch project `projects/987654321`."* Bạn có thể chỉnh tiếp trong Stitch từ bản chụp đó.

## Lỗi hay gặp và cách xử lý

### Skill cài xong nhưng trợ lý không gọi được Stitch

Thường là do chưa cấu hình Stitch MCP, hoặc thiếu biến môi trường và thông tin xác thực. Hãy quay lại trang hướng dẫn Stitch MCP và làm lại từng bước. Sau đó mở lại phiên trợ lý để nó nạp cấu hình mới.

### Cài nhầm chỗ, trợ lý không thấy skill

Lệnh `--scope project` và `--scope workspace` cài theo thư mục bạn đang đứng. Nếu bạn mở terminal ở thư mục khác, skill nằm ở dự án khác. Hãy `cd` vào đúng thư mục dự án rồi chạy lại lệnh, và nhớ mở trợ lý ở đúng thư mục đó.

### Chạy một skill thì báo thiếu skill khác

README đã cảnh báo các skill hay phụ thuộc nhau. Nếu bạn cài chọn lọc bằng `npx skills add`, hãy cài thêm các skill được nhắc đến. Cách chắc ăn nhất là cài cả plugin để khỏi thiếu.

### OpenCode không nạp skill

OpenCode yêu cầu trường `name` viết chữ thường nối gạch, trùng tên thư mục. Với skill đặt tên dạng `stitch::…`, bạn phải đổi cả `name` lẫn tên thư mục. Ngoài ra, tên công cụ trong hướng dẫn skill có thể khác của OpenCode (README nêu `webfetch` / `bash` thay cho `web_fetch` / `run_command`).

### Lệnh nhiều dòng của Codex báo lỗi trên PowerShell

Dấu `\` cuối dòng là cú pháp của bash. Trên Windows PowerShell, bạn gõ toàn bộ lệnh trên một dòng, hoặc dùng giao diện Settings → Plugin Marketplaces của Codex như README mô tả.

## Có nên dùng không

**Điểm mạnh.** Bạn có cả quy trình trọn gói: viết prompt, tạo màn hình, chốt hệ thống thiết kế, rồi sinh code React. Repo theo chuẩn mở Agent Skills nên dùng được với nhiều trợ lý, không buộc bạn vào một công cụ. Giấy phép Apache-2.0 rộng rãi, và dự án vẫn có người cập nhật.

**Giới hạn.** Bạn vẫn phải cấu hình Stitch MCP, và README không chép các bước đó. Skill không tự chạy: nó cần một trợ lý AI lập trình cùng một lệnh rõ ràng từ bạn. README ghi rõ đây không phải sản phẩm được Google hỗ trợ chính thức và không thuộc chương trình thưởng lỗ hổng bảo mật của Google. Chưa có thông tin trong tư liệu về chi phí hay hạn mức dùng Stitch, nên bạn cần tự xem trang Stitch.

**Khi nào chọn cách khác.** Nếu bạn không dùng trợ lý AI lập trình nào và chỉ muốn vẽ giao diện bằng tay, cứ dùng trực tiếp Stitch hoặc công cụ thiết kế bạn quen. Nếu bạn chỉ cần một skill đơn lẻ không liên quan đến Stitch, repo này không phải chỗ cần tìm. Còn nếu bạn đã quen Claude Code hay Cursor và muốn thiết kế giao diện ngay trong luồng làm việc, thì đây là bộ skill đáng thử, bắt đầu bằng một dự án nhỏ.

## Câu hỏi thường gặp

### stitch-skills có miễn phí không?

Repo dùng giấy phép Apache-2.0 nên bạn tải và dùng mã nguồn tự do. Tư liệu không nói gì về chi phí hay hạn mức của Google Stitch hay của trợ lý AI bạn dùng cùng. Bạn nên xem trang Stitch và trang của trợ lý để biết rõ.

### Tôi cần cài gì trước khi cài stitch-skills?

Bạn cần một trợ lý AI lập trình như Claude Code, Cursor, Gemini CLI, Codex, Antigravity hay OpenCode. Bạn cũng phải cấu hình Stitch MCP server theo trang hướng dẫn chính thức. Lệnh cài cho Claude Code và Cursor dùng npx, nên máy cần có Node.js. README không ghi phiên bản cụ thể.

### Dùng được trên Windows không?

README không nói rõ về hệ điều hành. Các lệnh cài chủ yếu là npx và codex, nên về nguyên tắc chạy được trong terminal. Lệnh nhiều dòng của Codex dùng dấu \ kiểu bash, trên PowerShell bạn gõ trên một dòng. Chưa có thông tin chính thức về Windows trong tư liệu.

### Có cần GPU hay máy mạnh không?

Tư liệu không nhắc yêu cầu phần cứng nào. Skill là các file hướng dẫn cho trợ lý và việc gọi Stitch qua MCP, nên README không đòi GPU.

### Khác gì dùng thẳng Google Stitch?

Stitch là công cụ thiết kế. stitch-skills dạy trợ lý AI lập trình cách điều khiển Stitch qua MCP. Nhờ đó bạn ra lệnh bằng lời ngay trong terminal hoặc trình soạn code, và nối được sang việc sinh code React hay React Native.

### Nên cài cả plugin hay từng skill?

Người mới nên cài cả plugin. README cảnh báo các skill của Stitch hay phụ thuộc nhau, nên cài lẻ dễ thiếu thứ cần. Nếu cài lẻ bằng npx skills add, bạn phải tự đảm bảo đủ các skill phụ thuộc.

### Dữ liệu và thông tin xác thực có an toàn không?

Tư liệu chưa nói về cách dữ liệu thiết kế được lưu hay xử lý. README ghi đây không phải sản phẩm được Google hỗ trợ chính thức. Bạn nên giữ thông tin xác thực Stitch MCP ở nơi riêng tư và thử trên dự án nhỏ trước.
