​
Cài đặt Skills cho Team

Hướng dẫn cài đặt bộ Claude Code Skills đầy đủ cho team PrimeCommerce. Chỉ cần 3 bước: download → install → verify.
Skills CHỈ chạy trên Claude Code CLI (terminal). KHÔNG chạy trên claude.ai web, desktop app, VS Code extension, hay JetBrains extension.

​
1. Yêu cầu hệ thống

Yêu cầuVersionKiểm tra
macOS hoặc Linux(Windows cần WSL2)—
Node.js>= 20 (khuyên v22)node --version
Claude Code CLILatestclaude --version
GitAnygit --version
# Kiểm tra tất cả
node --version        # >= v20
claude --version      # Phải có output
claude auth status    # Phải đã đăng nhập

​
2. Download Skill Package

Download file: team-claude-skills.zip (Lark Drive — yêu cầu quyền truy cập)Liên hệ Tech Lead nếu chưa có quyền download.
Giải nén: 
# Download file từ Lark Drive về ~/Downloads/
cd ~/Downloads
unzip team-claude-skills.zip
cd team-claude-skills
Bên trong gói: 
team-claude-skills/
├── skills/              # 70+ skill folders
├── commands/            # Tất cả commands + sub-commands
├── agents/              # qa-engineer, docs-engineer
├── hooks/               # 2 hooks enforce
├── docs/                # 2 file hướng dẫn
├── install-scripts/     # 6 install scripts theo vai trò
│   ├── install-all.sh   # Lead/Senior
│   ├── install-dev.sh   # Dev
│   ├── install-qc.sh    # QC
│   ├── install-pm.sh    # PM
│   ├── install-design.sh # UI/UX Designer
│   └── install-devops.sh # DevOps
└── README.md

​
3. Cài đặt theo vai trò

Chọn script phù hợp với vai trò — chỉ cần 1 lệnh: 
bash install-scripts/install-dev.sh
Cài: plan, cook, fix, code, scout, debug, qa-full, code-review, test, ship, docs-project + hooksLệnh hay dùng sau cài:
/plan "feature"    /cook    /fix "bug"    /qa-full:check    /ship

​
4. Kiểm tra sau cài

1

Mở Claude Code CLI

cd ~/your-project
claude
2

Kiểm tra skills

/find-skills
Phải hiển thị danh sách skills đã cài.
3

Chạy thử

/plan:fast "add a hello world endpoint"    # Test plan
/qa-full:audit                              # Test QA
/docs-project:guide                         # Test docs

​
Checklist

  • claude --version chạy OK
  • /find-skills hiển thị skills
  • /plan:fast "test" chạy không lỗi
  • /qa-full:audit chạy không lỗi (QC/Dev)
  • Hooks không báo lỗi khi khởi động

​
5. Cập nhật Skills

Khi có phiên bản mới (Tech Lead thông báo qua Lark): 
# 1. Download file mới từ Lark Drive
cd ~/Downloads
unzip -o team-claude-skills.zip
cd team-claude-skills

# 2. Chạy lại install script theo vai trò
bash install-scripts/install-dev.sh     # hoặc install-qc.sh, install-pm.sh
Không bao giờ:
  • Sửa trực tiếp files trong ~/.claude/skills/ (sẽ bị ghi đè khi update)
  • Xoá ~/.claude/settings.json (mất cấu hình permissions)
  • Chạy rm -rf ~/.claude/ (xoá hết tất cả!)

​
6. Xử lý lỗi

LỗiNguyên nhânFix
”Unknown skill: xxx”File thiếuls ~/.claude/skills/xxx/SKILL.md — nếu thiếu, chạy lại install script
”Permission denied”Thiếu quyền executechmod +x ~/.claude/hooks/*.cjs
Skills không hiệnClaude chưa reloadThoát (exit) rồi mở lại (claude)
Hooks không chạysettings.json thiếu configcat ~/.claude/settings.json | grep hooks — chạy lại install
Claude skip instructionsGiới hạn cốt lõiChạy lại hoặc gõ: “hãy follow đúng skill”

​
7. Hiểu 3 cấp độ cài đặt

Skills có thể cài ở 3 cấp — ưu tiên từ thấp lên cao:
Quy tắc ghi đè: Project > Global. Nếu cùng 1 skill tồn tại ở cả 2 nơi, bản project-level sẽ được dùng.
CấpVị tríScopeKhi nào dùng
Global~/.claude/Mọi projectSkills chung cho team (qa-full, docs-project, plan…)
Projectproject/.claude/1 projectSkills riêng cho project đó (custom cook, hooks riêng…)
WorktreeKế thừa từ projectTạm thờiKhông cần cài — tự có từ project gốc

​
Script cài đặt → cài vào Global (~/.claude/)

Khi chạy bash install-dev.sh, tất cả skills được copy vào ~/.claude/ — nghĩa là mở claude ở bất kỳ project nào đều thấy skills. 
~/.claude/                          ← Global (script cài vào đây)
├── skills/
│   ├── qa-full/SKILL.md           # Dùng ở mọi project
│   ├── docs-project/SKILL.md
│   ├── cook/SKILL.md
│   └── ...
├── commands/
│   ├── qa-full.md + qa-full/
│   ├── plan.md + plan/
│   └── ...
├── agents/
│   └── qa-engineer.md
└── hooks/
    └── qa-context-inject.cjs

​
Khi nào cần cài Project-level?

Nếu 1 project cần ghi đè skill (ví dụ: /cook riêng cho project đó), tạo file trong: 
~/projects/my-project/.claude/      ← Project-level (ghi đè global)
├── commands/
│   └── cook.md                    # Cook riêng cho project này
└── hooks/
    └── pre-commit.cjs             # Hook riêng cho project này
Ví dụ thực tế:
  • /qa-full cài global → tất cả projects dùng chung ✅
  • /cook cài project-level ở admap/.claude/ → chỉ admap dùng bản riêng, các project khác dùng bản global ✅

​
Bước tiếp theo

Đọc Best Practices

Anti-patterns, skill combos, safety rules — dùng skills hiệu quả.

Xem workflow team

Quy trình phối hợp PM → Design → Dev → QA → DevOps.

Chọn lệnh theo vai trò

Decision tree: dùng lệnh nào cho tình huống nào.

Tổng quan công cụ

Danh sách tất cả skills, agents, MCP servers.