showme-studio 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "showme-studio",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Cai bo agent Showme Studio vao ~/.claude/skills/",
   "type": "module",
   "bin": {
@@ -11,7 +11,8 @@
     "skills"
   ],
   "scripts": {
-    "sync": "node scripts/sync-skills.js"
+    "sync": "node scripts/sync-skills.js",
+    "prepublishOnly": "node scripts/sync-skills.js"
   },
   "license": "UNLICENSED"
 }

package/skills/agent-blog/SKILL.md

@@ -44,7 +44,7 @@ bài học, sai lầm, góc nhìn khác biệt và điều người đọc có t
 
 Nếu chưa có chất liệu sẵn, chạy subcommand `topic` — dùng Big 5 để tìm chủ đề đang có sức kéo thật (xem mục riêng bên dưới).
 
-Nếu bài này đã có sẵn thư mục trong `noi-dung/1-ideas/{slug}/` (xem quy ước ở `agents/README.md` mục "Cấu trúc thư mục nội dung — quản lý kiểu Kanban"), dùng lại đúng thư mục đó. Nếu chưa có, tạo mới trong `1-ideas/`.
+Nếu bài này đã có sẵn thư mục trong `noi-dung/1-ideas/{slug}/` (xem quy ước ở mục "Quy ước thư mục Kanban" trong file này), dùng lại đúng thư mục đó. Nếu chưa có, tạo mới trong `1-ideas/`.
 
 ### Bước 2 — Làm rõ người đọc
 
@@ -118,7 +118,7 @@ Hãy biên tập theo 4 vòng:
 4. Đề xuất phiên bản chỉnh sửa nhưng vẫn giữ giọng gần gũi, rõ ràng, không quảng cáo.
 ```
 
-Sau khi chốt bản cuối, lưu vào `blog.md` — cùng thư mục với bài Facebook đi kèm (`agent-fbpost`) và ảnh (`agent-image`) nếu bài này có, rồi di chuyển cả thư mục bài viết từ `2-drafting/` sang `noi-dung/3-review/{slug}/`. Xem quy ước ở `agents/README.md` mục "Cấu trúc thư mục nội dung — quản lý kiểu Kanban".
+Sau khi chốt bản cuối, lưu vào `blog.md` — cùng thư mục với bài Facebook đi kèm (`agent-fbpost`) và ảnh (`agent-image`) nếu bài này có, rồi di chuyển cả thư mục bài viết từ `2-drafting/` sang `noi-dung/3-review/{slug}/`. Xem quy ước ở mục "Quy ước thư mục Kanban" trong file này.
 
 ---
 
@@ -141,8 +141,16 @@ Với mỗi nhóm, gợi ý 2-3 chủ đề bài viết cụ thể.
 
 Nguyên tắc: đây là những câu hỏi khách hàng thật đang né tránh trả lời công khai — trả lời thẳng, minh bạch sẽ kéo đúng người đọc có nhu cầu thật.
 
+Nếu đã có `_context/performance-log.md` (do `agent-feedback` ghi), đọc trước để ưu tiên chủ đề/dạng bài đang chạy tốt thật, thay vì chỉ đoán theo Big 5.
+
 ---
 
+## Lỗi AI cần tránh (đọc CLAUDE.md trước khi viết)
+
+Trước khi viết và ở vòng biên tập (Bước 5), đọc mục **"Lỗi AI cần tránh"** trong `CLAUDE.md` cá nhân và rà bản nháp theo đúng danh sách đó. Mặc định danh sách gồm: không dùng dấu phẩy trước "và" (", và"), không chen gạch ngang "-" giữa câu, không dùng gạch ngang dài (—), không dùng khuôn "không phải X, mà là Y", không viết hoa sau dấu hai chấm.
+
+**Học lỗi mới:** nếu ở Bước 5 user tự sửa một khuôn AI mà danh sách chưa có (hoặc phản hồi "câu này nghe vẫn giống AI"), hỏi user có muốn thêm lỗi đó vào mục "Lỗi AI cần tránh" trong `CLAUDE.md` không. Nếu đồng ý, thêm 1 dòng mô tả ngắn gọn lỗi đó — để bài sau không mắc lại. Không tự ghi khi chưa hỏi.
+
 ## Nguyên tắc giữ chất riêng
 
 - Luôn đưa trải nghiệm thật vào trước khi nhờ AI viết
@@ -150,8 +158,7 @@ Nguyên tắc: đây là những câu hỏi khách hàng thật đang né tránh
 - Ưu tiên câu ngắn, ý rõ, ví dụ cụ thể
 - Xóa các câu quá bóng bẩy nhưng không có thông tin
 - Giữ lại những quan sát riêng, kể cả khi chưa hoàn hảo
-- Không viết hoa sau dấu hai chấm, không dùng gạch ngang dài (—)
-- Nếu đề cập công cụ/dịch vụ, ghi rõ giá — minh bạch chi phí
+- Nếu đề cập công cụ/dịch vụ, ghi rõ giá, minh bạch chi phí
 
 ## Dấu hiệu bài viết bị AI hóa
 
@@ -161,6 +168,26 @@ Nguyên tắc: đây là những câu hỏi khách hàng thật đang né tránh
 - Không có quan điểm hoặc lựa chọn rõ
 - Đọc xong không thấy người viết đã thật sự trải qua điều đó
 
+## Ví dụ before/after
+
+Mở bài, chủ đề "vì sao chuyên gia nên có website riêng".
+
+**Trước (giọng AI):**
+> Trong thời đại số hiện nay, xây dựng thương hiệu cá nhân không chỉ quan trọng mà còn là yếu tố sống còn. Một website chuyên nghiệp sẽ giúp bạn khẳng định vị thế, và tạo dựng niềm tin với khách hàng.
+
+**Sau (giọng thật):**
+> Tôi từng nghĩ có Facebook là đủ. Đến khi một khách hỏi "anh có web không để em xem kỹ hơn", tôi mới thấy mình thiếu một chỗ để người ta đọc nghiêm túc về mình.
+>
+> Website không làm bạn nổi tiếng hơn. Nó cho người đang cân nhắc một lý do để tin.
+
+Đã sửa gì: bỏ "trong thời đại số hiện nay", bỏ khuôn "không chỉ... mà còn...", bỏ dấu phẩy trước "và", thay câu chung chung bằng một tình huống thật và một quan điểm rõ.
+
+## Quy ước thư mục Kanban
+
+Mỗi bài viết (blog + fbpost + `images/`) là 1 thư mục `{slug}/` nằm trong 1 trong 5 stage của `noi-dung/`: `1-ideas → 2-drafting → 3-review → 4-approved → 5-published`. Chuyển stage = di chuyển cả thư mục sang stage kế, không cần thêm field trạng thái. `{slug}` viết thường, không dấu, nối bằng `-` (ví dụ `cach-dat-tieu-de-thu-hut`). Bài đơn giản chỉ 1 file để thẳng `.md` trong thư mục stage, không bắt buộc gói thư mục.
+
+Hai file context dùng chung, đặt ngoài các stage: `_context/published-index.md` (mục lục bài đã đăng — `agent-platform` ghi, `agent-seo` đọc để internal link) và `_platforms/{nền tảng}.json` (cấu hình nền tảng, không chứa token thật).
+
 ## Files
 
 ```

package/skills/agent-check/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: agent-check
+description: "Kiểm tra sức khoẻ hệ thống content và context dự án trong thư mục làm việc: cấu trúc thư mục noi-dung/ đúng quy ước chưa, context dự án (CLAUDE.md + file mô tả sản phẩm/giá/ICP) có đầy đủ, nhất quán, còn cập nhật không, các file liên kết chặt chưa, bài có kẹt/thiếu file không, agent phối hợp có đứt mạch không. Chạy khi muốn soát lại trước khi bàn giao hoặc khi thấy mọi thứ đang ngổn ngang. Không rà chất lượng từng bài (việc đó ở agent-blog/fbpost/seo)."
+argument-hint: "[(empty) chạy full check, hoặc subcommand: structure | context | flow | fix]"
+version: "1.1.0"
+---
+
+# /agent-check — Soát Sức Khoẻ Hệ Thống + Context Dự Án
+
+Bộ agent Showme Studio chỉ chạy mượt khi các mảnh khớp nhau: thư mục `noi-dung/` đúng quy ước Kanban, `CLAUDE.md` đủ mục và có nội dung thật để các agent đọc, `published-index.md` phản ánh đúng bài đã đăng, `_platforms/` có cấu hình nền tảng. Khi làm nhiều bài, part-time, dễ có bài kẹt sai chỗ hoặc context lệch/lỗi thời mà không ai để ý. Agent này rà một lượt và báo cáo, **chỉ đọc, không tự sửa** (trừ subcommand `fix` khi user yêu cầu rõ).
+
+Agent này không viết nội dung, không đăng bài, và không rà chất lượng từng bài (việc đó nằm ở agent-blog bước biên tập, agent-fbpost `check`, agent-seo `onpage`). Nó lo 3 việc: cấu trúc thư mục, context dự án, và mạch phối hợp giữa các agent.
+
+## Routing
+
+| Input | Hành động |
+|---|---|
+| _(empty)_ hoặc `help` | Chạy **Full Check** — cả 3 nhóm bên dưới rồi in báo cáo |
+| `structure` | Chỉ kiểm tra cấu trúc thư mục `noi-dung/` |
+| `context` | Chỉ kiểm tra context dự án — nội dung + liên kết file |
+| `flow` | Chỉ kiểm tra mạch phối hợp giữa các agent theo từng bài |
+| `fix [vấn đề]` | Đề xuất cách sửa 1 vấn đề đã tìm ra, làm sau khi user chọn |
+
+---
+
+## Full Check — chạy tuần tự 3 nhóm
+
+Đầu tiên, quét thư mục làm việc: liệt kê cây thư mục `noi-dung/` (5 stage + `_platforms/` + `_context/`), đọc `CLAUDE.md`, mọi file mô tả context dự án nếu có (ví dụ `CONTEXT/*.md`, file sản phẩm/giá/ICP/giọng văn), `_context/published-index.md`, các file `_platforms/*.json`. Sau đó chấm theo 3 nhóm dưới, mỗi phát hiện gắn mức độ: 🔴 chặn (phải sửa), 🟡 nên sửa, 🟢 ổn.
+
+Quy ước thư mục Kanban dùng để đối chiếu: mỗi bài là 1 thư mục `{slug}/` (blog + fbpost + `images/`) nằm trong 1 trong 5 stage `1-ideas → 2-drafting → 3-review → 4-approved → 5-published`; chuyển stage = di chuyển cả thư mục; `{slug}` viết thường không dấu nối bằng `-`; bài đơn giản để 1 file `.md` lẻ được. Hai file dùng chung: `_context/published-index.md` và `_platforms/{nền tảng}.json` (không chứa token thật).
+
+### Nhóm 1 — Cấu trúc thư mục (`structure`)
+
+Đối chiếu với quy ước Kanban nêu ở trên:
+
+1. Có đủ 5 thư mục stage (`1-ideas`, `2-drafting`, `3-review`, `4-approved`, `5-published`) không? Thiếu thư mục nào báo 🟡
+2. Mỗi bài có phải là 1 thư mục `{slug}/` không, hay có file `.md` lẻ nằm thẳng trong stage? (bài đơn giản để lẻ được, nhưng bài có ảnh/fbpost mà không gói thư mục thì báo 🟡)
+3. `{slug}` có đúng định dạng chữ thường, không dấu, nối bằng `-` không? Slug có dấu/có khoảng trắng báo 🟡
+4. Bài ở `5-published/` có `featured.png` trong `images/` không, có dòng URL bài đã đăng trong `blog.md` không? Thiếu báo 🟡 (dấu hiệu đăng thủ công mà quên cập nhật)
+5. Có thư mục `{slug}/` rỗng hoặc chỉ có `images/` mà không có `blog.md`/`fbpost.md` không? Báo 🔴 (bài mồ côi)
+
+### Nhóm 2 — Context dự án (`context`)
+
+Chia 2 phần: nội dung context có tốt không, và các file có khớp nhau không.
+
+**2A — Nội dung context (đọc sâu, không chỉ đếm file):**
+
+1. `CLAUDE.md` có tồn tại không? Nếu thiếu hẳn, báo 🔴 (mọi agent viết sẽ dùng giọng mặc định, không phải giọng người dùng).
+2. Có đủ các mục agent cần đọc không: "Cách tôi thường nói", "Tone theo loại bài", "Điều tôi không muốn", "Lỗi AI cần tránh", "Style Token ảnh"? Thiếu mục nào báo 🟡 kèm agent bị ảnh hưởng.
+3. Mỗi mục có nội dung thật hay còn để trống/placeholder (`[điền]`, `[Cần cập nhật]`, `[...]`, `[từ Bước ...]`)? Còn placeholder báo 🟡 — context chưa hoàn thiện, agent sẽ đoán bừa.
+4. "Style Token ảnh" có mô tả cụ thể (phong cách, bảng màu, ánh sáng) hay còn chung chung? Chung chung báo 🟡 (ảnh sẽ mỗi lần một kiểu).
+5. Mâu thuẫn nội bộ: "Điều tôi không muốn" có chọi với "Cách tôi thường nói" không; Tone khai báo có ngược với ví dụ giọng không? Có mâu thuẫn báo 🟡, chỉ rõ 2 chỗ chọi nhau.
+6. Nếu có file mô tả sản phẩm/giá/ICP (CONTEXT/*.md hoặc tương tự): đối chiếu giá/tên sản phẩm nêu trong đó với giá/tên xuất hiện ở bài đã đăng trong `5-published/`. Lệch nhau báo 🟡 (dấu hiệu context cũ hoặc bài sai giá). Nếu file context có ghi ngày cập nhật và đã quá cũ so với hoạt động gần đây, nhắc 🟡 soát lại.
+
+**2B — Liên kết file:**
+
+7. `_context/published-index.md` có tồn tại không? Đối chiếu từng dòng với thư mục `5-published/`:
+   - Có bài trong `5-published/` mà thiếu dòng trong index không? Báo 🔴 (agent-seo sẽ không tìm được để internal link).
+   - Có dòng trong index mà không còn thư mục tương ứng không? Báo 🟡 (link gãy).
+8. Mỗi nền tảng đang dùng có file `_platforms/{nền tảng}.json` không? File có lỡ chứa token/password thật không (chỉ được chứa cấu hình)? Có token thật báo 🔴 ngay.
+
+### Nhóm 3 — Mạch phối hợp agent (`flow`)
+
+Rà từng bài xem có đứt mạch bàn giao giữa các agent không:
+
+1. Bài ở `2-drafting/` hoặc `3-review/` mà `blog.md` chỉ có dàn ý, đứng yên lâu → gợi ý chạy tiếp `agent-blog`/`agent-seo` bước biên tập
+2. Bài ở `4-approved/` đã lâu chưa đăng → gợi ý chạy `agent-platform`
+3. Bài có `blog.md` tham chiếu ảnh `![...](images/...)` mà file ảnh không tồn tại trong `images/` → báo 🔴 (đăng lên sẽ vỡ ảnh), gợi ý `agent-image`
+4. Bài SEO có nhắc Pillar/Cluster nhưng `published-index.md` chưa có bài liên quan để internal link → gợi ý bài cần viết trước
+5. Bài ở `5-published/` nhưng `CLAUDE.md` chưa được cập nhật từ bài đó → gợi ý chạy `agent-onboarding update [slug]` để học văn phong
+6. Bài đã đăng lâu nhưng chưa có dòng trong `_context/performance-log.md` → gợi ý chạy `agent-feedback log [slug]` để ghi kết quả thật
+
+### Báo cáo cuối
+
+In gọn theo format:
+
+```text
+KIỂM TRA HỆ THỐNG CONTENT — [ngày]
+
+🔴 Cần sửa ngay (n):
+- [vấn đề] → [agent/cách xử lý gợi ý]
+
+🟡 Nên sửa (n):
+- [vấn đề] → [gợi ý]
+
+🟢 Ổn:
+- [các mục đã đạt]
+
+Gợi ý bước tiếp theo: [1-2 việc ưu tiên nhất]
+```
+
+Không tự sửa gì ở bước này. Nếu user muốn xử lý 1 vấn đề, chạy `fix`.
+
+---
+
+## Subcommand: `fix [vấn đề]` — Đề xuất và thực hiện sửa
+
+Chỉ chạy sau khi user chọn vấn đề cụ thể từ báo cáo. Với mỗi vấn đề:
+
+1. Nói rõ sẽ làm gì (di chuyển thư mục, thêm dòng vào index, tạo mục thiếu trong CLAUDE.md...) và hệ quả
+2. Chờ user xác nhận
+3. Thực hiện, rồi báo lại kết quả
+
+Không tự đăng bài, không tự publish, không tự ghi token. Việc chuyển stage `3-review → 4-approved` luôn để user tự quyết (đó là bước người đọc lại và duyệt), agent-check không tự duyệt thay.
+
+---
+
+## Nguyên tắc
+
+- Mặc định chỉ đọc và báo cáo — không sửa khi chưa được yêu cầu rõ
+- Báo cáo phải chỉ đúng file/thư mục cụ thể, không nói chung chung ("có vài bài chưa ổn" là vô dụng)
+- Ưu tiên phát hiện làm gãy luồng thật (ảnh thiếu, index lệch, token lộ) hơn là bắt lỗi hình thức nhỏ
+- Gợi ý bước tiếp theo luôn gắn với đúng agent phụ trách, để user biết gõ gì tiếp
+- Tôn trọng ngoại lệ trong `CLAUDE.md` của dự án: nếu dự án có quy ước riêng (ví dụ đặt file lẻ thay vì gói thư mục), đọc quy ước đó trước khi báo lỗi
+
+## Files
+
+```
+agent-check/
+└── SKILL.md   — router + full check (3 nhóm) + fix (file này)
+```

package/skills/agent-fbpost/SKILL.md

@@ -90,30 +90,59 @@ Hãy kiểm tra từng rule sau và chỉ rõ câu nào vi phạm:
    được có CTA)
 4. Tên nền tảng/công cụ có viết đủ nghĩa không (ví dụ "website dùng Wix"
    thay vì chỉ "Wix")?
-5. Danh sách có dùng gạch ngang dài (—) không? Nếu có, đổi thành dấu
-   hai chấm hoặc xuống dòng
-6. Có ai cần được cảm ơn/tag theo tên thật không mà đang thiếu?
-7. Thông tin phụ thuộc bên thứ ba có disclaimer "có thể thay đổi" chưa?
-8. Có header thừa cho phần chỉ 1-2 bullet không? (bỏ nếu thừa)
-9. Bài kết bằng CTA ép hay bằng "big picture" đúng loại bài?
-
-Chỉ sửa những câu vi phạm, giữ nguyên phần đã ổn.
+5. Danh sách có dùng gạch ngang dài (—) hoặc chen gạch ngang "-"
+   giữa câu không? Nếu có, đổi thành dấu phẩy, dấu hai chấm hoặc xuống dòng
+6. Có dùng dấu phẩy trước "và" (", và") không? Bỏ dấu phẩy hoặc tách câu
+7. Có dùng khuôn "không phải X, mà là Y" không? Viết lại cho tự nhiên
+8. Có ai cần được cảm ơn/tag theo tên thật không mà đang thiếu?
+9. Thông tin phụ thuộc bên thứ ba có disclaimer "có thể thay đổi" chưa?
+10. Có header thừa cho phần chỉ 1-2 bullet không? (bỏ nếu thừa)
+11. Bài kết bằng CTA ép hay bằng "big picture" đúng loại bài?
+
+Đối chiếu thêm với mục "Lỗi AI cần tránh" trong CLAUDE.md — nếu có lỗi
+nào đã ghi ở đó mà bản nháp còn mắc, sửa luôn. Chỉ sửa những câu vi
+phạm, giữ nguyên phần đã ổn.
 ```
 
-Sau khi chốt bản cuối, lưu vào `fbpost.md` trong thư mục bài viết hiện tại. Nếu bài Facebook này đi kèm 1 bài blog, dùng chung thư mục `{slug}/` với `blog.md` — thư mục này đang nằm ở stage nào trong `noi-dung/1-ideas → 2-drafting → 3-review → 4-approved → 5-published` thì `fbpost.md` cũng di chuyển theo cùng lúc với cả thư mục (do `agent-blog`/`agent-seo` xử lý). Xem quy ước ở `agents/README.md` mục "Cấu trúc thư mục nội dung — quản lý kiểu Kanban".
+Nếu user tự sửa một khuôn AI mà checklist và `CLAUDE.md` chưa có, hỏi có muốn thêm vào mục "Lỗi AI cần tránh" trong `CLAUDE.md` không — đồng ý thì thêm 1 dòng, không tự ghi khi chưa hỏi.
+
+Sau khi chốt bản cuối, lưu vào `fbpost.md` trong thư mục bài viết hiện tại. Nếu bài Facebook này đi kèm 1 bài blog, dùng chung thư mục `{slug}/` với `blog.md` — thư mục này đang nằm ở stage nào trong `noi-dung/1-ideas → 2-drafting → 3-review → 4-approved → 5-published` thì `fbpost.md` cũng di chuyển theo cùng lúc với cả thư mục (do `agent-blog`/`agent-seo` xử lý). Xem quy ước ở mục "Quy ước thư mục Kanban" trong file này.
 
 ---
 
 ## Nguyên tắc
 
 - Không viết hoa sau dấu hai chấm
-- Không dùng gạch ngang dài (—), thay bằng dấu phẩy, xuống dòng, hoặc viết lại câu
+- Không dùng gạch ngang dài (—) hoặc chen gạch ngang "-" giữa câu, thay bằng dấu phẩy, xuống dòng, hoặc viết lại câu
+- Không dùng dấu phẩy trước "và" (", và"), không dùng khuôn "không phải X, mà là Y"
 - Không xuống dòng ngẫu nhiên, chỉ xuống dòng khi chuyển ý thật sự
 - Không hook marketing ở đầu bài
 - Không CTA ở cuối bài, trừ bài launch (thông tin đầy đủ, cần hành động cụ thể)
 - Minh bạch chi phí — nếu đề cập công cụ/dịch vụ, ghi rõ giá
 - Giữ nhịp câu ngắn, có thể để một dòng hơi gãy nếu đó là cách nói tự nhiên — không biên tập quá sạch đến mất chất cá nhân
 
+## Ví dụ before/after
+
+Bài buildinpublic, khoe vừa giúp một khách sửa website.
+
+**Trước (hook giả + CTA ép):**
+> 🔥 BẠN CÓ BIẾT? 90% chuyên gia đang bỏ lỡ cơ hội vàng vì chưa có website riêng! Đừng để mình tụt lại phía sau. Inbox ngay để được tư vấn miễn phí!
+
+**Sau (giọng thật):**
+> Tuần trước một chị coach nhắn: "website của chị lỗi rồi, khách vào không đọc được".
+>
+> Chị loay hoay 3 ngày không sửa nổi. Mình gỡ trong 20 phút, phần lớn thời gian là ngồi chỉ chị cách tự đổi sau này để lần sau không phải hỏi ai.
+>
+> Làm web không khó. Không có ai chỉ đường mới khó.
+
+Đã sửa gì: bỏ emoji giật, bỏ số liệu bịa "90%", bỏ CTA "inbox ngay", mở bằng một chuyện thật, kết bằng một câu quan điểm thay vì lời mời mua.
+
+## Quy ước thư mục Kanban
+
+Mỗi bài viết (blog + fbpost + `images/`) là 1 thư mục `{slug}/` nằm trong 1 trong 5 stage của `noi-dung/`: `1-ideas → 2-drafting → 3-review → 4-approved → 5-published`. Chuyển stage = di chuyển cả thư mục sang stage kế, không cần thêm field trạng thái. `{slug}` viết thường, không dấu, nối bằng `-` (ví dụ `cach-dat-tieu-de-thu-hut`). Bài đơn giản chỉ 1 file để thẳng `.md` trong thư mục stage, không bắt buộc gói thư mục.
+
+Hai file context dùng chung, đặt ngoài các stage: `_context/published-index.md` (mục lục bài đã đăng — `agent-platform` ghi, `agent-seo` đọc để internal link) và `_platforms/{nền tảng}.json` (cấu hình nền tảng, không chứa token thật).
+
 ## Files
 
 ```

package/skills/agent-feedback/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: agent-feedback
+description: "Ghi lại kết quả thật của bài đã đăng (reach, tương tác, inbox, đơn) rồi phân tích bài nào chạy tốt để gợi ý hướng viết tiếp. Nhập số liệu bằng tay nên chạy được cả trên Claude Code lẫn Codex, không cần kết nối API nền tảng."
+argument-hint: "[log [slug] để ghi số liệu, review để phân tích, hoặc (empty) xem hướng dẫn]"
+version: "1.0.0"
+---
+
+# /agent-feedback — Học Từ Kết Quả Thật
+
+Bộ agent sản xuất nội dung, nhưng nếu không nhìn lại bài nào thật sự chạy, bạn viết mãi mà không biết đang đi đúng hướng không. Agent này đóng vòng lặp: bạn nhập số liệu thật của bài đã đăng, nó lưu lại và chỉ ra mẫu số chung của bài hiệu quả, để agent viết sau ưu tiên đúng hướng.
+
+Nhập số liệu bằng tay (bạn tự đọc trên Facebook/web rồi gõ vào) — không kết nối API nền tảng, nên chạy y hệt trên Claude Code hay Codex.
+
+## Routing
+
+| Input | Hành động |
+|---|---|
+| _(empty)_ hoặc `help` | In hướng dẫn + ví dụ |
+| `log [slug]` | Ghi số liệu 1 bài đã đăng vào `_context/performance-log.md` |
+| `review` | Phân tích toàn bộ log, chỉ ra bài/chủ đề/dạng nào chạy tốt |
+
+---
+
+## `log [slug]` — Ghi số liệu một bài
+
+Hỏi các số bạn có (bỏ trống được, không ép đủ hết):
+
+```text
+Bài: [slug]
+Kênh: web / Facebook / cả hai
+- Reach/lượt xem:
+- Like/reaction:
+- Comment:
+- Share:
+- Inbox/tin nhắn về bài này:
+- Đơn/đăng ký đến từ bài này (nếu lần được):
+- Ghi chú: (đăng giờ nào, có chạy ads không, điều gì bất thường)
+```
+
+Ghi 1 dòng vào `_context/performance-log.md` (tạo file với header bảng nếu chưa có):
+
+```markdown
+| Ngày | Slug | Kênh | Reach | Like | Comment | Share | Inbox | Đơn | Ghi chú |
+|---|---|---|---|---|---|---|---|---|---|
+```
+
+Đối chiếu slug với `_context/published-index.md` để lấy đúng chủ đề/category/tags của bài — không bắt nhập lại.
+
+## `review` — Phân tích để biết viết gì tiếp
+
+Đọc `performance-log.md` ghép với `published-index.md`, rồi trả lời gọn:
+
+```text
+1. 3 bài chạy tốt nhất (theo inbox/đơn trước, reach sau) — điểm chung gì?
+   (chủ đề, dạng bài, kiểu tiêu đề, giờ đăng)
+2. 3 bài yếu nhất — điểm chung gì?
+3. Chủ đề/dạng bài nên viết thêm, chủ đề nên dừng.
+4. 1-2 giả thuyết đáng thử ở bài sau (ví dụ: tiêu đề dạng câu hỏi kéo
+   inbox tốt hơn dạng how-to).
+```
+
+Nguyên tắc phân tích: ưu tiên chỉ số gần tiền nhất (inbox, đơn) hơn chỉ số phù phiếm (reach, like). Chỉ kết luận khi có ít nhất 3-4 bài để so — dưới đó chỉ là quan sát, nói rõ là chưa đủ dữ liệu.
+
+Kết quả `review` là chất liệu cho `agent-blog topic` và `agent-seo` chọn chủ đề: khi được hỏi viết gì tiếp, đọc `performance-log.md` để ưu tiên hướng đang hiệu quả thật thay vì đoán.
+
+---
+
+## Nguyên tắc
+
+- Chỉ nhập số thật, không bịa cho đủ bảng — bỏ trống ô nào không có
+- Đo cái gần tiền nhất trước (inbox/đơn), reach/like chỉ để tham khảo
+- Không kết luận vội khi mẫu còn ít, nói rõ khi dữ liệu chưa đủ
+- Log là để quyết định viết gì tiếp, không phải để chấm điểm bản thân — giữ nhẹ nhàng
+
+## Files
+
+```
+agent-feedback/
+└── SKILL.md   — router + log + review (file này)
+```

package/skills/agent-image/SKILL.md

@@ -1,25 +1,34 @@
 ---
 name: agent-image
-description: "Tạo ảnh minh hoạ, ảnh quote, ảnh banner bằng AI, giữ phong cách nhất quán qua mọi bài viết bằng Style Token cố định. Dùng OpenAI Images API (gpt-image-1/dall-e-3)."
-argument-hint: "[loại ảnh cần tạo: quote | banner | minh-hoa, hoặc subcommand: setup-style]"
-version: "1.0.0"
+description: "Tạo prompt ảnh AI nhất quán theo Style Token cho mọi dạng ảnh nội dung: ảnh đơn Facebook, album 3-4 ảnh, carousel, thumbnail website, ảnh quote, minh hoạ trong bài. Kèm tìm lại ảnh đã tạo để tái dùng và gợi ý ảnh stock. Agent sinh prompt hoàn chỉnh để dán vào tool tạo ảnh bất kỳ (ChatGPT, Gemini, Canva AI...), không cần API key."
+argument-hint: "[dạng ảnh: fb1 | album | carousel | thumb | quote | minh-hoa, hoặc subcommand: setup-style | tim | stock]"
+version: "2.0.0"
 ---
 
-# /agent-image — Tạo Ảnh AI Giữ Đúng Phong Cách Thương Hiệu
+# /agent-image — Ảnh Nhất Quán Cho Mọi Dạng Nội Dung
 
 Vấn đề phổ biến khi tự tạo ảnh bằng AI: mỗi ảnh một phong cách, không ai nhận ra đây là cùng một thương hiệu. Agent này giải quyết bằng **Style Token** — một đoạn mô tả phong cách cố định, dùng lặp lại y hệt trong mọi prompt, thay vì mô tả lại từ đầu mỗi lần (kỹ thuật đang là chuẩn phổ biến để giữ nhất quán ảnh AI theo thương hiệu/nhân vật).
 
 Nguyên tắc quan trọng nhất: **dùng đúng từ ngữ, không đổi từ đồng nghĩa.** Nếu Style Token ghi "áo blazer be", lần sau vẫn phải ghi "áo blazer be", không đổi thành "áo khoác be" hay "áo vest be" — AI coi các từ đồng nghĩa là khái niệm khác nhau, đổi từ là mất nhất quán.
 
+**Cách agent hoạt động:** agent không tự gọi API tạo ảnh. Agent sinh ra **prompt hoàn chỉnh** (Style Token + mô tả nội dung + tỷ lệ khung + vùng chữ an toàn) — bạn dán prompt đó vào tool tạo ảnh đang dùng (ChatGPT, Gemini, Canva AI, Midjourney...), rồi lưu ảnh về đúng thư mục theo quy ước đặt tên bên dưới. Không cần API key, không phụ thuộc 1 tool cụ thể.
+
 ## Routing
 
 | Input | Hành động |
 |---|---|
 | _(empty)_ hoặc `help` | In hướng dẫn + ví dụ |
 | `setup-style` | Chạy trước tiên — xây Style Token cố định cho thương hiệu |
-| `quote [nội dung câu quote]` | Tạo ảnh quote card |
-| `banner [chủ đề bài viết]` | Tạo ảnh đại diện (featured image) cho blog/bài viết |
-| `minh-hoa [mô tả cảnh]` | Tạo ảnh minh hoạ trong bài |
+| `fb1 [nội dung post]` | 1 ảnh đơn cho post Facebook |
+| `album [nội dung post + số ảnh]` | Bộ 3-4 ảnh cho post Facebook nhiều ảnh |
+| `carousel [nội dung]` | Bộ ảnh carousel lật trang (5-10 trang) |
+| `thumb [chủ đề bài viết]` | Thumbnail/ảnh đại diện cho bài website |
+| `quote [câu quote]` | Ảnh quote card |
+| `minh-hoa [mô tả cảnh]` | Ảnh minh hoạ chèn trong bài |
+| `tim [mô tả ảnh cần]` | Tìm lại ảnh đã tạo trong các bài cũ để tái dùng |
+| `stock [chủ đề]` | Gợi ý từ khoá tìm ảnh stock khi không cần ảnh AI |
+
+Trước khi chạy bất kỳ flow tạo ảnh nào: đọc Style Token trong `CLAUDE.md` cá nhân (mục "Style Token ảnh"). Nếu chưa có, chạy `setup-style` trước. Trước khi tạo mới, cân nhắc chạy `tim` — ảnh phù hợp có thể đã tồn tại trong bài cũ.
 
 ---
 
@@ -42,65 +51,155 @@ y nguyên vào mọi prompt sau này.
 
 Lưu Style Token này vào `CLAUDE.md` cá nhân (mục riêng "Style Token ảnh") để agent tự nhớ, không cần dán lại thủ công mỗi lần.
 
-## Flow: `quote` — Ảnh trích dẫn
+## Cấu trúc prompt chuẩn (áp cho mọi flow bên dưới)
+
+Mỗi prompt agent sinh ra luôn gồm 4 phần, theo đúng thứ tự:
 
 ```text
-Tạo ảnh quote card với nội dung: "[câu quote]"
+[1. Style Token — dán nguyên văn, không diễn giải lại]
+[2. Nội dung ảnh — 1 ý chính, mô tả cụ thể cảnh/đối tượng]
+[3. Tỷ lệ khung — ghi rõ theo dạng ảnh, ví dụ "tỷ lệ 1:1, 1080x1080"]
+[4. Vùng chữ — nếu ảnh có chữ hoặc sẽ đè chữ lên sau: chừa khoảng trống ở đâu]
+```
 
-Style Token: [dán Style Token đã chốt ở bước 0]
+Với bộ nhiều ảnh (album, carousel): sinh **tất cả prompt cùng một lần**, Style Token lặp lại y hệt trong từng prompt, và thêm 1-2 yếu tố lặp cố định xuyên suốt bộ (cùng màu nền, cùng vị trí đặt tiêu đề, cùng nhân vật/đối tượng chính) để người xem nhận ra đây là cùng 1 bộ ảnh.
 
-Yêu cầu: chữ đọc rõ, bố cục để trống khoảng an toàn cho chữ, không
-để chi tiết hình ảnh đè lên vùng chữ.
-```
+---
 
-Gọi API (ví dụ dùng OpenAI Images, model gpt-image-1 hoặc dall-e-3, key đã cấu hình sẵn trong môi trường làm việc):
+## Flow: `fb1` — Ảnh đơn cho post Facebook
 
-```bash
-curl -s https://api.openai.com/v1/images/generations \
-  -H "Authorization: Bearer $OPENAI_API_KEY" \
-  -H "Content-Type: application/json" \
-  -d '{"model":"dall-e-3","prompt":"[prompt đầy đủ gồm Style Token + nội dung quote]","n":1,"size":"1024x1024"}'
-```
+Hỏi nhanh nếu chưa rõ: post này nói về điều gì, có cần chữ trên ảnh không. Sau đó sinh 1 prompt:
+
+- Tỷ lệ: 1:1 (1080x1080) mặc định, hoặc 4:5 (1080x1350) nếu muốn chiếm nhiều màn hình hơn trên feed
+- Đúng 1 ý chính của post — không cố tóm tắt cả bài vào 1 ảnh
+- Nếu ảnh có chữ: chữ ngắn dưới 10 từ, chừa vùng trống rõ ràng cho chữ
+
+Lưu thành `images/fb-1.png` trong thư mục bài viết.
+
+## Flow: `album` — Bộ 3-4 ảnh cho post Facebook nhiều ảnh
+
+Hỏi nhanh: post có mấy ý chính, muốn mấy ảnh (3 hay 4). Mỗi ảnh 1 ý, sinh đủ bộ prompt cùng lúc:
 
-## Flow: `banner` — Ảnh đại diện (featured image) cho bài viết
+- Tỷ lệ: cùng 1 tỷ lệ cho cả bộ — 1:1 cho bộ 4 ảnh (Facebook xếp lưới 2x2 đẹp), 4:5 hoặc 1:1 cho bộ 3 ảnh
+- Ảnh 1 là ảnh "mở" — nêu ý lớn nhất, vì đây là ảnh hiện to nhất trên feed
+- Các ảnh sau mỗi ảnh 1 ý phụ, cùng bố cục với ảnh 1
+- Ghi rõ yếu tố lặp cố định của bộ (màu nền, vị trí tiêu đề...) trong từng prompt
+
+Lưu thành `images/album-1.png`, `album-2.png`... theo đúng thứ tự đăng.
+
+## Flow: `carousel` — Bộ ảnh lật trang
+
+Dùng cho nội dung dạng danh sách/các bước/so sánh, đăng Facebook hoặc làm carousel tái dùng đa kênh. Hỏi nhanh: nội dung chia được thành mấy phần (khuyến nghị 5-10 trang). Sinh đủ bộ prompt cùng lúc:
+
+- Tỷ lệ: 1:1 (1080x1080) cho toàn bộ
+- Trang 1 — hook: nêu đúng vấn đề/lời hứa của cả bộ, chữ to, ít chi tiết (áp nguyên tắc câu mở của `agent-title` subcommand `fbpost`: chuyện thật, không giật tít)
+- Trang giữa — mỗi trang đúng 1 ý, đánh số thứ tự rõ trên ảnh (1/7, 2/7...)
+- Trang cuối — chốt lại + bước tiếp theo nhẹ nhàng, không CTA ép mua (theo đúng rule `agent-fbpost`)
+- Cả bộ dùng chung 1 template bố cục: vị trí số trang, vị trí tiêu đề, màu nền lặp lại y hệt
+
+Lưu thành `images/carousel-1.png` → `carousel-n.png` theo thứ tự trang.
+
+## Flow: `thumb` — Thumbnail/ảnh đại diện bài website
 
 ```text
-Tạo ảnh đại diện cho bài viết chủ đề: [chủ đề]
+Sinh prompt ảnh đại diện cho bài viết chủ đề: [chủ đề]
 
-Style Token: [dán Style Token đã chốt]
+Yêu cầu trong prompt:
+- Tỷ lệ 1200x628 (chuẩn featured image/og:image của hầu hết nền tảng blog)
+- Không nhồi quá nhiều chi tiết, giữ 1 điểm nhấn chính liên quan chủ đề
+- Nếu định đè tiêu đề bài lên ảnh: chừa vùng trống bên trái hoặc giữa
+```
+
+Lưu thành `images/featured.png` trong thư mục bài viết. Đây là ảnh đại diện riêng — `agent-platform` sẽ gán ảnh này vào field ảnh đại diện của nền tảng (featured_media/featured_image/coverImage...) khi đăng, **không chèn ảnh này vào đầu nội dung body**.
 
-Yêu cầu: tỷ lệ 1200x628 (chuẩn featured image/og:image của hầu hết
-nền tảng blog), không nhồi quá nhiều chi tiết, giữ 1 điểm nhấn chính
-liên quan tới chủ đề bài viết.
+## Flow: `quote` — Ảnh trích dẫn
+
+```text
+Sinh prompt ảnh quote card với nội dung: "[câu quote]"
+
+Yêu cầu trong prompt: chữ đọc rõ, bố cục để trống khoảng an toàn cho
+chữ, không để chi tiết hình ảnh đè lên vùng chữ. Tỷ lệ 1:1.
 ```
 
-Lưu thành `images/featured.png` trong thư mục bài viết hiện tại. Đây là ảnh đại diện riêng — `agent-platform` sẽ gán ảnh này vào field ảnh đại diện của nền tảng (featured_media/featured_image/coverImage...) khi đăng, **không chèn ảnh này vào đầu nội dung body**.
+Lưu ý: nhiều tool AI vẽ chữ tiếng Việt bị lỗi dấu. Nếu tool đang dùng vẽ chữ xấu, sinh prompt ảnh nền không chữ (chừa vùng trống), rồi tự đè chữ bằng Canva — prompt ghi rõ "để trống vùng giữa cho chữ".
+
+Lưu thành `images/quote-1.png` (đánh số tiếp nếu bài có nhiều quote).
 
 ## Flow: `minh-hoa` — Ảnh minh hoạ trong bài
 
 ```text
-Tạo ảnh minh hoạ cho đoạn: [mô tả cảnh/ý cần minh hoạ]
+Sinh prompt ảnh minh hoạ cho đoạn: [mô tả cảnh/ý cần minh hoạ]
+
+Yêu cầu trong prompt: đúng 1 ý chính, không cố nhồi nhiều chi tiết
+cùng lúc, giữ đúng bảng màu và phong cách trong Style Token.
+Tỷ lệ 16:9 hoặc 3:2 (nằm ngang, vừa khung nội dung bài viết).
+```
+
+Lưu vào `images/` với tên mô tả rõ vị trí dùng (ví dụ `minh-hoa-buoc-2.png`).
+
+---
+
+## Subcommand: `tim` — Tìm lại ảnh đã tạo
+
+Trước khi tạo ảnh mới, tìm trong kho ảnh của các bài cũ — ảnh phù hợp có thể đã có sẵn, tái dùng vừa nhanh vừa tăng nhất quán:
+
+1. Liệt kê ảnh trong `noi-dung/*/{slug}/images/` của tất cả stage (ưu tiên `5-published/` — ảnh đã dùng thật)
+2. Đối chiếu tên file (đặt theo quy ước mô tả nội dung nên đọc tên là biết ảnh gì) với mô tả ảnh đang cần
+3. Trả về danh sách ảnh khớp kèm đường dẫn + bài đang dùng ảnh đó, để user mở xem và quyết định
+4. Nếu tái dùng: copy ảnh sang `images/` của bài mới, giữ nguyên tên hoặc đổi theo vị trí dùng mới — không tham chiếu chéo sang thư mục bài khác, vì thư mục bài sẽ di chuyển qua các stage
+
+Nếu không có ảnh nào khớp, chuyển sang flow tạo mới phù hợp (hoặc `stock`).
+
+## Subcommand: `stock` — Gợi ý ảnh stock
+
+Dùng khi cần ảnh đời thực (văn phòng, bàn tay gõ phím, quán cà phê...) mà ảnh AI dễ bị giả — ảnh stock thật sẽ tự nhiên hơn:
+
+```text
+Chủ đề/đoạn bài cần ảnh: [mô tả]
 
-Style Token: [dán Style Token đã chốt]
+Hãy gợi ý 3-5 từ khoá tìm kiếm bằng tiếng Anh (stock site tìm tiếng Anh
+tốt hơn hẳn tiếng Việt), kèm link tìm thẳng:
+- Unsplash: https://unsplash.com/s/photos/[tu-khoa]
+- Pexels: https://www.pexels.com/search/[tu khoa]/
 
-Yêu cầu: đúng 1 ý chính, không cố nhồi nhiều chi tiết cùng lúc,
-giữ đúng bảng màu và phong cách trong Style Token.
+Ưu tiên từ khoá cụ thể ("laptop coffee shop morning") hơn từ khoá
+chung chung ("business").
 ```
 
+Lưu ý khi dùng stock: Unsplash/Pexels dùng miễn phí kể cả mục đích thương mại, nhưng vẫn kiểm tra license từng ảnh trước khi dùng. Chọn ảnh có tông màu gần với bảng màu trong Style Token để không lệch khỏi nhận diện chung. Ảnh tải về cũng lưu vào `images/` của bài viết theo đúng quy ước đặt tên.
+
 ---
 
+## Quy ước đặt tên file ảnh
+
+Mọi ảnh (AI tạo, stock, tự chụp) đều lưu vào `images/` trong thư mục bài viết hiện tại (`noi-dung/{stage}/{slug}/images/`) — xem quy ước ở mục "Quy ước thư mục Kanban" trong file này:
+
+| Dạng ảnh | Tên file |
+|---|---|
+| Ảnh đại diện bài website | `featured.png` (bắt buộc đúng tên — `agent-platform` nhận theo tên này) |
+| Ảnh đơn Facebook | `fb-1.png` |
+| Album Facebook | `album-1.png`, `album-2.png`... (theo thứ tự đăng) |
+| Carousel | `carousel-1.png` → `carousel-n.png` (theo thứ tự trang) |
+| Quote card | `quote-1.png`, `quote-2.png`... |
+| Minh hoạ trong bài | tên mô tả vị trí, ví dụ `minh-hoa-buoc-2.png` |
+
 ## Nguyên tắc giữ nhất quán
 
-- Lưu mọi ảnh tạo ra vào `images/` trong thư mục bài viết hiện tại (`noi-dung/{stage}/{slug}/images/`) — ảnh đại diện luôn đặt tên `featured.png` (để `agent-platform` nhận đúng và gán vào field ảnh đại diện thay vì chèn vào body), các ảnh khác đặt tên mô tả rõ vị trí dùng (ví dụ `quote-1.png`). Xem quy ước ở `agents/README.md` mục "Cấu trúc thư mục nội dung — quản lý kiểu Kanban"
 - Luôn dán nguyên văn Style Token vào mọi prompt, không diễn giải lại bằng từ khác mỗi lần
 - Không đổi từ đồng nghĩa khi mô tả cùng một chi tiết (màu, chất liệu, phong cách)
+- Bộ nhiều ảnh (album, carousel) phải sinh toàn bộ prompt trong 1 lần, dùng chung template bố cục — không tạo lắt nhắt từng ảnh vào thời điểm khác nhau
 - Nếu có nhân vật/mascot cố định, giữ 1 ảnh tham chiếu gốc và dùng lại cho mọi ảnh sau — không mô tả lại nhân vật bằng lời mỗi lần
 - Kiểm tra ảnh ra có đúng bảng màu và cảm giác đã chốt ở Style Token không trước khi dùng
 - Nếu 1 prompt không ra đúng phong cách, sửa lại đúng câu chữ trong Style Token thay vì viết prompt hoàn toàn mới
+- Tìm trước, tạo sau — chạy `tim` trước khi tạo ảnh mới cùng chủ đề
+
+## Quy ước thư mục Kanban
+
+Mỗi bài viết (blog + fbpost + `images/`) là 1 thư mục `{slug}/` nằm trong 1 trong 5 stage của `noi-dung/`: `1-ideas → 2-drafting → 3-review → 4-approved → 5-published`. Chuyển stage = di chuyển cả thư mục sang stage kế, không cần thêm field trạng thái. `{slug}` viết thường, không dấu, nối bằng `-`. Bài đơn giản chỉ 1 file để thẳng `.md` trong thư mục stage, không bắt buộc gói thư mục. Ảnh của bài luôn nằm trong `images/` của chính thư mục bài đó.
 
 ## Files
 
 ```
 agent-image/
-└── SKILL.md   — router + setup Style Token + 3 flow tạo ảnh (file này)
+└── SKILL.md   — router + setup Style Token + 6 flow theo dạng ảnh + tim/stock (file này)
 ```

package/skills/agent-onboarding/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: agent-onboarding
-description: "Khai thác context dự án và giọng văn cá nhân qua hội thoại hoặc phân tích bài viết mẫu, rồi tự tổng hợp thành CLAUDE.md hoàn chỉnh. Chạy đầu tiên, trước mọi agent khác trong bộ Showme Studio."
-argument-hint: "[(empty) để bắt đầu hội thoại, hoặc subcommand: samples | interview | summary]"
-version: "1.0.0"
+description: "Khai thác context dự án và giọng văn cá nhân qua hội thoại hoặc phân tích bài viết mẫu, rồi tự tổng hợp thành CLAUDE.md hoàn chỉnh. Chạy đầu tiên, trước mọi agent khác trong bộ Showme Studio. Subcommand update: học lại từ bài đã đăng để văn phong ngày càng giống bạn hơn."
+argument-hint: "[(empty) để bắt đầu hội thoại, hoặc subcommand: samples | interview | summary | update]"
+version: "1.1.0"
 ---
 
 # /agent-onboarding — Dựng CLAUDE.md Từ Context Thật
@@ -19,6 +19,7 @@ Nền tảng: phân biệt **Voice** và **Tone** (Mailchimp Content Style Guide
 | `samples` | Chỉ chạy bước phân tích bài viết mẫu để rút Voice Profile |
 | `interview` | Chỉ chạy bước phỏng vấn khi chưa có bài viết mẫu nào |
 | `summary` | Tổng hợp câu trả lời đã có (từ các bước trước) thành CLAUDE.md hoàn chỉnh |
+| `update [slug]` | Học lại từ bài đã đăng — cập nhật Voice Profile và "Lỗi AI cần tránh" trong CLAUDE.md |
 
 ---
 
@@ -121,6 +122,17 @@ CLAUDE.md hoàn chỉnh theo đúng format:
 ## Điều tôi không muốn
 [từ Bước 2]
 
+## Lỗi AI cần tránh
+[Danh sách lỗi AI viết hay mắc — cập nhật dần mỗi khi bạn sửa bài.
+Khởi điểm mặc định:]
+- không dùng dấu phẩy trước "và" (viết ", và" là khuôn tiếng Anh,
+  tiếng Việt bỏ dấu phẩy hoặc tách câu)
+- không chen gạch ngang "-" giữa câu trong nội dung, thay bằng dấu
+  phẩy, dấu hai chấm, hoặc viết lại câu
+- không dùng gạch ngang dài (—)
+- không dùng khuôn "không phải X, mà là Y"
+- không viết hoa sau dấu hai chấm
+
 ## Bối cảnh đang làm
 [từ Bước 1]
 ```
@@ -129,6 +141,31 @@ Lưu file này vào thư mục làm việc, tên `CLAUDE.md`. Từ phiên sau, m
 
 ---
 
+## Subcommand: `update` — Học lại từ bài đã đăng
+
+CLAUDE.md không phải file viết 1 lần rồi để đó — mỗi bài đã chốt và đăng thật là chất liệu mới để văn phong chính xác hơn. `agent-platform` gợi ý chạy bước này ngay sau mỗi lần đăng thành công, hoặc tự chạy bất cứ lúc nào:
+
+```text
+Đọc bài đã chốt tại noi-dung/5-published/[slug]/blog.md (bản đã qua
+tay tôi biên tập thật, không phải bản nháp AI).
+
+So sánh với CLAUDE.md hiện tại và trả lời:
+
+1. Cách viết trong bài này có điểm gì chưa được ghi trong Voice
+   Profile — cách mở bài, nhịp câu, từ hay dùng, cách đưa ví dụ,
+   cách kết bài?
+2. Nhìn lịch sử biên tập (những gì tôi đã sửa so với khuôn AI thường
+   viết): có lỗi/khuôn nào lặp lại cần thêm vào mục "Lỗi AI cần tránh"?
+3. Đề xuất bản cập nhật cho 2 mục "Cách tôi thường nói" và "Lỗi AI
+   cần tránh".
+
+Chỉ đề xuất điểm đã lặp lại ở ít nhất 2 bài (1 lần xuất hiện có thể
+là ngẫu nhiên, chưa phải giọng). Chỉ ghi vào CLAUDE.md sau khi tôi
+xác nhận từng dòng — không tự ghi đè.
+```
+
+Càng đăng nhiều bài, CLAUDE.md càng sát giọng thật — các agent viết sau tự động dùng bản mới nhất, không cần chỉnh gì thêm.
+
 ## Nguyên tắc
 
 - Ưu tiên phân tích bài viết mẫu thật hơn để khách tự mô tả trừu tượng — con người thường không tự nhận ra giọng của chính mình

package/skills/agent-platform/SKILL.md

@@ -7,7 +7,7 @@ version: "1.3.0"
 
 # /agent-platform — Đăng Bài Lên Nền Tảng
 
-Agent lo bước cuối cùng: lấy nội dung đã duyệt trong `noi-dung/4-approved/{slug}/` (xem quy ước tại `agents/README.md` mục "Cấu trúc thư mục nội dung — quản lý kiểu Kanban") và đăng lên nền tảng blog thật — WordPress, Emdash, hoặc Wix — thông qua MCP hoặc REST API đã kết nối trên máy. Agent này không viết nội dung, không tạo ảnh — chỉ đưa nội dung đã có (`blog.md` + `images/`) lên nền tảng, rồi chuyển cả thư mục bài viết sang `noi-dung/5-published/{slug}/` và ghi thêm 1 dòng vào `noi-dung/_context/published-index.md` sau khi đăng thật thành công. Bài Facebook (`fbpost.md`) đăng thủ công, ngoài phạm vi agent này.
+Agent lo bước cuối cùng: lấy nội dung đã duyệt trong `noi-dung/4-approved/{slug}/` (xem quy ước tại mục "Quy ước thư mục Kanban" trong file này) và đăng lên nền tảng blog thật — WordPress, Emdash, hoặc Wix — thông qua MCP hoặc REST API đã kết nối trên máy. Agent này không viết nội dung, không tạo ảnh — chỉ đưa nội dung đã có (`blog.md` + `images/`) lên nền tảng, rồi chuyển cả thư mục bài viết sang `noi-dung/5-published/{slug}/` và ghi thêm 1 dòng vào `noi-dung/_context/published-index.md` sau khi đăng thật thành công. Bài Facebook (`fbpost.md`) đăng thủ công, ngoài phạm vi agent này.
 
 Mỗi nền tảng có 1 file cấu hình riêng trong `_platforms/{nền tảng}.json` (site URL, cách xác thực, quy tắc format) — `connect` tạo file này 1 lần, các subcommand đăng bài sau đọc lại từ đó thay vì hỏi lại mỗi lần.
 
@@ -223,6 +223,13 @@ hình đọc từ _platforms/wordpress.json.
 - Ảnh trong `blog.md` tham chiếu theo tên file cục bộ (ví dụ `images/quote-1.png`) — agent tự thay bằng URL thật sau khi upload, không cần user chèn lại thủ công trên nền tảng
 - Ảnh đại diện (`images/featured.png`, do `agent-image` tạo riêng, khác các ảnh chèn trong bài) luôn gán vào đúng field ảnh đại diện của nền tảng (featured_media/featured_image/coverImage...), không chèn vào đầu nội dung body
 - Chỉ di chuyển thư mục bài viết sang `5-published/` khi đã publish thật ra công chúng — nếu chỉ tạo draft, giữ nguyên thư mục ở `4-approved/`
+- Ngay sau khi đăng thật thành công và chuyển thư mục sang `5-published/`, gợi ý user chạy `agent-onboarding update [slug]` để học văn phong từ bản đã chốt — mỗi bài đã đăng là chất liệu giúp CLAUDE.md sát giọng thật hơn (không tự chạy, chỉ gợi ý)
+
+## Quy ước thư mục Kanban
+
+Mỗi bài viết (blog + fbpost + `images/`) là 1 thư mục `{slug}/` nằm trong 1 trong 5 stage của `noi-dung/`: `1-ideas → 2-drafting → 3-review → 4-approved → 5-published`. Chuyển stage = di chuyển cả thư mục sang stage kế, không cần thêm field trạng thái. `{slug}` viết thường, không dấu, nối bằng `-`. Bài đơn giản chỉ 1 file để thẳng `.md` trong thư mục stage, không bắt buộc gói thư mục.
+
+Hai file context dùng chung, đặt ngoài các stage: `_context/published-index.md` (mục lục bài đã đăng — agent này ghi thêm dòng sau mỗi lần đăng, `agent-seo` đọc để internal link) và `_platforms/{nền tảng}.json` (cấu hình nền tảng, không chứa token thật).
 
 ## Files
 

package/skills/agent-seo/SKILL.md

@@ -96,7 +96,7 @@ Không nhồi từ khoá lặp lại máy móc — ưu tiên đọc tự nhiên
 đúng cấu trúc sau.
 ```
 
-Khi bắt đầu ghi vào `blog.md`, di chuyển cả thư mục bài viết từ `noi-dung/1-ideas/{slug}/` sang `noi-dung/2-drafting/{slug}/` (nếu chưa ở đó) — xem quy ước tại `agents/README.md` mục "Cấu trúc thư mục nội dung — quản lý kiểu Kanban".
+Khi bắt đầu ghi vào `blog.md`, di chuyển cả thư mục bài viết từ `noi-dung/1-ideas/{slug}/` sang `noi-dung/2-drafting/{slug}/` (nếu chưa ở đó) — xem quy ước tại mục "Quy ước thư mục Kanban" trong file này.
 
 ### Bước 4 — Checklist On-page + E-E-A-T
 
@@ -126,17 +126,27 @@ E-E-A-T:
   không làm được) thay vì chỉ khen không?
 ```
 
-Sau khi chốt bản cuối, lưu vào `blog.md` (cùng vị trí bài blog thường), rồi di chuyển cả thư mục bài viết sang `noi-dung/3-review/{slug}/` — xem quy ước ở `agents/README.md` mục "Cấu trúc thư mục nội dung — quản lý kiểu Kanban".
+Sau khi chốt bản cuối, lưu vào `blog.md` (cùng vị trí bài blog thường), rồi di chuyển cả thư mục bài viết sang `noi-dung/3-review/{slug}/` — xem quy ước ở mục "Quy ước thư mục Kanban" trong file này.
 
 ---
 
+## Lỗi AI cần tránh (đọc CLAUDE.md trước khi viết)
+
+Trước khi viết (Bước 3) và ở checklist on-page (Bước 4), đọc mục **"Lỗi AI cần tránh"** trong `CLAUDE.md` cá nhân và rà bản nháp theo danh sách đó. Mặc định gồm: không dùng dấu phẩy trước "và" (", và"), không chen gạch ngang "-" giữa câu, không dùng gạch ngang dài (—), không dùng khuôn "không phải X, mà là Y", không viết hoa sau dấu hai chấm. Nếu user tự sửa một khuôn AI chưa có trong danh sách, hỏi có muốn thêm vào `CLAUDE.md` không — đồng ý thì thêm 1 dòng, không tự ghi khi chưa hỏi.
+
 ## Nguyên tắc
 
 - Chủ đề chọn viết phải là chủ đề có trải nghiệm thật để trả lời — SEO không thay được chuyên môn thật
 - Cấu trúc phục vụ người đọc trước, công cụ tìm kiếm sau — không hy sinh sự rõ ràng để nhồi từ khoá
-- Áp cùng nguyên tắc giọng văn với agent-blog: không viết hoa sau dấu hai chấm, không dùng gạch ngang dài (—), minh bạch giá nếu nhắc tới sản phẩm/dịch vụ
+- Áp cùng nguyên tắc giọng văn với agent-blog, xem mục "Lỗi AI cần tránh" ở trên, minh bạch giá nếu nhắc tới sản phẩm/dịch vụ
 - Mỗi bài Cluster nên link về đúng 1 Pillar, tránh viết rời rạc không liên kết
 
+## Quy ước thư mục Kanban
+
+Mỗi bài viết (blog + fbpost + `images/`) là 1 thư mục `{slug}/` nằm trong 1 trong 5 stage của `noi-dung/`: `1-ideas → 2-drafting → 3-review → 4-approved → 5-published`. Chuyển stage = di chuyển cả thư mục sang stage kế, không cần thêm field trạng thái. `{slug}` viết thường, không dấu, nối bằng `-` (ví dụ `cach-dat-tieu-de-thu-hut`). Bài đơn giản chỉ 1 file để thẳng `.md` trong thư mục stage, không bắt buộc gói thư mục.
+
+Hai file context dùng chung, đặt ngoài các stage: `_context/published-index.md` (mục lục bài đã đăng — `agent-platform` ghi, `agent-seo` đọc để internal link) và `_platforms/{nền tảng}.json` (cấu hình nền tảng, không chứa token thật).
+
 ## Files
 
 ```

package/skills/agent-write/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: agent-write
+description: "Nhạc trưởng của bộ Showme Studio — hỏi bạn muốn làm gì rồi tự dẫn qua đúng chuỗi agent (chất liệu → tiêu đề → viết → ảnh → đăng), không cần nhớ gõ từng agent theo thứ tự. Dùng khi muốn ra một bài hoàn chỉnh từ đầu đến cuối trong một mạch."
+argument-hint: "[mô tả nhanh muốn làm gì, hoặc subcommand: blog | seo | facebook | combo]"
+version: "1.0.0"
+---
+
+# /agent-write — Làm Một Bài Trọn Vẹn Trong Một Mạch
+
+Bộ Showme Studio có nhiều agent, mỗi agent lo một khâu. Agent này là nhạc trưởng: bạn nói muốn làm gì, nó chọn đúng chuỗi và dẫn bạn đi từng bước, tự chuyển khâu, tự chuyển stage thư mục. Bạn không cần nhớ thứ tự gõ agent.
+
+Nguyên tắc: agent-write **không thay các agent con** — nó chạy đúng quy trình của từng agent con theo thứ tự, dừng ở mỗi khâu để bạn xác nhận/sửa trước khi qua khâu sau. Người viết vẫn cầm lái, chỉ đỡ phải điều phối thủ công.
+
+## Routing
+
+| Input | Chuỗi chạy |
+|---|---|
+| _(empty)_ hoặc `help` | Hỏi bạn muốn làm loại gì, rồi chọn 1 trong 4 chuỗi dưới |
+| `blog` hoặc mô tả bài chuyên môn | Chuỗi Blog |
+| `seo` hoặc từ khoá muốn lên top | Chuỗi SEO |
+| `facebook` hoặc nội dung post FB | Chuỗi Facebook |
+| `combo` | Chuỗi đầy đủ: blog + Facebook + ảnh, đăng web |
+
+Đầu mỗi chuỗi, kiểm tra có `CLAUDE.md` chưa — nếu chưa, dừng và bảo chạy `agent-onboarding` trước (không có nó, mọi bài sẽ sai giọng).
+
+---
+
+## Chuỗi Blog
+
+1. **Chất liệu + người đọc** — chạy `agent-blog` bước 1-2 (khai thác trải nghiệm thật, làm rõ người đọc). Tạo thư mục bài trong `1-ideas/`.
+2. **Thông điệp** — `agent-blog` bước 3 (chấm SUCCESS, chốt thông điệp trung tâm).
+3. **Tiêu đề** — `agent-title` flow chính (sinh + chấm 4U). Chốt 1 tiêu đề.
+4. **Dàn ý + viết + biên tập** — `agent-blog` bước 4-5. Chuyển thư mục `1-ideas → 2-drafting → 3-review`.
+5. **Ảnh đại diện** — hỏi có cần ảnh không; nếu có, chạy `agent-image thumb`.
+6. **Dừng ở review** — báo bạn đọc lại; khi ổn bạn tự chuyển sang `4-approved/`.
+7. **Đăng** — khi bạn duyệt, chạy `agent-platform` đăng bài.
+8. **Học lại giọng** — sau khi đăng thật, gợi ý `agent-onboarding update`.
+
+## Chuỗi SEO
+
+Như chuỗi Blog nhưng thay bước viết bằng `agent-seo` (Pillar/Cluster → nghiên cứu → viết theo E-E-A-T → checklist on-page), và dùng `agent-title seo` ở bước tiêu đề. Trước khi bắt đầu, đọc `_context/published-index.md` để không viết trùng chủ đề đã có và để gắn internal link.
+
+## Chuỗi Facebook
+
+1. **Xác định loại bài** — thông báo/bán mềm (`buildinpublic`) hay ra mắt (`launch`)?
+2. **Câu mở** — `agent-title fbpost` (lọc hook giả).
+3. **Viết** — `agent-fbpost` đúng flow đã chọn.
+4. **Ảnh** — hỏi dạng ảnh: 1 ảnh (`agent-image fb1`), album (`album`), hay carousel (`carousel`).
+5. **Rà cuối** — `agent-fbpost check` trước khi đăng.
+6. Bài Facebook đăng thủ công (ngoài phạm vi `agent-platform`).
+
+## Chuỗi Combo
+
+Chạy chuỗi Blog đầy đủ, và ở bước 5 chèn thêm nhánh Facebook (câu mở + `agent-fbpost buildinpublic` + ảnh) để có 1 bài blog + 1 bài Facebook giới thiệu dùng chung thư mục `{slug}/`. Đăng blog qua `agent-platform`, Facebook đăng tay.
+
+---
+
+## Nguyên tắc
+
+- Dừng ở mỗi khâu để người viết xác nhận, không chạy tuốt một mạch rồi mới cho xem
+- Mỗi khâu dùng đúng quy trình agent con, không tự chế bước mới
+- Luôn đọc `CLAUDE.md` để giữ giọng; luôn di chuyển cả thư mục khi chuyển stage
+- Không tự chuyển `3-review → 4-approved` (đó là bước bạn tự duyệt) và không tự publish khi chưa được xác nhận
+- Cuối chuỗi, có thể chạy `agent-check` để soát bài mới có thiếu file/lệch gì không
+
+## Files
+
+```
+agent-write/
+└── SKILL.md   — router + 4 chuỗi điều phối (file này)
+```