gstack là bộ skill mã nguồn mở do @garrytan xây dựng, cung cấp các slash command như /review, /qa, /office-hours để Claude Code làm việc theo flow có cấu trúc thay vì prompt dài lẫn lộn. Tài liệu này hướng dẫn bạn cài từ đầu, kể cả khi chưa quen dòng lệnh.
Trong tài liệu này
Yêu cầu trước khi cài
Cài đủ các công cụ này trước để tránh lỗi vặt. macOS/Linux gọn hơn, Windows thường cần thêm một bước.
Bắt buộc
- Claude Code — ứng dụng/CLI của Anthropic
- Git — để clone gstack từ GitHub
- Bun v1.0 trở lên
Tuỳ hệ điều hành
- Windows — thường cần cài thêm Node.js LTS
- macOS / Linux — chỉ cần Git + Bun là đủ
Vào bun.sh, chạy một lệnh cài là xong. Sau đó quay lại trang này để bắt đầu Bước 2.
Cài gstack
Chạy trong Claude Code hoặc Terminal. Lệnh sẽ clone gstack vào thư mục ~/.claude/skills rồi chạy setup tự động.
Cài thêm Node.js LTS nếu bị lỗi phụ thuộc, sau đó chạy lệnh dưới đây trong PowerShell.
Bước 2.1 — Đợi chạy xong
- Nếu gặp lỗi "permission denied" → xem Bước 6 bên dưới.
Bước 2.2 — Mở Claude Code
- Vào workspace đang làm và thử gọi slash command để xác nhận.
Thử 3 lệnh để dùng ngay
Ba lệnh này vừa giúp bạn xác nhận cài đúng, vừa là cách bắt đầu làm việc với gstack theo flow gọn nhất. Copy vào Claude Code rồi chạy thử.
Mô tả bạn đang build gì để gstack vào đúng "chế độ làm việc" phù hợp.
Soi lỗi kiểu production: edge case, dữ liệu xấu, race condition, trust boundary…
Nếu bạn có staging URL, dùng lệnh này để Claude click thật, đọc console thật và chụp screenshot thật — không phải đoán mò.
Slash commands /review, /qa, /browse, /ship; một workflow rõ ràng để Claude Code làm việc theo flow; và Browser QA để kiểm tra UI, console và screenshot thực tế — không cần prompt dài.
Thêm gstack vào repo
Nếu bạn làm team: commit skill vào repo để mọi người có cùng bộ lệnh. Người mới chỉ cần chạy setup một lần là xong, không cần giải thích gì thêm.
Sau bước này, commit thư mục .claude/skills/gstack vào repo. Đồng đội mở repo ra là dùng được ngay — không cần hướng dẫn thêm.
Cập nhật gstack lên phiên bản mới
Khi gstack có bản cập nhật, pull và chạy lại setup là xong. Toàn bộ slash command mới sẽ tự có ngay.
Nếu bạn đã copy vào repo (.claude/skills/gstack) thì cũng cập nhật ở đó và commit lại để cả team dùng chung phiên bản mới nhất.
Lỗi thường gặp
Chọn đúng lỗi của bạn bên dưới rồi làm theo 1–2 bước là xong.
Không có lệnh bun / "bun: command not found"
Cài Bun tại bun.sh trước, sau đó chạy lại Bước 2. Trên macOS, nếu cài xong mà Terminal vẫn không nhận, hãy đóng và mở lại Terminal (hoặc restart Claude Code) để PATH được load lại.
"permission denied: ./setup"
Cấp thêm quyền execute rồi chạy lại:
Claude Code không thấy slash commands
Đảm bảo bạn clone đúng vào ~/.claude/skills/gstack và đã chạy ./setup. Sau đó restart Claude Code rồi thử lại /office-hours.
Windows: lỗi thiếu Node.js
Cài Node.js LTS từ nodejs.org, rồi chạy lại Bước 2. Nếu đã có Node mà vẫn lỗi, kiểm tra lại PATH hoặc mở mới Terminal.
Cài xong? Bắt đầu với 3 lệnh này.
Đừng mở quá nhiều skill cùng lúc. Bắt đầu gọn: mô tả bạn đang build gì, review thay đổi hiện tại, rồi QA bằng staging URL nếu có.