​
Hướng dẫn ClaudeKit

Hướng dẫn đầy đủ cách sử dụng ClaudeKit Engineer và Marketing Kit, từ cài đặt đến workflow hàng ngày.

​
Yêu cầu

  • Chỉ chạy trên Claude Code CLI (claude command trong terminal)
  • KHÔNG chạy trên claude.ai web app, desktop app, VS Code/JetBrains extension
  • Cần Node.js v18+ và Claude Code v2.1+
# Cách chạy đúng
cd ~/Claude\ Code/projects/ten-project
claude
# Gõ lệnh: /plan "mô tả"

​
Cài đặt

1

Cài Claude Code CLI

npm install -g @anthropic-ai/claude-code
2

Đăng nhập

claude login
3

Copy Engineer Kit vào project

cd ~/Claude\ Code/projects/ten-project
# Copy .claude/ folder từ project template
cp -r ../template-project/.claude/ .claude/
4

Kiểm tra skills đã có

claude
# Gõ /plan rồi xem danh sách hiện ra
# Phải thấy: /plan, /cook, /fix, /test, /code-review, ...

​
Command Cheat Sheet — Engineer Kit

​
Workflow chính: Ý tưởng đến Ship

# 1. Plan
/plan "mô tả tính năng"            # Plan chuẩn (có research)
/plan:fast "task nhỏ"              # Plan nhanh (không research)
/plan:hard "task phức tạp"         # Plan sâu (research nhiều)

# 2. Implement
/cook                               # Implement theo plan đã tạo
/cook "mô tả feature"              # Tự plan + implement
/cook:auto:fast "fix nhỏ"          # Nhanh nhất

# 3. Test
/test                               # Chạy test suite
/test-gen                           # Generate tests tự động

# 4. Review
/code-review                        # Review changes hiện tại
/code-review #123                   # Review PR cụ thể
/review                             # Pre-landing review

# 5. Ship
/ship                               # Merge, test, bump version, push

​
Fix bugs

/fix "mô tả bug"                   # Auto-detect loại → routing
/fix:fast                           # Fix bug đơn giản
/fix:hard "bug phức tạp"           # Subagents plan + fix
/fix:test                           # Fix failing tests
/fix:ci                             # Fix CI/CD failures
/fix:types                          # Fix TypeScript errors
/fix:ui "layout bị vỡ"            # Fix UI issues
/fix:logs                           # Phân tích logs
/fix:parallel                       # Fix nhiều issues song song

​
Explore & Debug

/scout                              # Tìm files, hiểu cấu trúc
/scout:ext                          # Scout bằng Gemini/OpenCode
/debug "error message"              # Debug có hệ thống

​
Bootstrap project mới

/bootstrap                          # Scaffold project (interactive)
/bootstrap:auto                     # Bootstrap tự động
/bootstrap:auto:fast                # Bootstrap nhanh
/bootstrap:auto:parallel            # Bootstrap parallel

​
Quản lý skills

/skill:create "tên"                 # Tạo skill mới
/skill:update tên-skill             # Cập nhật skill
/skill:optimize tên-skill           # Tối ưu skill
/skill:add tên-skill                # Thêm reference files

​
Command Cheat Sheet — Marketing Kit

Marketing Kit chạy trong folder marketing-kit/. Commands dùng prefix /ckm:.
# Chạy Marketing Kit
cd ~/Claude\ Code/marketing-kit
claude

# Content
/ckm:write:good "topic"            # Viết content chất lượng
/ckm:write:blog "topic"            # Viết blog
/ckm:write:cro "page"              # Tối ưu conversion

# SEO
/ckm:seo:keywords "từ khóa"        # Nghiên cứu từ khóa
/ckm:seo:audit                     # Audit SEO
/ckm:seo:pseo                      # Programmatic SEO

# Campaign
/ckm:campaign:create "name"         # Tạo campaign
/ckm:campaign:email "name"          # Email campaign
/ckm:email:sequence "type"          # Email drip sequence

# Social & Analysis
/ckm:social "post"                  # Social media content
/ckm:competitor "domain"            # Phân tích đối thủ
/ckm:persona                        # Customer persona
/ckm:funnel                         # Thiết kế funnel
/ckm:analyze                        # Analytics reports

​
Workflow khuyên dùng theo tình huống

​
Feature mới phức tạp

/plan "mô tả tính năng"            # 1. Plan
# Review plan trong ./plans/
/cook                               # 2. Implement theo plan
/qa-full:check                      # 3. QA kiểm tra
/code-review                        # 4. Review
/ship                               # 5. Ship

​
Fix bug

/fix "mô tả bug"                   # Auto-detect + fix
/qa-full:regression src/file.ts     # Kiểm tra hồi quy

​
Feature nhanh (đã rõ requirements)

/cook "mô tả feature"              # Plan + implement luôn

​
Task rất nhỏ

/cook:auto:fast "fix typo in header"

​
Nhiều modules song song

/cook:auto:parallel "auth + profile + settings"

​
Vị trí cài đặt

​
Engineer Kit

projects/ten-project/.claude/
├── skills/          # SKILL.md files (logic chính)
├── commands/        # Slash commands (giao diện user)
├── agents/          # Agent definitions (AI workers)
├── hooks/           # Pre/post hooks (tự động hóa)
├── scripts/         # Helper scripts
└── settings.json    # Cấu hình hooks, permissions

​
Marketing Kit

marketing-kit/.claude/
├── skills/          # Marketing skills
├── commands/        # /ckm:* commands
└── agents/          # Marketing agents

​
Tips & Best Practices

1. Luôn plan trước khi cook Ngay cả task “đơn giản” cũng nên plan. Plan mất 30 giây nhưng tránh 30 phút debug.2. Dùng đúng sub-command /fix:types cho TypeScript errors, /fix:ci cho CI failures — đừng dùng /fix chung.3. Đọc plan output trước khi approve Plan có thể sai hoặc thừa. Review kỹ trước khi /cook.4. Dùng QA sau cook /qa-full:check sau mỗi feature đảm bảo coverage đủ.5. Đừng sợ /plan:hard Cho feature quan trọng (auth, payment), đầu tư thêm 5 phút plan sẽ tiết kiệm nhiều giờ.6. Skill Combos cho từng tình huống Feature mới: /plan → /cook → /test → /code-review → /ship Fix bug: /scout → /ck-debug → /fix → /qa-full:regression Trước release: /qa-full:full → /deploy-checklist7. Khi bị stuck Context hết → /watzup + /clear + /cook path/plan.md Fix 3 lần fail → dừng, dùng /brainstorm hoặc hỏi team
→ Xem hướng dẫn đầy đủ: Best Practices tổng hợp — anti-patterns, safety rules, team adoption, troubleshooting.

​
Lưu ý quan trọng

  • Commands dùng / prefix (ví dụ: /plan, /cook) — KHÔNG phải /ck:plan
  • Marketing commands dùng /ckm: prefix
  • Engineer Kit chạy trong project folder (ví dụ: projects/admap/)
  • Marketing Kit chạy trong marketing-kit/ folder
  • Không thể dùng 2 kit cùng lúc trong 1 session

​
Troubleshooting

​
Lỗi thường gặp

Vấn đềNguyên nhânGiải pháp
”Unknown skill”Skills nằm sai folderRestart: Ctrl+C rồi claude lại. Check .claude/skills/
Không thấy lệnh.claude/ chưa copy vào projectCopy .claude/ vào project root
Skill bị lỗiSkill cần update/skill:optimize ten-skill
Agent bị treoContext quá lớnCtrl+C rồi chạy lại
”OAuth expired”Token hết hạnclaude login
Plan quá chậmDùng hard mode cho task đơn giản/plan:fast thay vì /plan:hard
Cook bỏ qua testFlag --no-testKiểm tra command, bỏ flag
Coverage thấpTarget quá cao ngay đầu/qa-full:check --coverage 60 rồi nâng dần
Hook block toolHook config saiCheck .claude/settings.json → hooks
PRD không chi tiếtThiếu context (chưa scout)Chạy /scout trước /docs-project:prd
ck:scenario bị skipClaude dùng Agent thay vì Skill toolUSER gõ /ck:scenario TRỰC TIẾP, không để skill khác gọi
Cook không đọc PRDPlan không link docsThêm Related Docs vào plan.md → Cook sẽ đọc
MDX parse errorKý tự < > trong textDùng &lt; &gt; (không phải JSX)

​
Giới hạn quan trọng

Skills KHÔNG phải magic — hiểu giới hạn để tránh bẫy:
  • Claude có thể skip instructions (~20%) — check output có đủ bước
  • Skill gọi skill khác hay bị skip — luôn gõ từng skill trực tiếp
  • Context lớn = output ít chi tiết hơn — dùng per-sprint mode
  • Hooks (.cjs) chỉ chạy trên CLI — không chạy trên web/desktop/IDE
→ Xem chi tiết: Best Practices — Giới hạn cần biết

​
So sánh Engineer Kit vs Marketing Kit

Tính năngEngineer KitMarketing Kit
Prefix/ (plan, cook, fix)/ckm: (write, seo, campaign)
Chạy trongprojects/ten-project/marketing-kit/
Agents17 agents (coder, tester, reviewer…)32 agents (copywriter, seo-expert…)
Skills86 skills68 skills
MCP serversKhông8 MCP servers (storage, analytics…)
FocusCode quality, testing, deploymentContent, SEO, campaigns