# stitch-skills: bộ kỹ năng thiết kế UI với Stitch — hướng dẫn cài đặt và dùng

> google-labs-code/stitch-skills là bộ Agent Skills và plugin dành cho Google Stitch, hỗ trợ tạo giao diện, quản lý design system và sinh mã. Repo tương thích với Codex, Claude Code, Cursor, Gemini CLI và một số coding agent khác; việc cài đặt khá thẳng nếu Stitch MCP đã được cấu hình.

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

google-labs-code/stitch-skills là 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, quản lý design system, đưa mã frontend vào Stitch rồi chuyển thiết kế thành mã React hoặc React Native.

Repo phù hợp với chủ shop, nhân viên văn phòng, designer, developer mới và đội sản phẩm muốn đi nhanh từ ý tưởng giao diện đến prototype hoặc mã frontend. Điểm đáng giá nhất là các skill được chia theo nhóm rõ ràng: thiết kế, build và tiện ích. Bạn chỉ cài phần cần dùng, hoặc cài cả bộ để có quy trình đầy đủ.

Nếu muốn xem cách repo hoạt động trong thực tế, bạn có thể xem video ngắn bên dưới. Repo có khoảng 8755 sao và 1057 fork, dùng giấy phép Apache-2.0, viết chủ yếu bằng TypeScript.

```repo
- repo | google-labs-code/stitch-skills
- kind | Skill
- desc | Bộ Agent Skills giúp coding agent tạo, quản lý thiết kế Stitch và chuyển thiết kế thành mã React, React Native.
- 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 màn hình từ mô tả hoặc hình ảnh

Skill `stitch::generate-design` giúp agent tạo màn hình mới trong Stitch từ yêu cầu bằng chữ hoặc hình ảnh. Bạn có thể yêu cầu tạo trang đăng nhập, trang duyệt nội dung, màn hình cho ứng dụng di động hoặc nhiều biến thể của cùng một màn hình.

Lợi ích thực tế là bạn không cần bắt đầu từ một file thiết kế trống. Chỉ cần mô tả mục tiêu, phong cách, chế độ sáng tối hoặc mật độ thông tin, agent có thể hỗ trợ tạo hướng thiết kế để bạn tiếp tục chỉnh sửa.

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

Skill `stitch::code-to-design` đọc mã frontend như React hoặc Vue, trích xuất HTML, xây dựng design system rồi tải kết quả lên Stitch. Tính năng này hữu ích khi doanh nghiệp đã có website nhưng muốn đưa giao diện hiện tại vào quy trình thiết kế tập trung.

Bạn có thể dùng nó để lập tài liệu hóa giao diện cũ, chuẩn bị cho việc cải tiến sản phẩm hoặc giúp designer và developer cùng nhìn một hệ thống thiết kế.

### Quản lý design system

`stitch::manage-design-system` cho phép tải file `DESIGN.md` lên Stitch và áp dụng theme cho các màn hình. Các skill `design-md` và `taste-design` hỗ trợ phân tích dự án, tạo đặc tả thiết kế hoặc đưa ra bộ nguyên tắc giao diện có tính nhất quán hơn.

Trong công việc thật, đây là cách giữ màu sắc, kiểu chữ, khoảng cách và quy tắc giao diện không bị lệch giữa nhiều màn hình. Bạn cũng có thể dùng `extract-design-md` để quét mã nguồn frontend và tạo `DESIGN.md` từ hệ thống đang có.

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

`stitch::extract-static-html` trích xuất HTML tĩnh tự chứa từ một web app đang chạy, gồm CSS và hình ảnh được nhúng. `stitch::upload-to-stitch` hỗ trợ tải tài sản cục bộ như hình ảnh, mockup hoặc HTML lên một dự án Stitch.

Các skill này hữu ích khi bạn cần lưu một phiên bản giao diện để bàn giao, review hoặc làm nền cho một vòng thiết kế mới.

### Chuyển thiết kế thành mã React và React Native

Nhóm build có `stitch::react-components` để chuyển các màn hình Stitch thành hệ thống component React, kèm kiểm tra tự động và giữ tính nhất quán của design token. `stitch::react-native` chuyển thiết kế HTML thành component React Native, có `StyleSheet` và phần mã theo nền tảng.

Điều này phù hợp khi team muốn dùng Stitch để đi từ ý tưởng đến mã ứng dụng, thay vì chỉ dừng ở prototype. Repo cũng có `react-vite-dashboard` cho dashboard React + Vite, cùng các hướng dẫn liên quan đến TanStack Query, token trong `DESIGN.md` và cách đọc dữ liệu Web3.

### Tạo video walkthrough và hỗ trợ component

Skill `remotion` tạo video walkthrough từ dự án Stitch với chuyển cảnh và hiệu ứng zoom. Skill `shadcn-ui` hỗ trợ tích hợp và xây dựng ứng dụng dùng component shadcn/ui, chẳng hạn bảng dữ liệu có sắp xếp và lọc.

### Cải thiện prompt và dựng website nhiều trang

`enhance-prompt` biến một yêu cầu UI ngắn thành prompt rõ hơn, có các từ khóa UI/UX phù hợp với Stitch. `stitch-loop` hỗ trợ tạo website nhiều trang từ một prompt và kiểm tra tự động.

Ví dụ, thay vì chỉ viết “tạo trang cài đặt”, bạn có thể nhờ skill làm rõ cấu trúc, thành phần, trạng thái và phong cách trước khi gửi yêu cầu cho Stitch.

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

Trước hết, bạn cần cấu hình và chạy Stitch MCP server trong môi trường của coding agent. README yêu cầu bạn làm theo hướng dẫn Stitch MCP Setup để đăng ký server, thiết lập biến môi trường, thông tin xác thực và endpoint phù hợp.

Bạn cần một coding agent tương thích. README nêu Codex, Antigravity, Gemini CLI, Claude Code, Cursor và OpenCode. Cách cài thay đổi theo từng agent.

Repo dùng TypeScript, nhưng README không yêu cầu bạn cài riêng Node.js theo một phiên bản cụ thể. Một số cách cài dùng các lệnh `npx plugins` và `npx skills`, vì vậy môi trường của bạn phải có thể chạy được các lệnh này.

Với OpenCode, bạn cần có quyền tạo thư mục skill trong dự án và chỉnh file `opencode.json`. Bạn cũng cần endpoint Stitch MCP lấy từ quy trình thiết lập Stitch MCP. README không nêu cụ thể chi phí, hạn mức hay yêu cầu GPU.

```note
Stitch MCP cần thông tin xác thực và biến môi trường theo hướng dẫn thiết lập của Stitch. Không đưa key hoặc credential vào prompt, file chia sẻ chung hay mã nguồn công khai.
```

## 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 cài skill chọn lọc
- Cài plugin | Đăng ký marketplace và cài nhóm skill cần dùng
- Cấu hình Stitch MCP | Đăng ký server, biến môi trường, credential và endpoint
- Cài skill thủ công nếu cần | Sao chép thư mục skill vào vị trí OpenCode có thể phát hiện
- Kiểm tra lệnh hỗ trợ | Mở help của plugins hoặc skills để xác nhận công cụ đã sẵn sàng
```

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

Nếu bạn dùng Codex, README khuyến nghị cài plugin toàn cục qua marketplace. Đây là cách nhanh để cài cả bộ Stitch và sau đó chọn nhóm `stitch-design`, `stitch-build` hoặc `stitch-utilities`.

Claude Code và Cursor dùng lệnh `npx plugins` với phạm vi khác nhau. OpenCode không dùng layout marketplace của Codex hoặc Claude Code, nên cần sao chép skill thủ công và thêm MCP từ xa vào file cấu hình.

### Cài plugin cho Codex

Mở terminal tại nơi bạn muốn thực hiện thao tác marketplace, sau đó chạy lệnh sau:

```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
```

Lệnh này thêm marketplace Stitch Skills theo nhánh `main`. Các cờ `--sparse` giới hạn phần checkout vào những đường dẫn cần thiết, giúp clone nhanh hơn. README nói các cờ này là tùy chọn; nếu bỏ chúng, bạn sẽ lấy toàn bộ repository.

Sau khi marketplace được đăng ký, bạn cài một hoặc nhiều plugin:

- `stitch-design`: các skill tập trung vào thiết kế.
- `stitch-build`: các skill chuyển thiết kế thành mã và component.
- `stitch-utilities`: các skill tiện ích và trợ lý.

Nếu không muốn dùng CLI, trong Codex hãy vào `Settings → Plugin Marketplaces → Add`. Điền source của marketplace, git ref là `main`, sau đó có thể nhập các sparse path như `.agents/plugins`, `plugins/stitch-design`, `plugins/stitch-build` và `plugins/stitch-utilities`.

Người mới thường cài cả ba nhóm trước để tránh thiếu dependency. Nếu chỉ cài từng skill, hãy kiểm tra các skill phụ thuộc mà README hoặc file trong repo yêu cầu.

### Cài cho Claude Code và Cursor

Với Claude Code, chạy lệnh sau trong thư mục dự án:

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

Lệnh này cài plugin vào phạm vi project hiện tại. Hãy mở terminal đúng thư mục dự án mà bạn muốn agent sử dụng.

Với Cursor, chạy:

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

Lệnh này cài plugin vào workspace hiện tại. Nếu Cursor đang mở một workspace khác, hãy kiểm tra lại thư mục trước khi chạy.

### Cài cho OpenCode

OpenCode cần cài skill và Stitch MCP riêng. Trước hết, tạo thư mục skill cục bộ trong dự án:

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

Lệnh đầu tạo thư mục `.opencode/skills`. Lệnh thứ hai sao chép skill `generate-design` từ repository vào vị trí OpenCode có thể phát hiện. Muốn dùng skill khác, lặp lại lệnh `cp -R` với các thư mục tương ứng dưới `plugins/*/skills/`.

OpenCode cũng phát hiện skill trong `.claude/skills/` và `.agents/skills/`. Khi sao chép, hãy chú ý quy tắc đặt tên: 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 có tên dạng `stitch::…` hoặc dạng khác cần đổi trường `name` và tên folder trước khi OpenCode tải chúng. README cũng lưu ý `allowed-tools` sẽ bị bỏ qua.

Tiếp theo, thêm Stitch MCP vào `opencode.json` ở cấp project hoặc file cấu hình người dùng:

```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 lấy từ quy trình thiết lập Stitch MCP. Credential và biến môi trường vẫn phải làm theo hướng dẫn của Stitch MCP. Khi điều chỉnh skill cho OpenCode, ưu tiên tên tool của OpenCode như `webfetch` và `bash` thay cho `web_fetch` và `run_command` nếu skill đang dùng tên khác.

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

Nếu chỉ cần một số skill, chạy:

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

Cách này phù hợp khi bạn muốn giữ môi trường gọn. Tuy nhiên, README cảnh báo các Stitch Design Skills thường có quan hệ phụ thuộc. Nếu cài chọn lọc, bạn cần đưa vào đầy đủ các dependency bắt buộc.

Để xem hướng dẫn lệnh:

```bash
npx plugins --help

npx skills --help
```

Hai lệnh trên giúp bạn xem cú pháp hỗ trợ của công cụ cài đặt. README không cung cấp một lệnh riêng để kiểm tra toàn bộ Stitch MCP, nên phần xác nhận MCP cần thực hiện trong coding agent và theo hướng dẫn thiết lập Stitch.

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

Bạn có thể kiểm tra theo bốn dấu hiệu sau.

### Kiểm tra plugin hoặc skill đã xuất hiện

Sau khi cài, coding agent cần nhận diện được nhóm plugin hoặc thư mục skill. Với cách cài OpenCode, kiểm tra thư mục `.opencode/skills` có skill bạn đã sao chép. Nếu skill không được nhận diện, kiểm tra lại tên folder và trường `name` trong frontmatter.

### Kiểm tra Stitch MCP đã kết nối

Agent phải có Stitch MCP được cấu hình và đang chạy. Với OpenCode, mục `stitch` trong `opencode.json` cần có `type` là `remote`, có URL và `enabled` là `true`. Nếu endpoint vẫn là `YOUR_STITCH_MCP_URL`, cấu hình chưa hoàn tất.

### Chạy một yêu cầu nhỏ

Gửi prompt đơn giản như:

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

Kết quả mong đợi là agent dùng skill tạo thiết kế trong Stitch. Nếu agent chỉ trả lời bằng văn bản hoặc báo không tìm thấy tool, hãy kiểm tra MCP và skill đã được tải chưa.

### Kiểm tra bằng help

Chạy `npx plugins --help` và `npx skills --help`. Nếu công cụ trả về phần hướng dẫn thay vì lỗi không tìm thấy lệnh, phần CLI tương ứng đã có thể sử dụng.

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

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

Một chủ shop có ý tưởng làm trang duyệt sản phẩm cho ứng dụng di động nhưng chưa có bản thiết kế. Bạn có thể gửi prompt:

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

Skill `stitch::generate-design` sẽ hỗ trợ tạo màn hình từ mô tả. Chủ shop có thể dùng kết quả để trao đổi với designer, kiểm tra bố cục và quyết định hướng tiếp theo trước khi thuê đội phát triển.

### Nhân viên sản phẩm cần sửa màn hình đăng nhập

Khi team muốn bổ sung ô “Remember Me” và đổi màu nút, hãy mô tả trực tiếp:

```text
Edit the login screen to add a 'Remember Me' checkbox and change the button color to blue.
```

Kết quả là một yêu cầu chỉnh sửa cụ thể trên màn hình hiện có. Cách này phù hợp với các vòng review nhanh, khi người phụ trách sản phẩm muốn diễn đạt thay đổi bằng ngôn ngữ tự nhiên.

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

Developer có một dự án Stitch và muốn tạo component React cho toàn bộ màn hình. Có thể dùng prompt:

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

Skill `stitch::react-components` hỗ trợ chuyển màn hình thành hệ thống component, đồng thời chú ý validation và tính nhất quán của design token. Developer vẫn cần review mã sinh ra, kết nối dữ liệu thật và kiểm thử trước khi đưa vào sản phẩm.

### Team mobile đồng bộ thiết kế sang React Native

Một team muốn xây app đa nền tảng có thể yêu cầu:

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

Skill `stitch::react-native` hướng tới component React Native có `StyleSheet`, theme và navigation phù hợp. Đây là điểm bắt đầu cho developer; các phần như API, logic nghiệp vụ, kiểm thử thiết bị và phát hành vẫn cần đội phát triển hoàn thiện.

> Từ một prompt rõ ràng, team có thể đi nhanh hơn từ ý tưởng giao diện đến bản thiết kế và component đầu tiên.
>
> — Ông T

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

### Agent không thấy Stitch MCP

Nguyên nhân thường là server chưa được đăng ký, chưa chạy hoặc biến môi trường và credential chưa được thiết lập. Hãy làm lại các bước trong Stitch MCP Setup, kiểm tra endpoint và khởi động lại coding agent.

### OpenCode không tải skill

Kiểm tra skill đã nằm trong `.opencode/skills`, `.claude/skills` hoặc `.agents/skills` chưa. Sau đó kiểm tra `name` trong frontmatter có phải chữ thường, dạng kebab-case và trùng tên thư mục hay không.

### Cài chọn lọc nhưng skill báo thiếu phụ thuộc

Stitch Design Skills có thể phụ thuộc lẫn nhau. Hãy đọc `SKILL.md` và các file liên quan trong repo để cài thêm skill bắt buộc, thay vì chỉ cài một thư mục nhìn thấy trong danh sách.

### Dùng sai tên tool khi chuyển sang OpenCode

Một số hướng dẫn trong skill có thể dùng `web_fetch` hoặc `run_command`. README khuyên khi điều chỉnh cho OpenCode hãy ưu tiên `webfetch` hoặc `bash`, là tên tool tương ứng trong OpenCode.

### Cấu hình OpenCode vẫn dùng URL mẫu

Nếu `opencode.json` còn `YOUR_STITCH_MCP_URL`, OpenCode chưa thể kết nối endpoint thật. Hãy thay bằng endpoint từ quy trình thiết lập Stitch MCP và bảo đảm credential, biến môi trường được cấu hình đúng.

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

Nên dùng nếu bạn đang làm việc với Google Stitch và muốn đưa coding agent vào quy trình thiết kế, xây component hoặc quản lý design system. Repo có nhiều skill cho cả giai đoạn ý tưởng, thiết kế, trích xuất HTML, sinh mã React và React Native. Cách chia thành ba plugin cũng giúp team chọn đúng nhóm chức năng.

Điểm mạnh khác là repo theo Agent Skills open standard và tương thích với nhiều coding agent. Giấy phép Apache-2.0 cũng phù hợp cho nhiều tình huống sử dụng phần mềm, nhưng bạn vẫn nên kiểm tra chính sách nội bộ của công ty.

Giới hạn chính là repo không thay thế Stitch MCP. Bạn phải cấu hình server, endpoint, credential và biến môi trường trước. Một số skill có dependency, còn OpenCode cần thao tác thủ công nhiều hơn. README cũng không nói cụ thể về chi phí, hạn mức, GPU hay chính sách lưu trữ dữ liệu, nên bạn cần xem tài liệu Stitch trước khi dùng với dữ liệu nhạy cảm.

Nếu bạn chỉ cần tạo giao diện tĩnh đơn giản và không dùng Stitch, bộ skill này có thể nhiều hơn nhu cầu. Nếu cần mã production, hãy xem kết quả do agent sinh ra là bản khởi đầu; team vẫn phải review kiến trúc, bảo mật, dữ liệu, accessibility và kiểm thử. Nếu cần quy trình thiết kế có MCP và muốn tự động hóa nhiều bước, `google-labs-code/stitch-skills` là lựa chọn đáng thử.

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

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

README không nêu chi phí sử dụng repo hoặc Stitch MCP. Repo dùng giấy phép Apache-2.0, nhưng chi phí và hạn mức của dịch vụ Stitch chưa được cung cấp trong tư liệu.

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

Tư liệu không nói repo yêu cầu GPU. Repo là bộ Agent Skills và plugin, nhưng bạn vẫn cần cấu hình Stitch MCP trong coding agent.

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

README không nêu hệ điều hành được hỗ trợ cụ thể. Các lệnh được cung cấp dùng cú pháp shell Unix như `mkdir -p` và `cp -R`, nên khi dùng Windows bạn cần kiểm tra môi trường terminal hoặc cách tương đương của coding agent.

### Có cần cài Node.js không?

README không nêu phiên bản Node.js cụ thể. Một số cách cài dùng `npx plugins` và `npx skills`, vì vậy môi trường cần chạy được các lệnh này.

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

Tư liệu yêu cầu cấu hình credential và biến môi trường cho Stitch MCP nhưng không mô tả chính sách lưu trữ dữ liệu. Không nên đưa key vào prompt, file chia sẻ chung hoặc mã nguồn công khai; hãy xem hướng dẫn Stitch MCP trước khi dùng dữ liệu nhạy cảm.

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

Đây là bộ Agent Skills và plugin cho 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 mã React hoặc React Native.

### OpenCode có cài giống Codex hoặc Claude Code không?

Không. README nói OpenCode không dùng `npx plugins`, `npx skills` hoặc layout marketplace của Codex và Claude. Bạn cần sao chép skill vào thư mục được phát hiện, chỉnh tên skill nếu cần và thêm Stitch MCP vào `opencode.json`.
