Slash commands là cơ chế shortcut mạnh mẽ trong Claude Code, giúp bạn điều khiển hành vi của AI mà không cần gõ lại prompt dài. Bài viết này tổng hợp đầy đủ các loại slash commands, cách tạo command tùy chỉnh dạng Skills, và ứng dụng thực tế cho blog cá nhân.

Claude Code Slash Commands: Từ cơ bản đến nâng cao

1. Slash Commands là gì?

Slash commands là shortcut điều khiển hành vi của Claude Code trong phiên làm việc tương tác. Bạn gõ /tên-lệnh và Claude thực thi instruction đã định sẵn, thay vì phải nhập lại prompt dài mỗi lần.

Có 4 loại slash commands chính:

⚠️ Lưu ý quan trọng: Custom slash commands đã được gộp vào Skills. Files trong .claude/commands/ vẫn chạy được nhưng .claude/skills/ là cách được khuyên dùng hiện nay. Cả hai đều tạo ra shortcut /command-name.

2. Built-in Commands - Tham khảo nhanh

Có hơn 55+ built-in commands và 5 bundled skills. Gõ / trong Claude Code để xem tất cả, hoặc / + chữ cái để filter.

Quản lý phiên & cấu hình

Quản lý hội thoại & context

Phiên & rewind

Memory & Skills

Lập kế hoạch & thực thi

Code review & PR

Bundled Skills

3. Custom Commands - Skills (cách dùng mới)

Hai cách tạo /command-name:

Nếu cùng tên, skill thắng. Ví dụ: cả .claude/commands/review.md và .claude/skills/review/SKILL.md cùng tồn tại — bản skill được dùng.

Tại sao nên dùng Skills?

• Cấu trúc thư mục — bundle scripts, templates, reference files cùng skill
• Auto-invocation — Claude tự gọi khi context phù hợp
• Invocation control — chọn user/Claude/cả hai có thể gọi
• Subagent execution — chạy trong context isolated với context: fork
• Progressive disclosure — load file phụ chỉ khi cần

Cách tạo command custom (dạng skill)

mkdir -p .claude/skills/my-command

File .claude/skills/my-command/SKILL.md:

---
name: my-command
description: What this command does and when to use it
---

# My Command

Instructions for Claude to follow when this command is invoked.

1. First step
2. Second step
3. Third step

Frontmatter - Reference đầy đủ

Arguments - 2 cách

Tất cả argument với $ARGUMENTS:

---
name: fix-issue
description: Fix a GitHub issue by number
---

Fix issue #$ARGUMENTS following our coding standards

Dùng: /fix-issue 123 → $ARGUMENTS = "123"

Argument riêng lẻ với $0, $1...:

---
name: review-pr
description: Review a PR with priority
---

Review PR #$0 with priority $1

Dùng: /review-pr 456 high → $0="456", $1="high"

Dynamic context với shell command

Chạy bash command trước prompt với ! prefix:

---
name: commit
description: Create a git commit with context
allowed-tools: Bash(git *)
---

## Context

- Current git status: !`git status`
- Current git diff: !`git diff HEAD`
- Current branch: !`git branch --show-current`
- Recent commits: !`git log --oneline -5`

## Your task

Based on the above changes, create a single git commit.

File references với @

Review the implementation in @src/utils/helpers.js
Compare @src/old-version.js with @src/new-version.js

User-only command (không cho Claude tự gọi)

Cho command có side effects (deploy, delete...):

---
name: deploy
description: Deploy to production
disable-model-invocation: true
allowed-tools: Bash(npm *), Bash(git *)
---

Deploy the application to production:

1. Run tests
2. Build application
3. Push to deployment target
4. Verify deployment

4. Plugin Commands & MCP Prompts

Plugin Commands

Plugins có thể cung cấp custom command:

/plugin-name:command-name

Hoặc đơn giản /command-name khi không có conflict tên.

MCP Prompts as Commands

MCP servers có thể expose prompts dưới dạng slash command:

/mcp__<server-name>__<prompt-name> [arguments]

Examples:

/mcp__github__list_prs
/mcp__github__pr_review 456
/mcp__jira__create_issue "Bug title" high

MCP Permission syntax:

• mcp__github — truy cập toàn bộ GitHub MCP server
• mcp__github__* — wildcard mọi tool
• mcp__github__get_issue — chỉ tool cụ thể

5. Lifecycle - Slash Command chạy như thế nào

User gõ /optimize
  ↓
Claude Code tìm trong .claude/skills/ và .claude/commands/
  ↓
Tìm thấy optimize/SKILL.md
  ↓
Parse YAML frontmatter
  ↓
Thực thi !`shell command` (nếu có)
  ↓
Substitute $ARGUMENTS / $0, $1...
  ↓
Gửi prompt đầy đủ tới Claude
  ↓
Claude xử lý → trả kết quả cho user

6. Best Practices

7. Workflow ứng dụng cho Blog Project

Với project blog cá nhân, dưới đây là một số slash commands hữu ích bạn có thể tự tạo:

/new-post - Tạo skeleton bài blog

---
name: new-post
description: Create a new blog post skeleton with frontmatter
argument-hint: [post-title]
---

Create a new blog post file at `blog/$ARGUMENTS.md` with:

1. YAML frontmatter (title, date, slug, tags, description)
2. H1 heading từ title
3. Section "Introduction"
4. Section "Main Content" với 2-3 H2 subheadings
5. Section "Conclusion"
6. Slug từ title (kebab-case, không tiếng Việt có dấu)

/seo-check - Kiểm tra SEO bài viết

---
name: seo-check
description: Check SEO of the current blog post
allowed-tools: Read
---

Đọc bài viết @$ARGUMENTS và kiểm tra:

1. Title length (50-60 ký tự)
2. Meta description (150-160 ký tự)
3. Mật độ keyword
4. H1/H2/H3 hierarchy
5. Internal links và external links
6. Image alt texts
7. Slug chuẩn SEO

Đưa ra recommendations cụ thể với line numbers.

/publish-post - Publish + commit + push

---
name: publish-post
description: Validate, commit, and push a new blog post
allowed-tools: Bash(git *), Bash(npm *)
disable-model-invocation: true
---

## Context

- Current branch: !`git branch --show-current`
- Changed files: !`git status --short`

## Steps

1. Chạy `npm run lint` và `npm run build` — fix lỗi nếu có
2. Stage chỉ files liên quan tới bài post mới
3. Commit message: "post: <title của bài>"
4. Push lên remote
5. Đưa ra link preview Vercel

/optimize-image - Tối ưu ảnh blog

---
name: optimize-image
description: Suggest image optimization for blog post
allowed-tools: Read, Bash(file *)
argument-hint: [image-path]
---

Analyze @$ARGUMENTS:
- Format hiện tại
- Kích thước (KB/MB)
- Dimensions

Đưa ra:
1. Format khuyến nghị (WebP/AVIF cho web)
2. Compression command (cwebp, sharp)
3. Responsive sizes (srcset suggestions)
4. Alt text dựa trên context bài viết

8. Câu hỏi thường gặp (FAQ)

Q1: Sự khác biệt giữa /commands và /skills?

Cả hai đều tạo /command-name. Khác biệt chính:

• /commands là cách cũ — chỉ là 1 file .md đơn lẻ.
• /skills là cách mới — là thư mục chứa SKILL.md + scripts/templates kèm theo, hỗ trợ auto-invocation và subagent execution.

Khi cùng tên, skill thắng. Files trong .claude/commands/ cũ vẫn chạy nhưng nên migrate dần.

Q2: Slash command nên đặt cấp project hay user?

• Project-level (.claude/commands/ hoặc .claude/skills/) — commit git, share với team
• User-level (~/.claude/commands/ hoặc ~/.claude/skills/) — preference cá nhân, dùng cho mọi project

Cho blog cá nhân: bạn có thể dùng project-level cho command đặc thù blog (ví dụ /new-post), và user-level cho command chung (ví dụ /optimize).

Q3: Làm sao Claude biết khi nào auto-invoke skill mà không cần user gõ?

Phụ thuộc vào field description trong frontmatter. Description càng rõ ràng về trigger conditions thì Claude càng dễ tự gọi đúng lúc.

Ví dụ tốt:

description: Generate API documentation from JSDoc comments. Use when user asks to "document API", "create docs", or has changes in src/api/.

Ví dụ dở:

description: API docs

Q4: Khi nào nên đặt disable-model-invocation: true?

Khi command có side effects nguy hiểm: deploy, delete, push, payment... Bạn không muốn Claude tự gọi mà phải user trực tiếp gõ.

Ví dụ: /deploy, /drop-database, /cancel-subscription.

Q5: Lệnh ! trong slash command có chạy được lệnh nguy hiểm không?

! chạy bash command thực, CÓ rủi ro nếu argument từ user không validate. Phải:

1. Whitelist allowed-tools cụ thể (ví dụ Bash(git *) chỉ cho git command)
2. Không cho user pass argument vào shell substitution
3. Quote variables cẩn thận

Ví dụ an toàn:

allowed-tools: Bash(git status), Bash(git log *)

Ví dụ nguy hiểm:

allowed-tools: Bash(*)

Q6: Command tôi tạo không hoạt động, fix sao?

Checklist:

1. File path đúng: .claude/skills/<name>/SKILL.md hoặc .claude/commands/<name>.md
2. name trong frontmatter khớp với tên command muốn gọi
3. Restart Claude Code session (skill chỉ load khi start)
4. Chạy /help xem command có trong danh sách không
5. Kiểm tra YAML frontmatter syntax (đặc biệt indentation)

Q7: Cài command từ repo bên thứ ba có an toàn không?

Cẩn thận. Trước khi cp command từ source bên ngoài:

1. Đọc nội dung file .md (đặc biệt phần ! shell commands và allowed-tools)
2. Kiểm tra disable-model-invocation để biết Claude có tự chạy không
3. Test trong project sandbox/test trước khi dùng project quan trọng
4. Để ý các pattern lén như Bash(curl *), Bash(rm *)

9. Kết luận

Slash commands là một trong những tính năng mạnh nhất của Claude Code, giúp bạn:

• Tiết kiệm thời gian — không phải gõ lại prompt dài cho task lặp lại
• Đảm bảo consistency — team cùng dùng một workflow chuẩn
• Tự động hóa — kết hợp với hooks và MCP servers cho pipeline phức tạp
• Mở rộng được — từ command đơn giản đến skills có scripts, templates kèm theo

Khuyến nghị bắt đầu với 2-3 command đơn giản phục vụ workflow hàng ngày của bạn (ví dụ /commit, /new-post, /seo-check), rồi dần dần mở rộng khi nhận ra pattern lặp lại trong công việc.

Hãy bắt đầu bằng cách gõ /help trong Claude Code để khám phá các built-in commands có sẵn, sau đó tạo skill đầu tiên của riêng bạn!