smartgift-claude-skills/README.md

Smartgift Skills

Marketplace nội bộ chứa các skill Claude Code của Smartgift. Đăng ký marketplace một lần, rồi cài plugin theo vai trò.

Plugin

Plugin	Dành cho	Skill	Nội dung
sg-all	Mặc định — ai muốn tất cả	sg-md-writing + sg-prompt-sharpening	Gói cả hai skill. Cài một cái là có tất cả.
sg-dev	Team dev	sg-md-writing	Soạn & bảo trì tri thức dự án cho AI: CLAUDE.md / AGENTS.md / .claude/rules, skill, subagent. Ghi đúng điều code không tự nói được (ý định, bất biến, bản đồ tái sử dụng), đặt ở chỗ chỉ nạp khi cần để tiết kiệm token; khi code đổi thì tự sửa đúng dòng .md bị sai trong cùng thay đổi, chỉ hỏi ý định mà code không trả lời được.
sg-common	Chung	sg-prompt-sharpening	Yêu cầu gõ ngắn, thiếu thông tin → tự lấp chỗ thiếu từ dự án, hiện bản prompt đã làm rõ (mục tiêu, ở đâu, xong khi nào, giả định) rồi làm luôn; chỉ hỏi một câu khi các cách hiểu dẫn tới việc khác nhau.
agenthub	Ai muốn theo dõi session Claude Code	hooks + server + CLI	Dashboard local-first AgentHub. Source lấy trực tiếp từ repo đó (nhánh main), không phải code trong repo này.

Khuyến nghị: cài sg-all. Đã cài sg-all thì KHÔNG cần cài thêm sg-dev hay sg-common — cài trùng sẽ nạp lặp skill. Chỉ cài sg-dev/sg-common riêng nếu có lý do muốn giới hạn phạm vi. agenthub là plugin độc lập (không phải skill), cài kèm sg-all/sg-dev/sg-common không xung đột.

Cài đặt

# 1. Đăng ký marketplace (một lần) — cần đăng nhập gitea Smartgift
claude plugin marketplace add https://git.smartgift.io.vn/Smartgift-AI/smartgift-claude-skills.git

# 2. Nếu đã cài all thì không cần cài các plugin bên dưới
claude plugin install sg-all@sg

Nếu chỉ muốn cài một trong số các plugin thì hãy cài bằng lệnh dưới đây (nếu đã cài sg-all thì không cần cài bên dưới nữa):

claude plugin install sg-dev@sg        # chỉ sg-md-writing
claude plugin install sg-common@sg     # chỉ sg-prompt-sharpening

Xem: claude plugin list. Gỡ: claude plugin uninstall sg-all@sg (hoặc sg-dev@sg / sg-common@sg / agenthub@sg tùy plugin đã cài).

Dashboard AgentHub

claude plugin install agenthub@sg

Yêu cầu trên máy cài:

Cần	Vì sao
Node >= 22.5	Server dùng node:sqlite, bản cài qua plugin không có better-sqlite3 native
git	Mọi thao tác lane (worktree, đọc branch/status)
tmux	Chỉ cần nếu muốn chạy Claude Code/Codex ngay trong trình duyệt hoặc dùng agenthub lanes shell — dashboard gọi thẳng binary tmux, không có bản dự phòng. Thiếu nó thì phần theo dõi session vẫn chạy bình thường, chỉ nút Start Run là lỗi

sudo apt install git tmux        # Ubuntu / Debian
brew install git tmux            # macOS

Windows không có tmux native — chạy AgentHub trong WSL2 và cài tmux ở trong đó. Cài xong chạy /agenthub-doctor để kiểm tra: dòng tmux sẽ báo WARN nếu thiếu.

Chi tiết bootstrap, các lệnh /agenthub-doctor /agenthub-update /agenthub-open, và cách gỡ sạch: xem docs/PLUGINS.md của AgentHub.

Important

Chỉ cài AgentHub từ MỘT marketplace. Repo AgentHub cũng tự phát hành marketplace riêng của nó. Cài dashboard từ cả hai nơi sẽ chạy hai bộ hook ingestion song song — mỗi event vào database hai lần, token và cost bị đếm đôi. Chọn một đường.

sg chỉ có bản dashboard đầy đủ (entry agenthub ở trên). 10 plugin con (agenthub-analytics, agenthub-sessions, agenthub-workflows, …) chỉ có ở marketplace riêng của AgentHub — cần thì add marketplace đó thay vì cài ở đây.

Plugin này trước đây ở sg dưới tên ccam, trỏ vào repo cũ Claude-Code-Monitor. Entry đã đổi tên thành agenthub cho khớp plugin.json của nó, và URL trỏ thẳng vào tên repo mới (không còn dựa vào redirect của Gitea).

Nếu đang cài bản cũ: lần claude plugin marketplace update sg tới, ccam@sg sẽ chuyển sang ✘ failed to load trong claude plugin list (đúng như dự kiến — entry tên ccam không còn tồn tại), và dashboard ngừng nhận event cho tới khi bạn chuyển sang tên mới:

claude plugin uninstall ccam@sg
claude plugin marketplace update sg
claude plugin install agenthub@sg