showme-studio 0.1.0

package/bin/install.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+// Cai bo agent Showme Studio vao ~/.claude/skills/
+// Chua co xac thuc/check goi — ai co package nay cung cai duoc. Se them sau.
+import { cpSync, existsSync, mkdirSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const skillsSource = join(here, "..", "skills");
+// --target <path> de test cai lech ra ngoai ~/.claude/skills that
+const targetFlagIndex = process.argv.indexOf("--target");
+const skillsTarget =
+  targetFlagIndex !== -1 && process.argv[targetFlagIndex + 1]
+    ? join(process.argv[targetFlagIndex + 1], ".claude", "skills")
+    : join(homedir(), ".claude", "skills");
+
+if (!existsSync(skillsSource)) {
+  console.error("Khong tim thay bo agent di kem trong package. Lien he Showme de duoc ho tro.");
+  process.exit(1);
+}
+
+mkdirSync(skillsTarget, { recursive: true });
+
+const agentFolders = readdirSync(skillsSource, { withFileTypes: true })
+  .filter((entry) => entry.isDirectory())
+  .map((entry) => entry.name);
+
+console.log(`Cai bo agent Showme Studio vao ${skillsTarget}\n`);
+
+for (const name of agentFolders) {
+  cpSync(join(skillsSource, name), join(skillsTarget, name), {
+    recursive: true,
+    filter: (src) => !src.endsWith("desktop.ini"),
+  });
+  console.log(`  + ${name}`);
+}
+
+console.log(`\nXong — da cai ${agentFolders.length} agent.`);
+console.log("Buoc tiep theo: mo terminal, go 'claude', roi go '/' de chon agent.");
+console.log("Neu day la lan dau, chay 'agent-onboarding' truoc de dung CLAUDE.md ca nhan.");

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "showme-studio",
+  "version": "0.1.0",
+  "description": "Cai bo agent Showme Studio vao ~/.claude/skills/",
+  "type": "module",
+  "bin": {
+    "showme-studio": "bin/install.js"
+  },
+  "files": [
+    "bin",
+    "skills"
+  ],
+  "scripts": {
+    "sync": "node scripts/sync-skills.js"
+  },
+  "license": "UNLICENSED"
+}

package/skills/agent-blog/SKILL.md

@@ -0,0 +1,169 @@
+---
+name: agent-blog
+description: "Viết bài blog chuyên môn giữ đúng giọng văn cá nhân, từ chất liệu thật đến bản nháp hoàn chỉnh. Dùng framework SUCCESS (Made to Stick), Big 5 (They Ask You Answer) và nguyên tắc rõ ràng của Everybody Writes."
+argument-hint: "[chủ đề/trải nghiệm muốn viết, hoặc subcommand: topic | outline | edit]"
+version: "1.0.0"
+---
+
+# /agent-blog — Viết Blog Chuyên Môn Giữ Chất Riêng
+
+Agent viết bài blog cho người làm chuyên môn, dựa trên quy trình 5 bước của Showme Studio, kết hợp 3 nền tảng đã được kiểm chứng:
+
+- **SUCCESS (Made to Stick — Chip & Dan Heath):** một ý tưởng dính (nhớ được, thay đổi được góc nhìn người đọc) cần Simple, Unexpected, Concrete, Credible, Emotional, Story
+- **Big 5 (They Ask You Answer — Marcus Sheridan):** 5 nhóm chủ đề luôn kéo được người đọc thật — giá/chi phí, so sánh, vấn đề thường gặp, đánh giá, "tốt nhất trong nhóm"
+- **Everybody Writes (Ann Handley):** ưu tiên rõ ràng hơn hay ho, viết như đang nói với một người cụ thể, không viết cho đám đông vô hình
+
+Quan điểm xuyên suốt: AI không viết thay. AI hỏi sâu, soi điểm mù, gợi ý cấu trúc, phản biện và biên tập. Người viết vẫn là người cung cấp trải nghiệm thật và chịu trách nhiệm với quan điểm cuối cùng.
+
+## Routing
+
+| Input | Hành động |
+|---|---|
+| _(empty)_ hoặc `help` | In hướng dẫn + ví dụ |
+| trải nghiệm/chủ đề cụ thể | Chạy **Full Flow**: 5 bước từ chất liệu đến bản nháp |
+| `topic` | Không có chủ đề sẵn — dùng Big 5 để gợi ý chủ đề từ câu hỏi khách hàng thật |
+| `outline [thông điệp]` | Chỉ chạy bước lập dàn ý |
+| `edit [bản nháp]` | Chỉ chạy bước biên tập trên bản nháp có sẵn |
+
+---
+
+## Full Flow
+
+### Bước 1 — Đưa chất liệu thật vào
+
+Không bắt đầu bằng "hãy viết cho tôi một bài". Bắt đầu từ kinh nghiệm, tình huống, quan sát, câu hỏi khách hàng hoặc bài học đã trải qua.
+
+```text
+Tôi muốn viết một bài chuyên môn dựa trên trải nghiệm sau:
+
+[Dán trải nghiệm/câu chuyện/ghi chú thô]
+
+Hãy hỏi tôi 10 câu hỏi để khai thác sâu hơn: bối cảnh, vấn đề, quyết định,
+bài học, sai lầm, góc nhìn khác biệt và điều người đọc có thể áp dụng.
+```
+
+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/`.
+
+### Bước 2 — Làm rõ người đọc
+
+```text
+Dựa trên chất liệu trên, hãy giúp tôi xác định:
+
+1. Người đọc phù hợp nhất là ai?
+2. Họ đang gặp vấn đề gì?
+3. Họ thường hiểu sai điều gì?
+4. Sau bài viết này, họ nên nhìn vấn đề khác đi như thế nào?
+
+Không viết bài vội. Chỉ phân tích người đọc và vấn đề.
+```
+
+Áp dụng Everybody Writes: hình dung đang viết cho một người đọc cụ thể, không phải "độc giả nói chung".
+
+### Bước 3 — Tạo thông điệp trung tâm (chấm điểm SUCCESS)
+
+```text
+Từ chất liệu và người đọc đã xác định, hãy đề xuất 5 thông điệp trung tâm
+có thể làm trục cho bài viết.
+
+Sau đó chấm từng thông điệp theo khung SUCCESS:
+- Simple — nói được trong 1 câu không?
+- Unexpected — có phá vỡ điều người đọc mặc định không?
+- Concrete — có ví dụ/con số/hình ảnh cụ thể không?
+- Credible — có bằng chứng hoặc trải nghiệm thật đứng sau không?
+- Emotional — người đọc có lý do để quan tâm không?
+- Story — có gắn được với một tình huống kể lại được không?
+
+Chỉ ra thông điệp nào đạt điểm cao nhất và vì sao.
+```
+
+### Bước 4 — Lập dàn ý
+
+Nếu chưa có tiêu đề, chạy `agent-title` trước (dùng flow chính, không cần subcommand) để sinh và chấm điểm vài phương án theo khung 4U.
+
+Khi bắt đầu ghi dàn ý 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 ở đó). Nếu file chưa có phần ghi chú đăng bài, thêm vào cuối file:
+
+```markdown
+## Ghi chú đăng bài
+- **Category:**
+- **Tags:**
+```
+
+```text
+Hãy tạo dàn ý cho một bài viết chuyên môn dựa trên thông điệp sau:
+
+[Thông điệp trung tâm]
+
+Yêu cầu:
+- Mở bài đi thẳng vào vấn đề
+- Có 3-5 luận điểm chính
+- Mỗi luận điểm cần gắn với ví dụ hoặc trải nghiệm thật
+- Giọng văn rõ ràng, gần gũi, không sáo rỗng
+- Không dùng ngôn ngữ quảng cáo
+```
+
+### Bước 5 — Biên tập bản nháp
+
+```text
+Đây là bản nháp bài viết của tôi:
+
+[Dán bản nháp]
+
+Hãy biên tập theo 4 vòng:
+
+1. Chỉ ra đoạn nào còn chung chung hoặc giống AI.
+2. Chỉ ra đoạn nào cần thêm ví dụ thật (Concrete, theo SUCCESS).
+3. Gợi ý cách làm bài viết mạch lạc hơn.
+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".
+
+---
+
+## Subcommand: `topic` — Tìm chủ đề bằng Big 5
+
+Khi chưa có chất liệu sẵn, dùng 5 nhóm câu hỏi khách hàng thật luôn kéo được người đọc (Marcus Sheridan — They Ask You Answer):
+
+```text
+Hãy giúp tôi liệt kê chủ đề bài blog theo 5 nhóm sau, dựa trên
+chuyên môn/sản phẩm của tôi: [mô tả ngắn]
+
+1. Giá/chi phí — khách hay thắc mắc gì về giá, vì sao mắc/rẻ hơn chỗ khác
+2. So sánh — khách hay so sánh tôi với lựa chọn nào khác
+3. Vấn đề thường gặp — rủi ro, nhược điểm, tình huống khách hay gặp
+4. Đánh giá — khách hay hỏi review về sản phẩm/dịch vụ/công cụ nào
+5. Tốt nhất trong nhóm — khách hay hỏi "cái nào tốt nhất cho..."
+
+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.
+
+---
+
+## 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
+- Không dùng nguyên văn bản AI nếu thấy không giống mì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í
+
+## Dấu hiệu bài viết bị AI hóa
+
+- Nhiều câu đúng nhưng ai cũng có thể nói
+- Dùng quá nhiều cụm như "trong thời đại hiện nay", "điều quan trọng là", "không chỉ... mà còn..."
+- Không có tình huống cụ thể
+- 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 đó
+
+## Files
+
+```
+agent-blog/
+└── SKILL.md   — router + full flow (file này)
+```

package/skills/agent-course-outline/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: agent-course-outline
+description: "Viết outline khoá học theo Backward Design (Wiggins & McTighe) và Bloom's Taxonomy — bắt đầu từ kết quả học viên cần đạt, không bắt đầu từ danh sách nội dung muốn dạy."
+argument-hint: "[chủ đề khoá học, hoặc subcommand: objectives | activities]"
+version: "1.0.0"
+---
+
+# /agent-course-outline — Viết Outline Khoá Học Từ Kết Quả Ngược Lại
+
+Sai lầm phổ biến khi tự soạn khoá học: liệt kê hết những gì mình biết, rồi nhồi vào từng buổi. Backward Design (Understanding by Design — Grant Wiggins & Jay McTighe) đi ngược lại: xác định học viên cần đạt được gì trước, rồi mới thiết kế nội dung và hoạt động để đưa họ tới đó.
+
+3 giai đoạn:
+
+1. **Xác định kết quả mong muốn** — học viên sẽ hiểu/làm được gì sau khoá học
+2. **Xác định bằng chứng đánh giá** — làm sao biết họ đã thật sự đạt được (không phải "đã nghe qua")
+3. **Lập kế hoạch hoạt động học tập** — buổi học, bài tập, thực hành để đưa họ tới kết quả đó
+
+## Routing
+
+| Input | Hành động |
+|---|---|
+| _(empty)_ hoặc `help` | In hướng dẫn + ví dụ |
+| chủ đề khoá học cụ thể | Chạy **Full Flow**: 3 giai đoạn Backward Design |
+| `objectives [chủ đề]` | Chỉ chạy bước viết learning objectives theo Bloom's Taxonomy |
+| `activities [objectives]` | Chỉ chạy bước thiết kế hoạt động học tập từ objectives có sẵn |
+
+---
+
+## Full Flow
+
+### Giai đoạn 1 — Xác định kết quả mong muốn
+
+```text
+Tôi muốn làm khoá học về: [chủ đề]
+
+Đối tượng học viên: [mô tả — họ đang ở trình độ nào, vướng gì]
+
+Hãy giúp tôi xác định:
+
+1. Sau khoá học, học viên sẽ HIỂU được điều gì (viết dạng
+   "Học viên sẽ hiểu rằng...")
+2. 3-5 câu hỏi cốt lõi (essential questions) mà cả khoá học xoay quanh
+   để trả lời — câu hỏi mở, không có đáp án 1 dòng
+3. Sau khoá học, học viên sẽ LÀM ĐƯỢC gì trong thực tế (không phải
+   "biết về" mà là hành động cụ thể có thể quan sát được)
+
+Ưu tiên ít mục tiêu nhưng rõ ràng, hơn là liệt kê nhiều nội dung
+muốn dạy.
+```
+
+### Giai đoạn 2 — Viết Learning Objectives theo Bloom's Taxonomy
+
+```text
+Từ kết quả mong muốn ở trên, hãy viết learning objectives cụ thể
+cho từng buổi/module, phân theo mức độ tư duy (Bloom's Taxonomy),
+từ thấp đến cao:
+
+- Nhớ (Remember) — nhắc lại được khái niệm/thuật ngữ
+- Hiểu (Understand) — giải thích được bằng lời của mình
+- Áp dụng (Apply) — làm được trong tình huống mới
+- Phân tích (Analyze) — so sánh, chỉ ra điểm khác biệt/nguyên nhân
+- Đánh giá (Evaluate) — nhận xét, chọn lựa có lý do
+- Sáng tạo (Create) — tự làm ra sản phẩm/giải pháp riêng
+
+Với khoá học ngắn (dưới 5 buổi), tập trung học viên đạt tới mức
+Áp dụng hoặc Phân tích là hợp lý — đừng kỳ vọng tới Sáng tạo nếu
+thời lượng không đủ.
+
+Mỗi objective viết dạng: "Sau buổi này, học viên có thể [động từ hành
+động cụ thể theo mức Bloom] + [nội dung]."
+```
+
+### Giai đoạn 3 — Xác định bằng chứng đánh giá
+
+```text
+Với các objective ở giai đoạn 2, hãy đề xuất cách để biết học viên
+đã thật sự đạt được — không phải "đã ngồi nghe hết buổi":
+
+- Bài tập/sản phẩm nào học viên tạo ra để chứng minh đã Áp dụng được?
+- Câu hỏi/tình huống nào kiểm tra được mức Phân tích/Đánh giá
+  (không phải câu hỏi đúng/sai đơn giản)?
+- Có cần điểm checkpoint giữa khoá để biết ai đang bị tụt lại không?
+```
+
+### Giai đoạn 4 — Lập kế hoạch hoạt động học tập
+
+```text
+Từ objective và cách đánh giá ở trên, hãy thiết kế outline từng buổi:
+
+- Buổi [số]: [tên buổi]
+  - Mục tiêu buổi này (lấy từ Giai đoạn 2)
+  - Hoạt động chính (không chỉ giảng — có thực hành, thảo luận, ví dụ thật)
+  - Bài tập/sản phẩm đầu ra của buổi
+  - Thời lượng ước tính
+
+Ưu tiên hoạt động có học viên tự làm (retrieval practice — tự nhớ lại
+và áp dụng) hơn là chỉ nghe giảng, vì đây là cách kiến thức được giữ
+lại lâu hơn.
+```
+
+---
+
+## Nguyên tắc
+
+- Bắt đầu từ kết quả học viên cần đạt, không bắt đầu từ danh sách nội dung mình muốn nói
+- Mỗi buổi nên có 1 bài tập/sản phẩm đầu ra cụ thể, không chỉ "nghe hiểu"
+- Không đặt mục tiêu ở mức Bloom cao hơn thời lượng khoá học cho phép
+- Câu hỏi cốt lõi (essential questions) nên xuyên suốt nhiều buổi, không phải mỗi buổi 1 câu hỏi rời rạc
+
+## Files
+
+```
+agent-course-outline/
+└── SKILL.md   — router + 4 giai đoạn Backward Design (file này)
+```

package/skills/agent-fbpost/SKILL.md

@@ -0,0 +1,122 @@
+---
+name: agent-fbpost
+description: "Viết bài Facebook thông báo tính năng/dịch vụ hoặc bài launch, giọng thật không marketing sáo rỗng. Dựa trên PAS/AIDA đã điều chỉnh cho creator solo và bộ rule viết thật (không hook giả, không CTA gượng ép, minh bạch chi phí)."
+argument-hint: "[nội dung/tính năng muốn thông báo, hoặc subcommand: buildinpublic | launch | check]"
+version: "1.0.0"
+---
+
+# /agent-fbpost — Viết Bài Facebook Giọng Thật
+
+Bài Facebook viết bán hàng sai cách thường nghe như quảng cáo: mở hook giật, CTA ép mua ở cuối. Agent này dùng khung PAS/AIDA cổ điển nhưng đã lọc bỏ phần "giả", theo đúng cách hệ thống hoá nội dung của creator solo hiện đại (Content OS — Justin Welsh: viết có hệ thống, lặp lại được, không phải mỗi lần ngồi vào là nghĩ lại từ đầu).
+
+## Routing
+
+| Input | Hành động |
+|---|---|
+| _(empty)_ hoặc `help` | In hướng dẫn + ví dụ |
+| mô tả tính năng/thông báo ngắn | Chạy **buildinpublic** — bài thông báo/khoe tính năng, bán mềm |
+| `launch [sản phẩm/khoá học]` | Chạy **launch** — bài ra mắt sản phẩm/chương trình lớn |
+| `check [bản nháp]` | Chỉ chạy checklist rà theo 9 rule |
+
+---
+
+## Flow: `buildinpublic` (thông báo/khoe tính năng, bán mềm)
+
+Dùng khi thông báo tính năng mới, cập nhật sản phẩm, hoặc kể chuyện vừa làm được gì — không phải bài ra mắt lớn. Nếu chưa chắc câu mở đầu, chạy `agent-title` subcommand `fbpost` trước để có vài phương án đã lọc hook giả.
+
+```text
+Tôi vừa [chuyện vừa xảy ra / tính năng vừa làm xong]: [mô tả]
+
+Hãy viết bài Facebook theo cấu trúc sau:
+
+1. Mở bằng một chuyện vừa xảy ra hoặc tín hiệu thị trường (không hook
+   quảng cáo kiểu "Đây là điều thị trường cần từ lâu")
+2. Giải thích tính năng/sản phẩm bằng một câu đơn giản kiểu
+   "Nói đơn giản, [tính năng] giúp..."
+3. Mô tả luồng hoạt động bằng mũi tên hoặc từng bước rất đời thường
+4. Dùng "Tức là..." để chuyển từ tính năng sang ý nghĩa thật với người đọc
+5. Nói vì sao điều này khớp với hướng đi lớn hơn (không phải tính năng
+   rời rạc)
+6. Thêm 1 câu trong ngoặc đơn để nói rõ ai phù hợp hoặc giảm cảm giác
+   phức tạp
+7. Nếu có chi phí/công cụ bên thứ ba liên quan, ghi rõ số cụ thể và
+   nguồn để người đọc tự kiểm tra
+8. Cảm ơn người liên quan theo tên thật nếu có ai đó đã giúp/tài trợ/hỗ trợ
+9. Kết bằng đoạn "big picture" — định hướng lớn hơn, không phải CTA
+   ép mua
+
+Không viết CTA kiểu "Liên hệ ngay để được tư vấn" ở cuối.
+```
+
+## Flow: `launch` (ra mắt sản phẩm/chương trình)
+
+Dùng khi ra mắt sản phẩm, khoá học, hoặc chương trình mới hoàn toàn.
+
+```text
+Tôi muốn ra mắt: [sản phẩm/chương trình]
+
+Hãy viết bài Facebook theo nhịp cảm xúc sau:
+
+1. Mong muốn âm ỉ — mở bằng điều nhiều người đã mong muốn từ lâu,
+   không mở bằng "chúng tôi ra mắt..."
+2. Điểm kẹt — nỗi khó thật khiến mong muốn đó chưa thành hiện thực
+3. Bối cảnh mới — điều gì (công nghệ, cách làm mới) khiến giờ khả thi hơn
+4. Niềm tin cốt lõi — vì sao cách làm này khác, không đại trà, có bản sắc
+5. Lời mời làm cùng — mô tả chương trình, đầu ra cụ thể
+6. Thông tin bán hàng — lịch, điều kiện, học phí, ưu đãi (ghi số cụ thể,
+   không nói chung chung)
+7. Quà tặng nếu có
+8. Kết bằng triết lý: ai cũng có một điều đặc biệt, nếu chỉ nằm trong
+   đầu thì chỉ có mình biết
+9. CTA inbox — đây là ngoại lệ duy nhất được phép có CTA rõ, vì bài
+   launch cần hành động cụ thể
+```
+
+---
+
+## Subcommand: `check` — Rà theo 9 rule trước khi đăng
+
+```text
+Đây là bản nháp bài Facebook của tôi:
+
+[Dán bản nháp]
+
+Hãy kiểm tra từng rule sau và chỉ rõ câu nào vi phạm:
+
+1. Có mở đầu bằng hook marketing không? (phải bỏ — dùng `agent-title`
+   subcommand `fbpost` nếu cần sinh và lọc nhiều phương án câu mở trước)
+2. Chi phí/giá có nói chung chung không, hay đã ghi rõ số + nguồn?
+3. Có CTA kiểu "liên hệ để tư vấn" ở cuối không? (chỉ bài launch mới
+   đượ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.
+```
+
+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".
+
+---
+
+## 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 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
+
+## Files
+
+```
+agent-fbpost/
+└── SKILL.md   — router + 2 flow + checklist (file này)
+```

package/skills/agent-image/SKILL.md

@@ -0,0 +1,106 @@
+---
+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"
+---
+
+# /agent-image — Tạo Ảnh AI Giữ Đúng Phong Cách Thương Hiệu
+
+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.
+
+## 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 |
+
+---
+
+## Bước 0 — `setup-style`: Xây Style Token (chỉ làm 1 lần)
+
+```text
+Hãy giúp tôi chốt một Style Token cố định cho thương hiệu cá nhân,
+dùng lại y hệt trong mọi ảnh sau này. Tôi mô tả sơ bộ:
+
+- Ngành/chuyên môn: [điền]
+- Cảm giác muốn truyền tải: [ví dụ: gần gũi, chuyên nghiệp, ấm áp]
+- Màu chủ đạo (nếu có): [điền hoặc để AI đề xuất theo ngành]
+- Có dùng ảnh có mặt người/nhân vật cố định không: [có/không]
+
+Hãy chốt lại thành 1 đoạn Style Token khoảng 3-4 câu, mô tả cụ thể:
+phong cách hình ảnh (flat illustration / photo thật / 3D...), bảng màu
+chính xác, kiểu ánh sáng, bố cục thường dùng. Đoạn này tôi sẽ dán lại
+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
+
+```text
+Tạo ảnh quote card với nội dung: "[câu quote]"
+
+Style Token: [dán Style Token đã chốt ở bước 0]
+
+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):
+
+```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"}'
+```
+
+## Flow: `banner` — Ảnh đại diện (featured image) cho bài viết
+
+```text
+Tạo ảnh đại diện cho bài viết chủ đề: [chủ đề]
+
+Style Token: [dán Style Token đã chốt]
+
+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.
+```
+
+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**.
+
+## 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ạ]
+
+Style Token: [dán Style Token đã chốt]
+
+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.
+```
+
+---
+
+## 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)
+- 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
+
+## Files
+
+```
+agent-image/
+└── SKILL.md   — router + setup Style Token + 3 flow tạo ảnh (file này)
+```