showme-studio 0.1.0

package/skills/agent-launch-campaign/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: agent-launch-campaign
+description: "Lên kế hoạch chiến dịch ra mắt sản phẩm/khoá học, dựa trên Product Launch Formula (Jeff Walker) và Soap Opera Sequence (Russell Brunson) — cảm xúc/câu chuyện thật trước, thuyết phục/offer sau. Kết hợp cấu trúc bài launch giọng thật của SHOWME."
+argument-hint: "[sản phẩm/khoá học muốn ra mắt, hoặc subcommand: prelaunch | launchday]"
+version: "1.1.0"
+---
+
+# /agent-launch-campaign — Lên Kế Hoạch Ra Mắt Sản Phẩm
+
+Sai lầm phổ biến: ra mắt bằng đúng 1 bài đăng "hôm nay mở bán". Product Launch Formula (Jeff Walker) chỉ ra ra mắt hiệu quả là một chuỗi, không phải 1 bài — người xem cần được cho giá trị và xây kỳ vọng trước khi thấy lời chào mua.
+
+2 nguyên tắc gốc xuyên suốt:
+
+- **Value Before Reveal** — cho giá trị thật trước, chưa vội nói "mua đi"
+- **Desire Before Availability** — xây mong muốn trước khi sản phẩm mở bán, không phải mở bán rồi mới thuyết phục
+
+Toàn bộ chuỗi chia làm 2 pha rõ rệt — **cảm xúc trước, thuyết phục sau**:
+
+- **Pha Cảm xúc** (Pre-Prelaunch + 3 nội dung Prelaunch): dùng **Soap Opera Sequence** (Russell Brunson) — kể một câu chuyện thật theo 4 nhịp cảm xúc, chưa chào bán: bối cảnh quen thuộc → kịch tính/nỗi đau → khoảnh khắc giác ngộ → lợi ích bất ngờ. Người đọc cần thấy mình trong câu chuyện trước khi sẵn sàng nghe lời chào mua
+- **Pha Thuyết phục** (Launch Day): nhịp thứ 5 của Soap Opera Sequence — thúc giục hành động, đây là nơi duy nhất được đẩy CTA rõ ràng
+
+Không đảo ngược thứ tự: chưa kể xong câu chuyện cảm xúc thì chưa mở bán, và Launch Day không lặp lại nội dung giáo dục đã cho ở Pha Cảm xúc — chỉ tập trung thuyết phục + CTA.
+
+## Routing
+
+| Input | Hành động |
+|---|---|
+| _(empty)_ hoặc `help` | In hướng dẫn + ví dụ |
+| sản phẩm/khoá học cụ thể | Chạy **Full Flow**: Pre-Prelaunch → Prelaunch (3 nội dung) → Launch Day |
+| `prelaunch [sản phẩm]` | Chỉ chạy 3 nội dung Prelaunch |
+| `launchday [sản phẩm]` | Chỉ chạy bài Launch Day (dùng chung cấu trúc với `/agent-fbpost launch`) |
+
+---
+
+## Full Flow
+
+### Giai đoạn 1 — Pre-Prelaunch (xây kỳ vọng, 3-7 ngày trước)
+
+**Soap Opera Sequence — Nhịp 1: Bối cảnh quen thuộc.** Chưa có kịch tính, chỉ cho người đọc thấy mình trong đó.
+
+```text
+Tôi sắp ra mắt: [sản phẩm/khoá học]
+
+Hãy giúp tôi viết 1-2 bài "hé lộ nhẹ" đăng trước ngày mở bán, theo tinh
+thần: không nói rõ đó là gì, chỉ tạo cảm giác "có gì đó đang được chuẩn bị".
+
+Mở bằng một bối cảnh/tình huống đời thường mà đúng người đọc mục tiêu
+sẽ thấy mình trong đó (không phải kịch tính, chỉ là "à, đúng là mình
+hay gặp cảnh này") — kể một quan sát/trải nghiệm gần đây đang dẫn tới
+quyết định làm sản phẩm này, chưa nhắc tên sản phẩm hay giá.
+```
+
+### Giai đoạn 2 — Prelaunch: 3 nội dung giá trị (đăng cách nhau vài ngày)
+
+Đăng tuần tự, mỗi nội dung cách nhau vài ngày để giữ nhịp chờ đợi. 3 nội dung này lần lượt đi qua nhịp 2, 3, 4 của Soap Opera Sequence — vẫn là Pha Cảm xúc, chưa chào bán.
+
+**Nội dung 1 — Kịch tính/nỗi đau & lối mở (SOS nhịp 2 + đầu nhịp 3)**
+
+```text
+Viết nội dung Prelaunch #1 cho [sản phẩm]. Mục tiêu:
+
+1. Nói rõ "bức tường" đã chặn đường — nỗi đau/khó khăn thật đã gặp,
+   những gì đã thử mà không hiệu quả, sự thất vọng thật (không phóng
+   đại, không kịch hoá giả tạo)
+2. Sau đó mới hé lộ ý tưởng lớn đằng sau sản phẩm — tiềm năng nó mang
+   lại, vì sao điều này quan trọng với người đọc ngay bây giờ
+
+Chưa bán, chỉ mở ra khả năng mới sau khi đã thừa nhận nỗi đau thật.
+```
+
+**Nội dung 2 — Khoảnh khắc giác ngộ & bằng chứng (SOS nhịp 3 + đầu nhịp 4)**
+
+```text
+Viết nội dung Prelaunch #2 cho [sản phẩm]. Mục tiêu:
+
+1. Kể lại đúng khoảnh khắc phát hiện ra cách làm khác — chuyện gì cụ
+   thể đã xảy ra khiến góc nhìn thay đổi, không nói chung chung
+2. Chủ động nói ra những nghi ngờ/phản đối phổ biến người đọc có thể
+   có (giá, thời gian, liệu có hợp với mình không), trả lời thẳng thắn.
+   Nếu có case thật/phản hồi trước đó, đưa vào làm bằng chứng
+```
+
+**Nội dung 3 — Lợi ích bất ngờ & bước tiếp theo (SOS nhịp 4)**
+
+```text
+Viết nội dung Prelaunch #3 cho [sản phẩm]. Mục tiêu: dạy một phần thật
+sự hữu ích (không giữ lại), cho người đọc thấy lợi ích cụ thể mà có
+thể họ không ngờ tới khi mới nghe ý tưởng ban đầu, rồi hé lộ ngày mở
+bán sắp tới.
+```
+
+### Giai đoạn 3 — Launch Day (mở bán)
+
+**Soap Opera Sequence — Nhịp 5: Thúc giục hành động.** Đây là điểm chuyển từ Pha Cảm xúc sang Pha Thuyết phục — toàn bộ câu chuyện đã kể ở Giai đoạn 1-2 giờ dẫn tới lời chào mua rõ ràng.
+
+```text
+Viết bài mở bán cho [sản phẩm], dùng cấu trúc bài launch:
+
+Mở bằng mong muốn lâu nay.
+Nói nỗi khó thật.
+Kể lại điều vừa xảy ra / trải nghiệm gần đây.
+Mở rộng khả năng mới.
+Chặn hiểu lầm (không phải làm đại trà, công nghiệp giống nhau).
+Đặt niềm tin: có hồn, có bản sắc, là mình.
+Giới thiệu chương trình.
+Nói rõ đầu ra.
+Nói điều kiện, lịch, học phí, ưu đãi.
+Nói quà tặng nếu có.
+Kết bằng triết lý SHOWME.
+CTA inbox.
+```
+
+Có thể chạy trực tiếp `/agent-fbpost launch [sản phẩm]` cho bước này — dùng chung 1 cấu trúc.
+
+---
+
+## Nguyên tắc
+
+- Cảm xúc trước, thuyết phục sau — không đảo ngược thứ tự 5 nhịp Soap Opera Sequence, không chào bán khi câu chuyện chưa kể xong
+- Không mở bán ngay từ bài đầu tiên — luôn có ít nhất 2-3 nội dung giá trị trước Launch Day
+- Nội dung Prelaunch phải cho giá trị thật và cảm xúc thật (nỗi đau/khoảnh khắc giác ngộ là chuyện có thật đã xảy ra), không phải teaser rỗng hay kịch hoá giả tạo chỉ để câu tương tác
+- Chủ động nói ra phản đối/nghi ngờ trước khi người đọc tự nghĩ ra và bỏ qua
+- Launch Day là nơi duy nhất được đẩy CTA rõ ràng — các bài trước không CTA mua
+- Áp cùng nguyên tắc giọng văn SHOWME: minh bạch giá, không hook giả, không sáo rỗng
+
+## Files
+
+```
+agent-launch-campaign/
+└── SKILL.md   — router + Soap Opera Sequence (Pha Cảm xúc) + Launch Day (Pha Thuyết phục), theo Product Launch Formula (file này)
+```

package/skills/agent-onboarding/SKILL.md

@@ -0,0 +1,144 @@
+---
+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"
+---
+
+# /agent-onboarding — Dựng CLAUDE.md Từ Context Thật
+
+Đa số người dùng khó tự mô tả giọng văn của mình bằng lời (tự nhận ra giọng mình khó hơn tự nhận ra giọng người khác). Agent này giải quyết bằng 2 cách song song: hỏi trực tiếp về bối cảnh dự án, và phân tích bài viết mẫu có sẵn thay vì bắt khách tự mô tả giọng văn trừu tượng.
+
+Nền tảng: phân biệt **Voice** và **Tone** (Mailchimp Content Style Guide) — Voice là giọng cố định, giữ nguyên xuyên suốt mọi bài viết (con người thật của bạn). Tone là cách giọng đó thể hiện ra tuỳ ngữ cảnh — bài dạy khác bài thông báo, khác bài ra mắt. CLAUDE.md cần ghi rõ cả hai, không gộp chung.
+
+## Routing
+
+| Input | Hành động |
+|---|---|
+| _(empty)_ hoặc `help` | Bắt đầu **Full Flow** — hội thoại dẫn dắt qua 4 bước |
+| `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 |
+
+---
+
+## Full Flow
+
+### Bước 1 — Bối cảnh dự án
+
+Hỏi từng câu một, không hỏi dồn hết một lúc:
+
+```text
+1. Bạn đang làm/bán gì? (sản phẩm, dịch vụ, hoặc chuyên môn đang chia sẻ)
+2. Ai là người đọc/khách hàng chính? Họ đang vướng gì?
+3. Dùng agent này để làm gì là chính — viết blog đều hơn, ra bài SEO,
+   đăng Facebook, hay chuẩn bị ra mắt sản phẩm?
+4. Giai đoạn hiện tại của dự án là gì? (mới bắt đầu, đã có khách,
+   sắp ra mắt sản phẩm mới...)
+```
+
+Tóm tắt lại thành đoạn ngắn để khách xác nhận trước khi qua bước 2.
+
+### Bước 2 — Rút Voice Profile (2 cách, chọn 1)
+
+**Cách A — Có bài viết cũ (ưu tiên, chính xác hơn tự mô tả)**
+
+```text
+Hãy dán 2-3 bài viết bạn từng viết (blog, Facebook, email — loại nào
+cũng được, miễn là do chính bạn viết, không phải AI viết hộ).
+
+Tôi sẽ phân tích và rút ra:
+- Độ dài câu trung bình, câu ngắn hay dài
+- Cách mở bài thường dùng (vào thẳng vấn đề, kể chuyện, đặt câu hỏi...)
+- Từ/cụm từ hay lặp lại
+- Cách kết bài
+- Điều bạn có xu hướng tránh (ví dụ: không dùng từ to tát, không
+  viết câu cảm thán)
+
+Sau đó tôi tóm tắt thành Voice Profile 4-5 dòng để bạn xác nhận
+đúng là giọng của bạn không.
+```
+
+**Cách B — Chưa có bài viết nào (dùng phỏng vấn)**
+
+```text
+Chưa có bài mẫu thì trả lời nhanh các câu sau, trả lời bằng bản năng,
+không cần nghĩ quá kỹ:
+
+1. Khi giải thích điều gì đó cho bạn bè, bạn hay nói dài dòng hay
+   đi thẳng vào ý chính?
+2. Bạn ghét đọc kiểu văn viết nào nhất? (sáo rỗng, khô khan, quá
+   nhiều thuật ngữ, quá "cố tỏ ra vui vẻ"...)
+3. Có câu/cụm từ nào bạn hay dùng khi nói chuyện đời thường, mà
+   muốn giữ cả khi viết?
+4. Có điều gì bạn nhất định không muốn xuất hiện trong bài viết
+   của mình? (ví dụ: CTA ép mua, viết hoa tuỳ tiện, nói quá về
+   sản phẩm)
+```
+
+### Bước 3 — Người viết truyền cảm hứng (tuỳ chọn)
+
+```text
+Có ai bạn hay đọc và thích cách họ viết không? (không nhất thiết
+cùng ngành)
+
+Nếu có, hãy nói tên hoặc dán 1 đoạn viết của họ mà bạn thích. Tôi sẽ
+chỉ ra cụ thể điều gì ở cách viết đó đáng học — ví dụ: cách vào bài,
+cách dùng ví dụ, độ dài đoạn văn — để tham khảo kỹ thuật, không phải
+để sao chép giọng của họ. Giọng cuối cùng vẫn phải là giọng bạn ở
+Bước 2.
+```
+
+### Bước 4 — Tone theo ngữ cảnh + tổng hợp CLAUDE.md
+
+```text
+Voice của bạn giữ nguyên, nhưng Tone (cách thể hiện) nên khác nhau
+tuỳ loại bài. Hãy xác nhận nhanh:
+
+- Bài dạy/chia sẻ kiến thức: tông muốn ra sao? (điềm tĩnh, chắc chắn...)
+- Bài thông báo/khoe sản phẩm: tông muốn ra sao? (hào hứng nhưng
+  không quá đà...)
+- Bài ra mắt/bán hàng: tông muốn ra sao? (tin tưởng, rõ ràng,
+  không ép buộc...)
+
+Từ tất cả thông tin đã thu thập (Bước 1-4), hãy tổng hợp thành file
+CLAUDE.md hoàn chỉnh theo đúng format:
+
+# Giọng văn của tôi
+
+## Tôi là ai
+[từ Bước 1]
+
+## Đối tượng đọc chính
+[từ Bước 1]
+
+## Cách tôi thường nói
+[Voice Profile từ Bước 2, có thể thêm điều học được từ Bước 3]
+
+## Tone theo loại bài
+[từ Bước 4 — liệt kê rõ tông cho từng loại bài]
+
+## Điều tôi không muốn
+[từ Bước 2]
+
+## Bối cảnh đang làm
+[từ Bước 1]
+```
+
+Lưu file này vào thư mục làm việc, tên `CLAUDE.md`. Từ phiên sau, mọi agent khác trong bộ Showme Studio tự đọc file này.
+
+---
+
+## 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
+- Người viết truyền cảm hứng chỉ để học kỹ thuật cụ thể, không phải để giọng cuối cùng giống hệt người đó
+- Tone thay đổi theo ngữ cảnh, Voice thì không — không gộp hai khái niệm này làm một khi viết CLAUDE.md
+- Nếu khách trả lời sơ sài ở bước nào, hỏi lại 1 câu cụ thể hơn thay vì tự bịa cho đủ
+
+## Files
+
+```
+agent-onboarding/
+└── SKILL.md   — router + 4 bước dựng CLAUDE.md (file này)
+```

package/skills/agent-platform/SKILL.md

@@ -0,0 +1,232 @@
+---
+name: agent-platform
+description: "Đăng bài blog (kèm ảnh) lên WordPress, Emdash hoặc Wix. Hướng dẫn lấy thông tin kết nối nền tảng, ghi vào file cấu hình _platforms/{nền tảng}.json, rồi đăng qua MCP/API. Đọc nội dung từ noi-dung/4-approved/{slug}/blog.md và ảnh trong images/, chuyển thư mục sang 5-published/ và cập nhật _context/published-index.md sau khi đăng."
+argument-hint: "[slug bài viết muốn đăng, hoặc subcommand: connect | wordpress | emdash | wix]"
+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.
+
+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.
+
+## Routing
+
+| Input | Hành động |
+|---|---|
+| _(empty)_ hoặc `help` | In hướng dẫn + ví dụ |
+| `connect [nền tảng]` | Hướng dẫn kết nối + tạo `_platforms/{nền tảng}.json` — chạy trước khi đăng lần đầu trên mỗi site |
+| `wordpress [slug]` | Đăng bài trong `noi-dung/4-approved/[slug]/` lên WordPress |
+| `emdash [slug]` | Đăng bài lên Emdash |
+| `wix [slug]` | Đăng bài lên Wix |
+
+Chỉ đăng bài đang ở `4-approved/` — nếu `[slug]` đang ở stage khác (`1-ideas`, `2-drafting`, `3-review`), báo user bài chưa được duyệt, không tự đăng.
+
+Nếu chưa rõ đang dùng nền tảng nào, hỏi user trước khi chạy bất kỳ subcommand nào. Trước khi đăng, kiểm tra `_platforms/{nền tảng}.json` đã tồn tại chưa — nếu chưa, chạy `connect` trước.
+
+---
+
+## Subcommand: `connect` — Kết nối nền tảng (làm 1 lần cho mỗi site)
+
+Trước khi hướng dẫn lấy thông tin kết nối, kiểm tra xem đã có MCP server phù hợp cấu hình sẵn chưa (WordPress MCP, MCP riêng theo site Emdash, hoặc Wix connector) — nếu có, ưu tiên dùng MCP thay vì gọi REST API trực tiếp bằng curl.
+
+**Nguyên tắc chung khi tạo `_platforms/{nền tảng}.json`:** file này chỉ chứa cấu hình (site URL, tên MCP server, quy tắc format, scope quyền cần có) — **không bao giờ ghi token/password thật vào file này.** Token thật lưu trong biến môi trường hoặc trình quản lý secret riêng của máy, file JSON chỉ ghi *cách lấy* token đó.
+
+### WordPress
+
+```text
+Để đăng bài lên WordPress qua REST API (nếu chưa có MCP WordPress), cần:
+
+1. Đăng nhập WordPress admin → Users → Profile (hồ sơ của chính bạn)
+2. Kéo xuống mục "Application Passwords"
+3. Đặt tên bất kỳ (ví dụ "Claude Agent"), bấm "Add New Application Password"
+4. Copy password hiện ra (chỉ hiện đúng 1 lần, dạng "xxxx xxxx xxxx xxxx")
+5. Ghi lại thêm: URL site và username đăng nhập
+
+Lưu username + application password vào biến môi trường hoặc CLAUDE.md
+cá nhân (không public, không commit git). Tạo _platforms/wordpress.json:
+
+{
+  "platform": "wordpress",
+  "site_url": "https://your-domain.com",
+  "api_base": "https://your-domain.com/wp-json/wp/v2",
+  "format": { "input": "html", "note": "REST API nhận HTML, chuyển Markdown sang HTML trước khi gửi" },
+  "authentication": {
+    "type": "application-password",
+    "header": "Authorization: Basic base64(username:application_password)",
+    "note": "Tạo tại Users → Profile → Application Passwords"
+  },
+  "featured_image": { "field": "featured_media", "upload_endpoint": "/media" },
+  "publish": { "default_status": "draft" }
+}
+```
+
+### Emdash
+
+```text
+Emdash xác thực bằng Personal Access Token (PAT), không dùng OAuth:
+
+1. Vào {site_url}/_emdash → Settings → API Tokens
+2. Tạo token mới, chọn đủ scope: content:read, content:write,
+   media:read, media:write, taxonomies:manage
+3. Copy token (dạng "ec_pat_...", chỉ hiện 1 lần)
+
+Lưu token vào biến môi trường hoặc CLAUDE.md cá nhân (không public,
+không commit git). Tạo _platforms/emdash.json:
+
+{
+  "platform": "emdash",
+  "site_url": "https://your-domain.com",
+  "admin_url": "https://your-domain.com/_emdash",
+  "mcp_endpoint": "https://your-domain.com/_emdash/api/mcp",
+  "mcp_server_name": "ten-mcp-server-da-cau-hinh-trong-claude-code",
+  "content_collection": "posts",
+  "format": { "input": "markdown", "note": "Emdash nhận Markdown trực tiếp, không cần chuyển sang Ricos JSON" },
+  "authentication": {
+    "type": "personal-access-token",
+    "token_format": "ec_pat_*",
+    "header": "Authorization: Bearer ec_pat_YOUR_TOKEN",
+    "scopes_needed": ["content:read", "content:write", "media:read", "media:write", "taxonomies:manage"]
+  },
+  "featured_image": { "field": "featured_image", "note": "Set qua field riêng, không chèn vào đầu nội dung body" },
+  "mcp_tools": {
+    "create_post": "content.create (collection: posts)",
+    "publish_post": "content.publish",
+    "update_post": "content.update",
+    "schedule_post": "content.schedule"
+  },
+  "publish": { "default_status": "draft" }
+}
+
+Nếu MCP server (dạng mcp__{ten-site}__content_create...) đã có sẵn
+trong danh sách tool, dùng MCP thay vì gọi thẳng mcp_endpoint bằng curl.
+Gọi thử content_list/content.list trước để xác nhận kết nối trước khi
+đăng bài thật.
+```
+
+### Wix
+
+```text
+Wix kết nối qua Wix connector (OAuth), không dùng API key thủ công:
+
+1. Nếu dùng claude.ai/Claude Desktop: mở phần cài đặt Connectors,
+   thêm Wix, đăng nhập tài khoản Wix để cấp quyền
+2. Nếu dùng Claude Code CLI: cần MCP server Wix đã cấu hình sẵn trong
+   môi trường — hỏi người hỗ trợ cài đặt nếu chưa quen việc này
+3. Sau khi kết nối, lấy site ID (gọi danh sách site qua MCP, ví dụ
+   ListWixSites) để xác nhận đúng site cần đăng
+
+Tạo _platforms/wix.json:
+
+{
+  "platform": "wix",
+  "site_id": "site-id-lay-tu-buoc-3",
+  "site_url": "https://your-domain.com",
+  "blog_url": "https://your-domain.com/blog",
+  "format": {
+    "input": "markdown",
+    "note": "Wix Blog API nhận Ricos JSON, không nhận Markdown thô — phải chuyển Markdown sang Ricos JSON trước khi gọi API (dùng Wix MCP nếu MCP tự lo bước này)"
+  },
+  "seo": {
+    "title_source": "Meta Title trong file draft — KHÔNG để Wix tự generate",
+    "description_source": "Meta Description trong file draft",
+    "slug_gotcha": "Wix mặc định tự sinh slug từ tiêu đề bài, thường ra tiếng Việt có dấu. Phải override thủ công qua field seoSlug (tiếng Anh/không dấu, nối bằng -) sau khi tạo draft."
+  },
+  "featured_image": { "field": "coverImage hoặc tương đương trong Wix Blog API", "note": "Dùng ảnh featured.png riêng, không chèn vào đầu nội dung body" },
+  "publish": { "default_status": "draft" }
+}
+```
+
+---
+
+## Subcommand: `wordpress [slug]` — Đăng lên WordPress
+
+```text
+Đăng bài noi-dung/4-approved/[slug]/blog.md lên WordPress, dùng cấu
+hình đọc từ _platforms/wordpress.json.
+
+1. Đọc blog.md, tách tiêu đề (H1 đầu tiên) làm title, phần còn lại
+   chuyển từ Markdown sang HTML làm content
+2. Upload images/featured.png (nếu có) qua endpoint media, gán vào
+   field featured_media — không chèn ảnh này vào đầu content
+3. Với mỗi ảnh khác trong images/ được tham chiếu trong blog.md, upload
+   qua endpoint media, lấy URL trả về, thay tham chiếu cục bộ trong
+   content bằng URL đã upload
+4. Tạo bài viết với title, content, featured_media, status=draft —
+   chỉ đặt publish khi user xác nhận rõ ràng
+5. Trả về link bài viết (link nháp hoặc link live tuỳ status)
+6. Chỉ khi đã publish thật (không phải draft): thêm dòng URL bài đã
+   đăng vào phần ghi chú đăng bài trong blog.md, rồi di chuyển cả
+   thư mục bài viết sang noi-dung/5-published/[slug]/
+7. Thêm 1 dòng vào noi-dung/_context/published-index.md (tạo file với
+   header bảng nếu chưa có): ngày đăng, tiêu đề, URL, category, tags
+```
+
+## Subcommand: `emdash [slug]` — Đăng lên Emdash
+
+```text
+Đăng bài noi-dung/4-approved/[slug]/blog.md lên Emdash, dùng cấu hình
+đọc từ _platforms/emdash.json.
+
+1. Đọc blog.md, tách tiêu đề, mô tả ngắn (nếu có), nội dung — giữ
+   nguyên Markdown, Emdash nhận trực tiếp
+2. Upload images/featured.png (nếu có) qua MCP Emdash
+   (media_create/media.create), gán vào field featured_image — không
+   chèn ảnh này vào đầu nội dung
+3. Upload các ảnh khác trong images/ được tham chiếu trong blog.md,
+   thay tham chiếu cục bộ bằng URL/storageKey trả về
+4. Tạo nội dung bằng content_create/content.create (collection: posts),
+   mặc định status=draft — chỉ publish (content_publish/content.publish)
+   khi user xác nhận rõ ràng
+5. Trả về link xem trước
+6. Chỉ khi đã publish thật (không phải draft): thêm dòng URL bài đã
+   đăng vào phần ghi chú đăng bài trong blog.md, rồi di chuyển cả
+   thư mục bài viết sang noi-dung/5-published/[slug]/
+7. Thêm 1 dòng vào noi-dung/_context/published-index.md (tạo file với
+   header bảng nếu chưa có): ngày đăng, tiêu đề, URL, category, tags
+```
+
+## Subcommand: `wix [slug]` — Đăng lên Wix
+
+```text
+Đăng bài noi-dung/4-approved/[slug]/blog.md lên Wix, dùng cấu hình
+đọc từ _platforms/wix.json.
+
+1. Đọc blog.md, tách tiêu đề, nội dung
+2. Chuyển nội dung từ Markdown sang Ricos JSON (định dạng Wix Blog API
+   yêu cầu) — dùng Wix MCP nếu MCP tự lo bước chuyển đổi này
+3. Upload images/featured.png (nếu có) lên Wix, gán làm ảnh đại diện —
+   không chèn ảnh này vào đầu nội dung body
+4. Upload các ảnh khác trong images/ được tham chiếu trong blog.md,
+   gắn vào đúng vị trí trong Ricos JSON
+5. Lấy Meta Title/Meta Description từ blog.md, KHÔNG để Wix tự generate
+6. Tạo bài viết ở trạng thái draft, sau đó override field seoSlug
+   bằng slug tiếng Anh không dấu (Wix tự sinh slug có dấu từ tiêu đề,
+   phải sửa lại thủ công) — chỉ publish khi user xác nhận rõ ràng
+7. Trả về link bài viết
+8. Chỉ khi đã publish thật (không phải draft): thêm dòng URL bài đã
+   đăng vào phần ghi chú đăng bài trong blog.md, rồi di chuyển cả
+   thư mục bài viết sang noi-dung/5-published/[slug]/
+9. Thêm 1 dòng vào noi-dung/_context/published-index.md (tạo file với
+   header bảng nếu chưa có): ngày đăng, tiêu đề, URL, category, tags
+```
+
+---
+
+## Nguyên tắc chung
+
+- Mặc định tạo bản draft, không tự publish công khai — luôn hỏi user xác nhận trước khi đăng thật ra công chúng
+- Không tự đoán thông tin kết nối (site URL, key, tên MCP server...) — nếu thiếu, chạy `connect` trước, không tự bịa
+- Không bao giờ ghi token/application password thật vào `_platforms/{nền tảng}.json`, file trong `noi-dung/`, hay commit vào git — chỉ lưu trong biến môi trường hoặc `CLAUDE.md` cá nhân (không public)
+- Nếu MCP/API trả lỗi xác thực, dừng lại và báo user kiểm tra lại bước `connect`, không tự thử đổi endpoint hay đoán lại thông tin khác
+- Ả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/`
+
+## Files
+
+```
+agent-platform/
+└── SKILL.md   — router + connect (3 nền tảng) + 3 flow đăng bài (file này)
+```

package/skills/agent-seo/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: agent-seo
+description: "Viết bài SEO chuẩn cấu trúc, dựa trên E-E-A-T (Google), Skyscraper Technique (Backlinko), Topic Cluster (HubSpot) và TOFU-MOFU-BOFU (funnel marketing). Dùng khi muốn bài viết vừa xếp hạng tốt vừa giữ được chất chuyên gia thật, vừa phủ đều các giai đoạn hành trình mua hàng."
+argument-hint: "[từ khoá/chủ đề muốn lên top, hoặc subcommand: cluster | research | onpage]"
+version: "1.1.0"
+---
+
+# /agent-seo — Viết Bài SEO Giữ Chất Chuyên Gia
+
+Khác với bài blog kể chuyện tự do, bài SEO cần vừa đúng cấu trúc để công cụ tìm kiếm hiểu, vừa đủ thật để người đọc và Google tin đây là nội dung của một người có chuyên môn thật. Agent này dùng 4 nền tảng:
+
+- **Topic Cluster / Pillar Page (HubSpot):** một trang trụ (pillar) bao quát chủ đề lớn, nhiều bài cluster đi sâu từng nhánh nhỏ, tất cả link chéo về nhau — thay vì viết rời rạc từng bài không liên kết
+- **TOFU-MOFU-BOFU (funnel marketing):** phân loại từng bài Cluster theo giai đoạn hành trình mua hàng — TOFU (Top of Funnel: nhận biết vấn đề, chưa nghĩ tới giải pháp cụ thể), MOFU (Middle: đang cân nhắc giải pháp/so sánh lựa chọn), BOFU (Bottom: sẵn sàng mua, cần lý do chốt) — để bộ Cluster không lệch hẳn về TOFU (nhiều traffic nhưng ít ai mua) hay BOFU (ít traffic nhưng không ai tìm thấy)
+- **Skyscraper Technique (Brian Dean/Backlinko):** tìm nội dung đang xếp hạng tốt nhất cho chủ đề, rồi làm bản tốt hơn — đầy đủ hơn, mới hơn, trình bày rõ hơn, đi sâu hơn
+- **E-E-A-T (Google Search Quality Rater Guidelines):** Google và người đọc đánh giá nội dung qua Experience (trải nghiệm thật), Expertise (chuyên môn), Authoritativeness (uy tín), Trustworthiness (đáng tin) — không phải chỉ nhồi từ khoá
+
+## Routing
+
+| Input | Hành động |
+|---|---|
+| _(empty)_ hoặc `help` | In hướng dẫn + ví dụ |
+| từ khoá/chủ đề cụ thể | Chạy **Full Flow**: cluster → research → viết → onpage |
+| `cluster [chủ đề lớn]` | Chỉ chạy bước xây pillar + cluster |
+| `research [từ khoá]` | Chỉ chạy bước phân tích nội dung đang xếp hạng tốt |
+| `onpage [bản nháp]` | Chỉ chạy checklist on-page cho bài đã viết |
+
+---
+
+## Full Flow
+
+### Bước 1 — Xây Pillar và Cluster
+
+```text
+Chủ đề lớn tôi muốn làm chủ trên Google: [chủ đề]
+
+Hãy giúp tôi:
+1. Xác định 1 trang Pillar bao quát toàn bộ chủ đề (mức độ tổng quan,
+   dài, dẫn tới các bài con)
+2. Đề xuất 5-8 bài Cluster — mỗi bài đi sâu 1 từ khoá dài (long-tail)
+   liên quan trực tiếp tới Pillar
+3. Gắn nhãn từng bài Cluster theo giai đoạn phễu:
+   - TOFU — bài giải thích khái niệm, nhận biết vấn đề, chưa nhắc giải pháp cụ thể
+   - MOFU — bài so sánh, đánh giá, hướng dẫn chọn giải pháp
+   - BOFU — bài giá cả, case study, "vì sao chọn [sản phẩm/dịch vụ mình]"
+4. Kiểm tra bộ Cluster đã đề xuất có phủ đủ cả 3 giai đoạn chưa —
+   nếu lệch hẳn về TOFU (toàn bài kiến thức chung) hoặc BOFU (toàn bài
+   bán hàng), đề xuất thêm bài để cân lại
+5. Vẽ sơ đồ: bài nào link về Pillar, Pillar link tới bài nào
+
+Ưu tiên chủ đề mà tôi có kinh nghiệm thật để trả lời, không chọn
+chủ đề chỉ vì có volume tìm kiếm cao.
+```
+
+Trước khi vẽ sơ đồ, đọc `noi-dung/_context/published-index.md` (nếu có) — nếu đã có bài đã đăng cùng chủ đề, đưa thẳng vào sơ đồ Cluster thay vì chỉ đề xuất bài mới, tránh viết trùng chủ đề đã có.
+
+### Bước 2 — Nghiên cứu nội dung đang xếp hạng tốt (Skyscraper bước 1-2)
+
+```text
+Từ khoá tôi muốn viết: [từ khoá]
+
+Hãy giúp tôi phân tích những bài đang đứng top cho từ khoá này (dựa trên
+tiêu đề, cấu trúc heading, độ dài, góc nhìn — tôi sẽ dán nội dung nếu có):
+
+1. Các bài đó đang trả lời câu hỏi gì, bỏ sót câu hỏi gì?
+2. Cấu trúc heading của họ ra sao?
+3. Thông tin nào đã cũ, chưa cập nhật?
+4. Tôi có thể làm bài "hơn" ở đâu — đầy đủ hơn, có ví dụ thật hơn,
+   trình bày rõ hơn, trả lời sâu hơn câu hỏi thật?
+
+Không copy cấu trúc, chỉ dùng để biết mình cần vượt qua điều gì.
+```
+
+### Bước 3 — Viết bài theo cấu trúc SEO + chất riêng
+
+```text
+Viết bài cho từ khoá [từ khoá], dựa trên khoảng trống đã tìm ở bước 2
+và trải nghiệm thật của tôi: [dán trải nghiệm/ghi chú]
+
+Yêu cầu cấu trúc:
+- Heading H1 chứa từ khoá chính, đọc tự nhiên như người thật viết
+  (dùng `agent-title` subcommand `seo` nếu muốn sinh nhiều phương án
+  Title/H1 và chấm điểm trước khi viết bài)
+- Đoạn mở trả lời thẳng câu hỏi trong 2-3 câu đầu (không vòng vo)
+- Heading H2/H3 theo từng câu hỏi phụ người đọc thật hay hỏi
+- Có ít nhất 1 đoạn thể hiện Experience thật (đã tự làm, tự thử,
+  tự gặp vấn đề này) — đây là phần AI không tự bịa được, cần chất liệu thật
+- Có ít nhất 1 đoạn thể hiện Expertise cụ thể (số liệu, quy trình,
+  cách làm chi tiết mà người ngoài nghề không biết)
+- Kết bài dẫn về Pillar/bài Cluster liên quan (nếu có)
+- Đọc `noi-dung/_context/published-index.md`, chọn 1-3 bài đã đăng
+  cùng chủ đề/category/tags liên quan, chèn internal link tự nhiên
+  trong thân bài (không chỉ ở kết bài) kèm anchor text mô tả đúng nội
+  dung bài được link tới, không dùng "xem thêm tại đây"
+
+Không nhồi từ khoá lặp lại máy móc — ưu tiên đọc tự nhiên trước,
+đú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".
+
+### Bước 4 — Checklist On-page + E-E-A-T
+
+```text
+Đây là bản nháp bài SEO của tôi:
+
+[Dán bản nháp]
+
+Hãy kiểm tra và chỉ ra chỗ cần sửa theo checklist:
+
+On-page:
+- Title có chứa từ khoá chính, dưới 60 ký tự không? (dùng `agent-title`
+  subcommand `seo` nếu cần sinh và chấm điểm nhiều phương án trước khi chốt)
+- Meta description có nêu rõ lợi ích, dưới 155 ký tự không?
+- Heading H2/H3 có theo đúng thứ tự logic không, có từ khoá phụ không?
+- Có internal link về Pillar/bài liên quan không? (đối chiếu với
+  `noi-dung/_context/published-index.md` — còn bài đã đăng cùng chủ
+  đề nào chưa được link tới không?)
+- Có ảnh minh hoạ kèm alt text mô tả đúng nội dung không?
+
+E-E-A-T:
+- Experience — có đoạn nào thể hiện tôi đã thật sự làm việc này không?
+- Expertise — có chi tiết cụ thể mà chỉ người có chuyên môn mới biết không?
+- Authoritativeness — có nhắc nguồn/số liệu đáng tin, hoặc dẫn về
+  bài khác đã viết cùng chủ đề không?
+- Trustworthiness — có minh bạch (giá, giới hạn, điều sản phẩm/dịch vụ
+  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".
+
+---
+
+## 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ụ
+- 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
+
+## Files
+
+```
+agent-seo/
+└── SKILL.md   — router + full flow (file này)
+```