stitch-skills: bộ kỹ năng thiết kế UI với Stitch — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về google-labs-code/stitch-skills — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: 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 →

Tóm tắt nhanh
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.
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.
google-labs-code/stitch-skills
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.
I.Stitch Skills làm được gì
A.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.
B.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ế.
C.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ó.
D.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.
E.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.
F.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.
G.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.
II.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.
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.
III.Cài đặt từng bước
- Chọn coding agentXá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ầnSao 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
A.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.
B.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:
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-utilitiesLệ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.Cài cho Claude Code và Cursor
Với Claude Code, chạy lệnh sau trong thư mục dự án:
npx plugins add google-labs-code/stitch-skills --scope project --target claude-codeLệ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:
npx plugins add google-labs-code/stitch-skills --scope workspace --target cursorLệ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.
D.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:
mkdir -p .opencode/skills
cp -R plugins/stitch-design/skills/generate-design .opencode/skills/generate-designLệ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:
{
"$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.
E.Cài skill chọn lọc
Nếu chỉ cần một số skill, chạy:
npx skills add google-labs-code/stitch-skillsCá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:
npx plugins --help
npx skills --helpHai 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.
IV.Kiểm tra đã chạy được chưa
Bạn có thể kiểm tra theo bốn dấu hiệu sau.
A.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.
B.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.
C.Chạy một yêu cầu nhỏ
Gửi prompt đơn giản như:
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.
D.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.
V.Dùng vào việc thật
A.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:
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.
B.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:
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.
C.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:
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.
D.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:
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
VI.Lỗi hay gặp và cách xử lý
A.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.
B.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.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.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.
E.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.
VII.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`.


