# 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ì file `CLAUDE.md` / `AGENTS.md` ràng buộc hành vi AI: routing map, reuse inventory, an toàn với model yếu, tự đề xuất cập nhật khi code đổi (hỏi confirm trước khi ghi). |
| `sg-common` | Chung | `sg-prompt-sharpening` | Trước khi hành động với yêu cầu ngắn/mơ hồ, mở rộng thành các cách hiểu rõ ràng, nêu giả định, định nghĩa tiêu chí "xong". |

**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.

## Cài đặt

```bash
# 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):

```bash
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` tùy plugin đã cài).

## Dashboard AgentHub — marketplace riêng

Marketplace này chỉ chứa skill. Dashboard AgentHub tự phát hành marketplace của
nó, cài trực tiếp từ đó:

```bash
claude plugin marketplace add https://git.smartgift.io.vn/Smartgift-AI/AgentHub.git
claude plugin install agenthub@agenthub
```

Cần Node **>= 22.5** trên máy cài (server dùng `node:sqlite`, không có
`better-sqlite3` native). 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](https://git.smartgift.io.vn/Smartgift-AI/AgentHub/src/branch/main/docs/PLUGINS.md).

> Plugin này trước đây phát hành kèm ở marketplace `sg` dưới tên `ccam`. Entry đó
> đã bị bỏ để AgentHub chỉ có một nguồn cài duy nhất — hai đường cài cùng một
> plugin nghĩa là cài trùng sẽ chạy hai bộ hook ingestion song song.
>
> **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 nguồn không còn tồn tại), và **dashboard ngừng nhận event** cho tới khi bạn
> chuyển sang marketplace mới:
>
> ```bash
> claude plugin uninstall ccam@sg
> claude plugin marketplace add https://git.smartgift.io.vn/Smartgift-AI/AgentHub.git
> claude plugin install agenthub@agenthub
> ```