# google-labs-code/stitch-skills: thiết kế và dựng giao diện bằng AI

> google-labs-code/stitch-skills là bộ Agent Skills và plugin dành cho Google Stitch, giúp coding agent tạo thiết kế, quản lý design system và chuyển thiết kế thành mã React hoặc React Native. Repo hỗ trợ Codex, Antigravity, Gemini CLI, Claude Code, Cursor và OpenCode. Cài đặt tương đối đơn giản nếu bạn đã cấu hình Stitch MCP; OpenCode cần cài thủ công nhiều bước hơn.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-23 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/google-labs-code-stitch-skills

google-labs-code/stitch-skills là một thư viện Agent Skills và plugin giúp coding agent làm việc với Google Stitch. Bạn có thể dùng nó để tạo màn hình từ mô tả hoặc hình ảnh, chỉnh sửa thiết kế, trích xuất design system và chuyển thiết kế thành mã giao diện.

Repo phù hợp với lập trình viên frontend, đội thiết kế sản phẩm, người làm prototype và các nhóm muốn dùng AI để rút ngắn thời gian từ ý tưởng đến giao diện chạy được. Điểm đáng giá nhất là các skill được chia thành nhóm rõ ràng: thiết kế, build và tiện ích. Bạn có thể cài cả bộ hoặc chỉ chọn những skill cần thiết.

Repo tuân theo Agent Skills open standard nên tương thích với nhiều coding agent. Nếu muốn xem nhanh cách một agent dùng bộ skill này để tạo giao diện, bạn có thể xem video ngắn bên dưới.

```repo
- repo | google-labs-code/stitch-skills
- kind | Skill
- desc | Bộ Agent Skills giúp coding agent làm việc với Google Stitch để tạo thiết kế, sinh mã và xây giao diện.
- 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ì

### Tạo thiết kế từ mô tả hoặc hình ảnh

Skill `stitch::generate-design` cho phép bạn yêu cầu tạo màn hình mới bằng ngôn ngữ tự nhiên hoặc dựa trên hình ảnh. Bạn cũng có thể yêu cầu chỉnh sửa màn hình hiện có, chẳng hạn thêm checkbox, đổi màu nút hoặc tạo nhiều biến thể giao diện.

Điều này hữu ích khi bạn muốn kiểm tra nhanh vài hướng thiết kế trước khi giao việc chi tiết cho designer hoặc frontend developer. Thay vì bắt đầu bằng file thiết kế trống, bạn có thể bắt đầu bằng một yêu cầu có ngữ cảnh.

### Chuyển mã frontend thành thiết kế Stitch

Skill `stitch::code-to-design` hỗ trợ chuyển mã frontend như React hoặc Vue thành một Stitch Design. Quy trình gồm trích xuất HTML, nhận diện design system và tải kết quả lên Stitch.

Đây là lựa chọn phù hợp khi đội của bạn đã có một trang web nhưng muốn đưa giao diện đó vào quy trình thiết kế, kiểm tra hoặc mở rộng trong Stitch.

### Quản lý design system

Skill `stitch::manage-design-system` có thể tải file `DESIGN.md` lên Stitch và áp dụng theme cho các màn hình. Skill `stitch::extract-design-md` làm chiều ngược lại: quét mã frontend rồi tạo một file `.stitch/DESIGN.md` mô tả hệ thống thiết kế.

Lợi ích thực tế là các màn hình được tạo sau có cơ sở thống nhất hơn về màu sắc, kiểu chữ, khoảng cách và thành phần giao diện. Bạn cũng có thể dùng `design-md` để phân tích dự án Stitch và sinh tài liệu design system bằng ngôn ngữ dễ đọc.

### Trích xuất HTML tĩnh và tải tài sản lên Stitch

Skill `stitch::extract-static-html` trích xuất HTML tĩnh độc lập từ ứng dụng web đang chạy, đồng thời nhúng CSS và hình ảnh vào kết quả. Skill `stitch::upload-to-stitch` hỗ trợ tải hình ảnh, mockup hoặc HTML cục bộ lên một dự án Stitch.

Hai skill này hữu ích khi bạn cần lưu lại một phiên bản giao diện, đưa tài sản cục bộ vào dự án hoặc chia sẻ một snapshot không phụ thuộc hoàn toàn vào máy chủ đang chạy.

### Sinh mã React và React Native

Nhóm `stitch-build` có skill `stitch::react-components` để chuyển các màn hình Stitch thành hệ thống component React. Skill này có automated validation và hỗ trợ giữ tính nhất quán của design token.

Skill `stitch::react-native` chuyển thiết kế HTML từ Stitch thành component React Native, có `StyleSheet` và mã dành riêng cho từng nền tảng. Đây là điểm bắt đầu tốt khi bạn muốn biến prototype thành cấu trúc ứng dụng di động.

### Dựng dashboard, shadcn/ui và video walkthrough

Skill `react-vite-dashboard` hỗ trợ chuyển màn hình Stitch thành dashboard React + Vite, với TanStack Query, token từ `DESIGN.md` và các mẫu đọc dữ liệu Web3. Skill `shadcn-ui` cung cấp hướng dẫn tích hợp và xây ứng dụng với component shadcn/ui.

Skill `remotion` tạo video walkthrough từ dự án Stitch bằng Remotion, có chuyển cảnh và hiệu ứng phóng to. Đây có thể là cách nhanh để trình bày luồng sản phẩm cho nhóm nội bộ.

### Nâng cấp prompt và tạo website nhiều trang

Skill `enhance-prompt` biến ý tưởng giao diện còn chung chung thành prompt có cấu trúc và nhiều từ khóa UI/UX hơn. `stitch-loop` có thể tạo website nhiều trang từ một prompt, kèm quy trình validation tự động.

Nếu bạn muốn giao diện có phong cách cao cấp và tránh cảm giác mẫu chung, `taste-design` có thể tạo `DESIGN.md` với các yêu cầu chặt hơn về typography, màu sắc và tiêu chuẩn thiết kế.

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

Bạn cần một coding agent tương thích, chẳng hạn Codex, Antigravity, Gemini CLI, Claude Code, Cursor hoặc OpenCode. Cách cài đặt phụ thuộc vào agent bạn chọn.

Điều kiện quan trọng nhất là Stitch MCP server phải được cấu hình và đang chạy trong môi trường của agent. Bạn cần hoàn tất quy trình Stitch MCP Setup, đăng ký server, thiết lập các biến môi trường phù hợp và cấu hình thông tin xác thực theo hướng dẫn của Stitch.

README không nêu một phiên bản Node.js, Python hay hệ điều hành tối thiểu cụ thể. Các lệnh cài đặt dùng `npx`, lệnh shell và cấu hình JSON. Với OpenCode, bạn cần thêm một MCP entry từ xa vào `opencode.json`.

README cũng không cho biết mức phí sử dụng Stitch, giới hạn tài khoản hay phần cứng cần có. Không nên tự suy đoán rằng bạn cần GPU hoặc một API key cụ thể. Hãy lấy thông tin xác thực từ quy trình Stitch MCP Setup.

```note
Stitch MCP có thể cần thông tin xác thực và biến môi trường. Không đưa credential vào prompt, file công khai hoặc kho mã nguồn. Chỉ bật các quyền cần thiết cho dự án bạn đang làm.
```

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

```steps
- Chọn coding agent | Xác định bạn dùng Codex, Claude Code, Cursor, OpenCode hoặc agent khác
- Cấu hình Stitch MCP | Đăng ký server và thiết lập credential theo hướng dẫn Stitch
- Cài plugin hoặc skill | Cài cả bộ được khuyến nghị hoặc chọn từng skill
- Kiểm tra cấu hình | Mở agent và xác nhận skill cùng Stitch MCP đã được nhận diện
- Gửi prompt thử nghiệm | Tạo một màn hình nhỏ để kiểm tra luồng hoạt động
```

### Chọn cách cài phù hợp

README khuyến nghị cài plugin nếu bạn dùng Codex, Claude Code hoặc Cursor. Plugin gom các skill theo mục đích nên dễ quản lý hơn. Nếu chỉ cần một số skill, bạn có thể cài selectively bằng lệnh `npx skills add`.

OpenCode không dùng layout marketplace của Codex hoặc Claude và cũng không dùng `npx plugins` hay `npx skills` theo cách đó. Với OpenCode, bạn cần sao chép thư mục skill vào vị trí mà OpenCode có thể phát hiện.

### Cấu hình Stitch MCP

Trước khi gửi prompt tạo thiết kế, hãy hoàn tất Stitch MCP Setup. README yêu cầu server phải được cấu hình và đang chạy trong môi trường agent.

README không ghi lại một lệnh cài Stitch MCP độc lập. Vì vậy, bạn cần làm theo quy trình thiết lập của Stitch để lấy endpoint, credential và biến môi trường. Nếu bỏ qua bước này, plugin có thể được cài thành công nhưng agent vẫn không gọi được các công cụ Stitch.

### Cài plugin cho Codex

Cách dưới đây thêm marketplace Stitch Skills và giới hạn checkout vào các đường dẫn cần thiết. Bạn chạy trong terminal có lệnh `codex` và quyền sử dụng plugin.

```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` là tùy chọn. Chúng chỉ lấy các đường dẫn được liệt kê để quá trình clone nhanh hơn. Nếu muốn lấy toàn bộ repo, bạn có thể bỏ các cờ này theo hướng dẫn README.

Sau khi thêm marketplace, bạn chọn một hoặc nhiều plugin:

- `stitch-design`: workflow thiết kế.
- `stitch-build`: sinh mã và tích hợp framework.
- `stitch-utilities`: tiện ích và trợ lý cho prompt, design spec và tiêu chuẩn thiết kế.

Bạn cũng có thể cài bằng giao diện Codex. Mở `Settings → Plugin Marketplaces → Add`, nhập source là repo Stitch Skills, git ref là `main`, sau đó điền các sparse path nếu muốn checkout chọn lọc.

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

Với Claude Code, lệnh sau cài plugin vào dự án hiện tại:

```bash
npx plugins add google-labs-code/stitch-skills --scope project --target claude-code
```

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

```bash
npx plugins add google-labs-code/stitch-skills --scope workspace --target cursor
```

Hãy mở terminal tại đúng thư mục dự án trước khi chạy. `--scope project` khiến plugin thuộc dự án hiện tại của Claude Code. `--scope workspace` khiến plugin thuộc workspace hiện tại của Cursor. Nếu chạy nhầm thư mục, bạn có thể không thấy skill ở nơi mong muốn.

### Cài skill chọn lọc

Nếu bạn không muốn cài cả ba nhóm plugin, hãy dùng lệnh sau:

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

README cảnh báo các Stitch Design Skills thường có phụ thuộc lẫn nhau. Vì vậy, khi cài từng skill, bạn cần bao gồm cả các dependency bắt buộc. Nếu chưa biết skill nào phụ thuộc skill nào, nên cài plugin tương ứng thay vì chọn từng thư mục một cách tùy ý.

Để xem trợ giúp của hai công cụ cài đặt, chạy:

```bash
npx plugins --help

npx skills --help
```

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

Tạo thư mục skill ở cấp dự án:

```bash
mkdir -p .opencode/skills
```

Sao chép skill tạo thiết kế:

```bash
cp -R plugins/stitch-design/skills/generate-design .opencode/skills/generate-design
```

Bạn lặp lại lệnh `cp -R` cho các skill khác trong `plugins/*/skills/` mà dự án cần. OpenCode cũng có thể phát hiện skill trong `.claude/skills/` và `.agents/skills/`.

OpenCode yêu cầu trường `name` trong frontmatter phải là chữ thường, dạng kebab-case và trùng với tên thư mục. Các skill dùng tên dạng `stitch::…` hoặc dạng không phải kebab-case cần được đổi trường `name` và tên folder trước khi OpenCode tải chúng. Frontmatter bổ sung như `allowed-tools` sẽ bị bỏ qua.

### Thêm Stitch MCP vào OpenCode

Sau khi hoàn tất Stitch MCP Setup, mở `opencode.json` cấp dự án hoặc file `~/.config/opencode/opencode.json` rồi thêm cấu hình sau:

```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 endpoint nhận được từ quy trình Stitch MCP Setup. Credential và biến môi trường vẫn áp dụng theo hướng dẫn đó.

Tên tool trong skill có thể khác tên built-in của OpenCode. Khi điều chỉnh skill, dùng tên OpenCode như `webfetch` và `bash` thay cho `web_fetch` và `run_command` nếu cần.

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

Cách kiểm tra thực tế là mở coding agent sau khi cài, xác nhận plugin hoặc skill xuất hiện, rồi gửi một prompt nhỏ có liên quan đến Stitch. Ví dụ:

```text
Make a browse tab for a mobile app for romance and date night ideas.
```

Nếu cấu hình đúng, agent cần có thể sử dụng skill tạo thiết kế và gọi Stitch MCP. Với Codex, Claude Code hoặc Cursor, bạn kiểm tra plugin đã được cài trong đúng scope. Với OpenCode, kiểm tra skill nằm trong đường dẫn được phát hiện và MCP entry có `enabled: true`.

Bạn cũng có thể thử một prompt có project ID nếu đã có dự án Stitch:

```text
Generate 3 design variants of the home screen with dark mode and high-density layouts.
```

Kết quả mong đợi theo README là agent tạo các biến thể thiết kế trong Stitch. Nếu prompt chỉ được trả lời như văn bản thông thường và không có thao tác với Stitch, hãy kiểm tra MCP server, credential, endpoint và đường dẫn skill.

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

### Chủ shop muốn thử nhanh trang duyệt sản phẩm

Một chủ shop có thể yêu cầu tạo tab browse cho ứng dụng di động:

```text
Make a browse tab for a mobile app for romance and date night ideas.
```

Skill `stitch::generate-design` sẽ dùng yêu cầu để tạo màn hình mới trong Stitch. Chủ shop có thể tiếp tục yêu cầu đổi bố cục, màu nút hoặc tạo biến thể để so sánh các hướng giao diện trước khi đưa cho đội phát triển.

### Nhân viên sản phẩm muốn chuẩn hóa giao diện hiện có

Một nhân viên văn phòng đang quản lý website có thể yêu cầu:

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

Skill `stitch::extract-design-md` sẽ phân tích mã frontend và tạo file `DESIGN.md`. Sau đó, đội có thể dùng `stitch::manage-design-system` để tải design system lên Stitch và áp dụng theme cho các màn hình.

### Dev frontend chuyển thiết kế thành React

Một dev có dự án Stitch có thể yêu cầu:

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

Skill `stitch::react-components` hỗ trợ chuyển các màn hình thành hệ thống component React, kèm validation tự động và tính nhất quán của design token. Bạn cần thay `projects/123` bằng project ID thật trong môi trường của mình.

### Đội mobile chuyển giao diện sang React Native

Một nhóm phát triển ứng dụng có thể dùng prompt:

```text
Convert the Stitch design to React Native components with proper theme and navigation.
```

Skill `stitch::react-native` tạo component React Native với `StyleSheet`, theme và navigation theo yêu cầu. Đây là bước khởi đầu để biến thiết kế thành mã ứng dụng, nhưng đội vẫn cần kiểm tra logic nghiệp vụ, dữ liệu thật và hành vi trên từng nền tảng.

> Từ một ý tưởng giao diện đến thiết kế, design system và mã ứng dụng có thể đi qua cùng một quy trình agent.
>
> — Ông T

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

### Plugin cài xong nhưng agent không gọi được Stitch

Nguyên nhân thường là Stitch MCP chưa được đăng ký, chưa chạy hoặc thiếu credential và biến môi trường. Hãy kiểm tra lại toàn bộ Stitch MCP Setup, endpoint và thông tin xác thực trước khi sửa skill.

### Chạy lệnh ở sai thư mục

Claude Code cài theo scope project, còn Cursor cài theo scope workspace. Nếu chạy terminal ở thư mục khác, plugin có thể không xuất hiện trong dự án bạn đang mở. Hãy mở terminal tại đúng thư mục dự án hoặc workspace rồi chạy lại lệnh phù hợp.

### OpenCode không tải skill

Kiểm tra skill đã được sao chép vào `.opencode/skills`, `.claude/skills` hoặc `.agents/skills` chưa. Sau đó kiểm tra `name` trong frontmatter: giá trị này phải là lowercase kebab-case và trùng tên thư mục.

### Skill dùng tên tool không đúng với OpenCode

README lưu ý tên tool trong skill có thể dùng `web_fetch` hoặc `run_command`, trong khi OpenCode dùng `webfetch` hoặc `bash`. Khi chuyển skill sang OpenCode, hãy ưu tiên tên tool built-in của OpenCode.

### Chỉ cài một skill nhưng thiếu dependency

Stitch Design Skills có thể phụ thuộc lẫn nhau. Nếu workflow bị thiếu bước hoặc agent không hoàn thành tác vụ, hãy cài đầy đủ plugin `stitch-design` hoặc xác định và cài các dependency cần thiết thay vì chỉ sao chép một folder.

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

Nên dùng nếu bạn đang làm frontend, prototype, design system hoặc muốn nối quy trình Google Stitch với coding agent. Repo có phạm vi rõ, chia plugin theo nhóm và hỗ trợ nhiều agent. Bộ skill bao phủ khá rộng, từ tạo thiết kế, trích xuất HTML đến sinh mã React, React Native và dashboard.

Giới hạn là repo không tự thay thế Stitch MCP. Bạn vẫn phải tự cấu hình server, credential và biến môi trường. README cũng không nêu phiên bản runtime tối thiểu, chi phí, giới hạn tài khoản hoặc yêu cầu phần cứng. Vì vậy, các câu hỏi về vận hành và chi phí cần được kiểm tra trong tài liệu Stitch.

Nếu bạn dùng Codex, Claude Code hoặc Cursor, cài plugin là đường đi dễ nhất. Nếu dùng OpenCode, hãy chuẩn bị thêm thời gian để sao chép skill, đổi frontmatter khi cần và thêm MCP entry thủ công. Nếu bạn chỉ cần một công cụ dựng giao diện tĩnh, không dùng Stitch hoặc không dùng coding agent, bộ repo này có thể nhiều hơn nhu cầu.

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

### Repo này có miễn phí không?

README chỉ nêu giấy phép Apache-2.0 và không nêu chi phí sử dụng Stitch hay các giới hạn tài khoản. Vì vậy chưa thể kết luận toàn bộ quy trình sử dụng Stitch là miễn phí.

### Có cần GPU để chạy không?

Tư liệu không nêu yêu cầu GPU hoặc phần cứng cụ thể. Điều kiện được nêu rõ là coding agent tương thích và Stitch MCP server đã được cấu hình, đang chạy.

### Có chạy được trên Windows không?

README không nêu danh sách hệ điều hành được hỗ trợ. Một số lệnh cài thủ công dùng cú pháp shell như `mkdir -p` và `cp -R`, nên người dùng Windows có thể cần điều chỉnh cách chạy lệnh theo môi trường terminal của mình.

### Dữ liệu và credential có an toàn không?

README yêu cầu bạn thiết lập credential và biến môi trường theo Stitch MCP Setup nhưng không mô tả chính sách lưu trữ dữ liệu. Bạn nên giữ credential ngoài mã nguồn và chỉ cấp quyền cần thiết cho dự án.

### Repo này khác gì một thư viện component UI?

Đây là bộ Agent Skills và plugin cho coding agent làm việc với Google Stitch, không chỉ là thư viện component. Nó hỗ trợ tạo thiết kế, quản lý design system, trích xuất HTML và chuyển thiết kế thành React hoặc React Native.

### Có dùng được với OpenCode không?

Có, nhưng OpenCode cần cài thủ công. Bạn phải sao chép skill vào đường dẫn được phát hiện, kiểm tra tên skill dạng lowercase kebab-case và thêm remote Stitch MCP entry vào `opencode.json`.

### Có bắt buộc cài toàn bộ skill không?

Không. README cho phép cài plugin theo nhóm hoặc cài skill chọn lọc bằng `npx skills add`. Tuy nhiên Stitch Design Skills có dependency, nên cài chọn lọc cần bao gồm đủ các skill phụ thuộc.
