showme-studio 0.1.0

package/skills/agent-title/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: agent-title
+description: "Đặt tiêu đề/câu mở thu hút cho blog, bài SEO, hoặc bài Facebook — sinh nhiều phương án theo các dạng tiêu đề kinh điển, chấm điểm theo 4U (Copyblogger), áp rule riêng theo kênh. Dùng chung với agent-blog, agent-seo, agent-fbpost."
+argument-hint: "[nội dung/chủ đề bài viết, hoặc subcommand: seo | fbpost | score]"
+version: "1.0.0"
+---
+
+# /agent-title — Đặt Tiêu Đề Thu Hút Đúng Kênh
+
+Một tiêu đề hay không phải tiêu đề "giật" nhất, mà là tiêu đề đúng nhất với kênh đăng. Agent này dùng chung cho `agent-blog`, `agent-seo`, `agent-fbpost` — sinh nhiều phương án theo các dạng tiêu đề kinh điển, rồi chấm điểm và lọc theo rule riêng của từng kênh.
+
+- **4U Formula (Copyblogger):** tiêu đề tốt cần Useful (hữu ích rõ), Urgent (có lý do đọc ngay), Unique (không nói y hệt chỗ khác), Ultra-specific (càng cụ thể càng đáng tin)
+- **Các dạng tiêu đề kinh điển:** Number/List, How-to, Question, Reason-why, Command, Direct benefit — mỗi dạng phù hợp một loại nội dung khác nhau, không có dạng nào "luôn thắng"
+- Với SEO và Facebook, 4U chưa đủ — cần thêm rule riêng của kênh (xem 2 subcommand bên dưới), vì tiêu đề tốt trên Google có thể là hook giả trên Facebook
+
+## Routing
+
+| Input | Hành động |
+|---|---|
+| _(empty)_ hoặc `help` | In hướng dẫn + ví dụ |
+| nội dung/chủ đề bài viết | Chạy **Full Flow**: sinh phương án → chấm 4U → chọn |
+| `seo [từ khoá + nội dung]` | Sinh tiêu đề cho SEO — áp rule từ khoá + độ dài, dùng cùng `agent-seo` |
+| `fbpost [nội dung]` | Sinh câu mở/hook cho Facebook — áp rule "giọng thật", dùng cùng `agent-fbpost` |
+| `score [tiêu đề có sẵn]` | Chỉ chấm điểm 4U cho tiêu đề đã có, không sinh mới |
+
+---
+
+## Full Flow (tiêu đề blog thường, không ràng buộc SEO/FB)
+
+### Bước 1 — Nắm nội dung thật
+
+```text
+Đây là nội dung/chủ đề bài viết: [tóm tắt hoặc dán bản nháp]
+
+Trước khi đặt tiêu đề, hãy tóm tắt lại: bài này trả lời câu hỏi gì,
+kết luận/góc nhìn chính là gì, ai đọc thì thấy hữu ích nhất.
+```
+
+Không đặt tiêu đề trước khi biết rõ bài nói gì — tiêu đề hay nhưng sai nội dung chỉ làm người đọc thoát ngay.
+
+### Bước 2 — Sinh phương án theo từng dạng tiêu đề
+
+```text
+Dựa trên tóm tắt trên, hãy sinh 2 phương án tiêu đề cho mỗi dạng sau
+(tổng khoảng 10-12 phương án):
+
+1. Number/List — "X cách...", "X điều tôi học được..."
+2. How-to — "Cách để...", hướng dẫn từng bước
+3. Question — đặt đúng câu hỏi người đọc đang tự hỏi
+4. Reason-why — "Vì sao...", "Lý do..."
+5. Command — ra lệnh nhẹ, thúc giục hành động cụ thể
+6. Direct benefit — nói thẳng lợi ích, không vòng vo
+
+Mỗi phương án phải cụ thể với nội dung thật, không dùng khuôn chung chung.
+```
+
+### Bước 3 — Chấm điểm 4U
+
+```text
+Chấm từng phương án theo khung 4U (mỗi tiêu chí 5 điểm):
+
+U — Useful (Hữu ích):        [điểm]/5
+U — Urgent (Cấp thiết):      [điểm]/5
+U — Unique (Riêng biệt):     [điểm]/5
+U — Ultra-specific (Cụ thể): [điểm]/5
+
+Tổng: [điểm]/20
+
+Chỉ ra 2-3 phương án điểm cao nhất và giải thích vì sao — không chọn
+phương án chỉ vì nghe "kêu", phải đúng với nội dung thật của bài.
+```
+
+### Bước 4 — Chọn và tinh chỉnh
+
+```text
+Từ các phương án điểm cao, hãy tinh chỉnh 1 tiêu đề cuối cùng:
+- Ngắn gọn, đọc một lần hiểu ngay
+- Không dùng từ cường điệu ("tốt nhất", "duy nhất") nếu không có số liệu
+- Giữ giọng văn tự nhiên, không nghe như quảng cáo
+```
+
+---
+
+## Subcommand: `seo` — Tiêu đề cho bài SEO
+
+Dùng cùng `agent-seo`. Sinh phương án theo Bước 2-3 ở trên, sau đó lọc thêm theo rule SEO:
+
+```text
+Từ khoá chính cần giữ trong tiêu đề: [từ khoá]
+
+Áp thêm rule sau cho các phương án đã sinh:
+1. Title (thẻ SEO) chứa từ khoá chính, đọc tự nhiên, dưới 60 ký tự
+2. H1 trên trang có thể khác Title một chút để tự nhiên hơn, nhưng
+   vẫn phải chứa từ khoá chính
+3. Không nhồi từ khoá 2 lần trong cùng tiêu đề
+4. Không dùng tiêu đề dạng clickbait không trả lời được ngay trong bài —
+   Google và người đọc đều phạt nội dung "treo đầu dê bán thịt chó"
+5. Ưu tiên dạng How-to hoặc Question nếu từ khoá là dạng câu hỏi/hướng dẫn
+
+Đề xuất Title (thẻ SEO) và H1 riêng biệt nếu cần khác nhau, kèm lý do.
+```
+
+## Subcommand: `fbpost` — Câu mở/hook cho Facebook
+
+Dùng cùng `agent-fbpost`. Facebook không có ô "tiêu đề" riêng — câu đầu tiên đóng vai trò đó. Áp đúng nguyên tắc "giọng thật" đã có ở `agent-fbpost`, không phải công thức giật tít:
+
+```text
+Nội dung bài Facebook: [tóm tắt]
+Loại bài: buildinpublic hay launch?
+
+Hãy sinh 3 phương án câu mở đầu, mỗi phương án phải:
+1. Bắt đầu bằng một chuyện/quan sát/tín hiệu thật, không phải câu hỏi
+   giật kiểu "Bạn có biết..." hay tuyên bố kiểu "Đây là điều thị trường
+   cần từ lâu"
+2. Không hứa hẹn điều bài viết không trả lời được
+3. Đọc lên nghe như đang kể chuyện với một người, không như mở đầu quảng cáo
+
+Sau đó chấm mỗi phương án: có phải hook giả không (có/không) — loại bỏ
+ngay phương án nào "có". Không áp 4U ở đây, vì Urgent/Unique dễ biến
+thành giật tít trên Facebook.
+```
+
+Rule tham chiếu: xem `agent-fbpost/SKILL.md` mục "Subcommand: `check`" — câu mở vi phạm rule 1 (hook marketing) thì loại, bất kể điểm 4U cao thế nào.
+
+## Subcommand: `score` — Chấm tiêu đề có sẵn
+
+```text
+Tiêu đề tôi đang có: [tiêu đề]
+Kênh đăng: blog thường / SEO / Facebook
+
+Hãy chấm theo khung phù hợp kênh (4U cho blog, rule SEO cho SEO,
+kiểm tra hook giả cho Facebook) và chỉ ra 1-2 điểm cụ thể cần sửa.
+```
+
+---
+
+## Nguyên tắc chung
+
+- Tiêu đề phải đúng với nội dung thật bên trong — không đặt tiêu đề bài viết chưa trả lời được
+- Không dùng từ cường điệu ("tốt nhất", "số 1", "duy nhất") nếu không có số liệu đứng sau
+- SEO ưu tiên rõ ràng + từ khoá tự nhiên hơn là sáng tạo bằng mọi giá
+- Facebook ưu tiên giọng thật hơn là tỉ lệ click — hook giả đổi lấy click nhưng mất niềm tin
+- Sinh nhiều phương án trước khi chọn, không chốt phương án đầu tiên nghĩ ra
+
+## Files
+
+```
+agent-title/
+└── SKILL.md   — router + full flow + 2 subcommand theo kênh (file này)
+```