heraspec 0.1.13 → 0.1.15

package/dist/core/templates/skills/campaign-plan-skill.vi.md

@@ -0,0 +1,76 @@
+# Kỹ năng: Lập Kế hoạch Chiến dịch (Campaign Plan) (Cross-Cutting)
+
+## Mục đích
+
+Xây dựng bản kế hoạch chiến dịch marketing toàn diện bao gồm mục tiêu, đối tượng hướng đến, thông điệp cốt lõi, chiến lược kênh truyền thông theo tuần, lịch trình nội dung và các chỉ số đo lường thành công.
+
+## Khi nào sử dụng
+
+- Khi lên kế hoạch ra mắt sản phẩm mới, thúc đẩy thu hút khách hàng tiềm năng (lead generation) hoặc chiến dịch nhận diện thương hiệu.
+- Khi cần thiết lập lịch trình xuất bản nội dung hàng tuần có tính liên kết chặt chẽ giữa các tài nguyên.
+- Khi chuyển đổi các mục tiêu kinh doanh và marketing thành các nhiệm vụ cụ thể, có thể thực hiện được.
+
+## Quy trình từng bước
+
+### Bước 1: Xác định Mục tiêu & Đối tượng
+- Định hình các mục tiêu SMART (ví dụ: tạo 200 khách hàng tiềm năng MQL trong vòng 6 tuần).
+- Định nghĩa phân khúc khách hàng chính và phụ, các nỗi đau (pain points) của họ, và giai đoạn của họ trong hành trình mua hàng.
+
+### Bước 2: Định hình Thông điệp & Điểm khác biệt
+- Xây dựng một thông điệp chiến dịch cốt lõi và 3-4 thông điệp phụ bổ trợ, giải quyết trực tiếp nỗi đau của khách hàng.
+- Lựa chọn các bằng chứng thuyết phục (case study, dữ liệu thực tế, lời chứng thực) để củng cố thông điệp.
+
+### Bước 3: Chiến lược Kênh truyền thông
+- Lựa chọn các kênh truyền thông phù hợp với hành vi của đối tượng:
+  - Sở hữu (Owned - blog, email, mạng xã hội)
+  - Lan tỏa (Earned - PR, KOLs, bài viết đối tác)
+  - Trả phí (Paid - quảng cáo tìm kiếm, quảng cáo mạng xã hội, tài trợ)
+- Ước lượng mức độ công sức (thấp, trung bình, cao) và phân bổ ngân sách.
+
+### Bước 4: Lập Lịch Nội dung & Phân bổ Tài nguyên
+- Xây dựng lịch xuất bản nội dung theo tuần dưới dạng bảng.
+- Liệt kê toàn bộ các tài sản nội dung cần sản xuất kèm mức độ ưu tiên và thời hạn hoàn thành.
+
+### Bước 5: Chỉ số thành công & KPIs
+- Định nghĩa các KPIs chính và phụ.
+- Thiết lập cơ chế theo dõi số liệu và kế hoạch giảm thiểu rủi ro.
+
+## Input yêu cầu
+
+- **Mục tiêu Chiến dịch**: Tăng lượt đăng ký, ra mắt sản phẩm, thu hút leads, v.v...
+- **Đối tượng mục tiêu**: Vai trò, ngành nghề, các nỗi đau/vấn đề gặp phải.
+- **Mốc thời gian**: Thời lượng chiến dịch và các ngày ra mắt quan trọng.
+- **Ngân sách** (Không bắt buộc): Khoảng ngân sách quảng cáo trả phí.
+
+## Output mong đợi
+
+- **Tóm tắt điều hành**: Mô tả ngắn gọn về chiến dịch và mục tiêu đo lường chính.
+- **Hồ sơ đối tượng**: Tóm tắt 2-3 câu về chân dung người mua mục tiêu.
+- **Ma trận Thông điệp**: Thông điệp chính, các điểm bổ trợ và bằng chứng đi kèm.
+- **Bảng Lịch Nội dung**: Các cột gồm Tuần, Tài sản nội dung, Kênh truyền thông và Ghi chú.
+- **Bảng Chỉ số Đo lường**: Danh sách các KPIs, mục tiêu số lượng và phương pháp theo dõi.
+- **Checklist Các Bước Tiếp Theo**: Các nhiệm vụ cần thực hiện ngay để khởi động chiến dịch.
+
+## Giọng điệu & Quy tắc
+
+- Viết bằng giọng điệu chiến lược, cấu trúc rõ ràng và chuyên nghiệp.
+- Đảm bảo toàn bộ mục tiêu của chiến dịch tuân thủ đúng khung SMART.
+- Luôn thể hiện rõ sự phụ thuộc giữa các nội dung trong lịch xuất bản.
+
+## Templates có sẵn
+
+- Không có
+
+## Scripts có sẵn
+
+- Không có
+
+## Ví dụ
+
+Xem thư mục `examples/`.
+
+## Liên kết với các kỹ năng khác
+
+- **documents**: Dùng để viết tài liệu kế hoạch chiến dịch chính thức.
+- **content-creation**: Dùng để sản xuất nội dung chi tiết theo lịch trình chiến dịch.
+- **ui-ux**: Dùng để thiết kế trang landing page và các banner quảng cáo phục vụ chiến dịch.

package/dist/core/templates/skills/code-review/skill.md

@@ -0,0 +1,70 @@
+# Skill: Code Review (Cross-Cutting)
+
+## Purpose
+
+Review code changes for security vulnerabilities, performance bottlenecks, correctness, and maintainability.
+
+## When to Use
+
+- When reviewing a pull request or code diff
+- When checking a code change before merging
+- When verifying security practices (OWASP Top 10, SQL injection, secrets in code)
+- When auditing code performance (N+1 queries, complexity, memory leaks)
+
+## Step-by-Step Process
+
+### Step 1: Security Audit
+- Check for OWASP Top 10 vulnerabilities (SQL injection, XSS, CSRF, etc.)
+- Look for secrets, API keys, or hardcoded credentials
+- Verify authentication and authorization checks
+
+### Step 2: Performance Evaluation
+- Identify N+1 query problems in database interactions
+- Look for memory leaks or high memory allocation loops
+- Verify algorithmic complexity in critical code paths
+
+### Step 3: Correctness Check
+- Review edge cases (null values, empty strings, boundary conditions)
+- Verify error handling and propagation patterns
+- Identify race conditions or concurrency issues
+
+### Step 4: Maintainability Review
+- Check variable/function naming for clarity
+- Ensure single-responsibility principle is followed
+- Check for code duplication and readability
+
+## Required Input
+
+- Code diff, PR URL, or source files
+- Context on performance constraints or security requirements
+
+## Expected Output
+
+- Code review report containing:
+  - Overall summary
+  - Critical security/correctness issues with severity levels
+  - Actionable improvement suggestions
+  - Praise for well-written code
+
+## Tone & Rules
+
+- Be constructive and focus on the code, not the developer.
+- Provide concrete code examples when suggesting improvements.
+- Explicitly state trade-offs (e.g. readability vs. performance).
+
+## Available Templates
+
+- None
+
+## Available Scripts
+
+- None
+
+## Examples
+
+See `examples/` directory.
+
+## Links to Other Skills
+
+- **unit-test**: Use to write test cases for edge cases identified during review.
+- **sourcecode-analyzer**: Use for automated static code analysis.

package/dist/core/templates/skills/code-review/skill.vi.md

@@ -0,0 +1,70 @@
+# Kỹ năng: Đánh giá Code (Code Review) (Cross-Cutting)
+
+## Mục đích
+
+Đánh giá các thay đổi trong mã nguồn để phát hiện lỗ hổng bảo mật, thắt nút cổ chai hiệu năng, tính chính xác và khả năng bảo trì.
+
+## Khi nào sử dụng
+
+- Khi đánh giá pull request hoặc code diff
+- Khi kiểm tra mã nguồn trước khi merge
+- Khi xác minh các tiêu chuẩn bảo mật (OWASP Top 10, SQL injection, lộ lọt secrets)
+- Khi kiểm toán hiệu năng (truy vấn N+1, rò rỉ bộ nhớ, độ phức tạp thuật toán)
+
+## Quy trình từng bước
+
+### Bước 1: Kiểm toán Bảo mật
+- Kiểm tra các lỗi bảo mật thuộc OWASP Top 10 (SQL injection, XSS, CSRF,...)
+- Tìm kiếm các chuỗi khóa bí mật, API keys hoặc thông tin đăng nhập bị hardcode
+- Xác minh các bước kiểm tra xác thực và phân quyền
+
+### Bước 2: Đánh giá Hiệu năng
+- Phát hiện các vấn đề truy vấn N+1 khi tương tác với database
+- Tìm kiếm rò rỉ bộ nhớ hoặc các vòng lặp cấp phát bộ nhớ quá lớn
+- Xác minh độ phức tạp thuật toán trong các luồng xử lý quan trọng
+
+### Bước 3: Kiểm tra Tính chính xác
+- Đánh giá các trường hợp biên (giá trị null, chuỗi rỗng, giá trị giới hạn)
+- Xác minh cơ chế xử lý lỗi và truyền lỗi (error propagation)
+- Phát hiện các lỗi bất đồng bộ (race conditions, concurrency)
+
+### Bước 4: Đánh giá Khả năng bảo trì
+- Kiểm tra cách đặt tên biến/hàm xem đã rõ ràng chưa
+- Đảm bảo tuân thủ nguyên tắc đơn nhiệm (Single Responsibility Principle)
+- Kiểm tra trùng lặp mã nguồn và độ dễ đọc của code
+
+## Input yêu cầu
+
+- Code diff, PR URL hoặc các file mã nguồn cần review
+- Ngữ cảnh về các ràng buộc hiệu năng hoặc yêu cầu bảo mật đặc thù
+
+## Output mong đợi
+
+- Báo cáo review code bao gồm:
+  - Tóm tắt tổng quan về chất lượng
+  - Danh sách lỗi nghiêm trọng kèm mức độ nghiêm trọng
+  - Đề xuất cải tiến có thể thực thi kèm code mẫu
+  - Đánh giá các điểm viết tốt
+
+## Giọng điệu & Quy tắc
+
+- Đưa ra phản hồi mang tính xây dựng, tập trung vào code thay vì nhà phát triển.
+- Cung cấp ví dụ code thực tế khi đề xuất cải tiến.
+- Làm rõ các yếu tố đánh đổi (ví dụ: độ dễ đọc vs. hiệu năng tối ưu).
+
+## Templates có sẵn
+
+- Không có
+
+## Scripts có sẵn
+
+- Không có
+
+## Ví dụ
+
+Xem thư mục `examples/`.
+
+## Liên kết với các kỹ năng khác
+
+- **unit-test**: Dùng để viết test cases cho các trường hợp biên được phát hiện khi review.
+- **sourcecode-analyzer**: Dùng để phân tích tĩnh mã nguồn tự động.

package/dist/core/templates/skills/code-review-skill.md

@@ -0,0 +1,70 @@
+# Skill: Code Review (Cross-Cutting)
+
+## Purpose
+
+Review code changes for security vulnerabilities, performance bottlenecks, correctness, and maintainability.
+
+## When to Use
+
+- When reviewing a pull request or code diff
+- When checking a code change before merging
+- When verifying security practices (OWASP Top 10, SQL injection, secrets in code)
+- When auditing code performance (N+1 queries, complexity, memory leaks)
+
+## Step-by-Step Process
+
+### Step 1: Security Audit
+- Check for OWASP Top 10 vulnerabilities (SQL injection, XSS, CSRF, etc.)
+- Look for secrets, API keys, or hardcoded credentials
+- Verify authentication and authorization checks
+
+### Step 2: Performance Evaluation
+- Identify N+1 query problems in database interactions
+- Look for memory leaks or high memory allocation loops
+- Verify algorithmic complexity in critical code paths
+
+### Step 3: Correctness Check
+- Review edge cases (null values, empty strings, boundary conditions)
+- Verify error handling and propagation patterns
+- Identify race conditions or concurrency issues
+
+### Step 4: Maintainability Review
+- Check variable/function naming for clarity
+- Ensure single-responsibility principle is followed
+- Check for code duplication and readability
+
+## Required Input
+
+- Code diff, PR URL, or source files
+- Context on performance constraints or security requirements
+
+## Expected Output
+
+- Code review report containing:
+  - Overall summary
+  - Critical security/correctness issues with severity levels
+  - Actionable improvement suggestions
+  - Praise for well-written code
+
+## Tone & Rules
+
+- Be constructive and focus on the code, not the developer.
+- Provide concrete code examples when suggesting improvements.
+- Explicitly state trade-offs (e.g. readability vs. performance).
+
+## Available Templates
+
+- None
+
+## Available Scripts
+
+- None
+
+## Examples
+
+See `examples/` directory.
+
+## Links to Other Skills
+
+- **unit-test**: Use to write test cases for edge cases identified during review.
+- **sourcecode-analyzer**: Use for automated static code analysis.

package/dist/core/templates/skills/code-review-skill.vi.md

@@ -0,0 +1,70 @@
+# Kỹ năng: Đánh giá Code (Code Review) (Cross-Cutting)
+
+## Mục đích
+
+Đánh giá các thay đổi trong mã nguồn để phát hiện lỗ hổng bảo mật, thắt nút cổ chai hiệu năng, tính chính xác và khả năng bảo trì.
+
+## Khi nào sử dụng
+
+- Khi đánh giá pull request hoặc code diff
+- Khi kiểm tra mã nguồn trước khi merge
+- Khi xác minh các tiêu chuẩn bảo mật (OWASP Top 10, SQL injection, lộ lọt secrets)
+- Khi kiểm toán hiệu năng (truy vấn N+1, rò rỉ bộ nhớ, độ phức tạp thuật toán)
+
+## Quy trình từng bước
+
+### Bước 1: Kiểm toán Bảo mật
+- Kiểm tra các lỗi bảo mật thuộc OWASP Top 10 (SQL injection, XSS, CSRF,...)
+- Tìm kiếm các chuỗi khóa bí mật, API keys hoặc thông tin đăng nhập bị hardcode
+- Xác minh các bước kiểm tra xác thực và phân quyền
+
+### Bước 2: Đánh giá Hiệu năng
+- Phát hiện các vấn đề truy vấn N+1 khi tương tác với database
+- Tìm kiếm rò rỉ bộ nhớ hoặc các vòng lặp cấp phát bộ nhớ quá lớn
+- Xác minh độ phức tạp thuật toán trong các luồng xử lý quan trọng
+
+### Bước 3: Kiểm tra Tính chính xác
+- Đánh giá các trường hợp biên (giá trị null, chuỗi rỗng, giá trị giới hạn)
+- Xác minh cơ chế xử lý lỗi và truyền lỗi (error propagation)
+- Phát hiện các lỗi bất đồng bộ (race conditions, concurrency)
+
+### Bước 4: Đánh giá Khả năng bảo trì
+- Kiểm tra cách đặt tên biến/hàm xem đã rõ ràng chưa
+- Đảm bảo tuân thủ nguyên tắc đơn nhiệm (Single Responsibility Principle)
+- Kiểm tra trùng lặp mã nguồn và độ dễ đọc của code
+
+## Input yêu cầu
+
+- Code diff, PR URL hoặc các file mã nguồn cần review
+- Ngữ cảnh về các ràng buộc hiệu năng hoặc yêu cầu bảo mật đặc thù
+
+## Output mong đợi
+
+- Báo cáo review code bao gồm:
+  - Tóm tắt tổng quan về chất lượng
+  - Danh sách lỗi nghiêm trọng kèm mức độ nghiêm trọng
+  - Đề xuất cải tiến có thể thực thi kèm code mẫu
+  - Đánh giá các điểm viết tốt
+
+## Giọng điệu & Quy tắc
+
+- Đưa ra phản hồi mang tính xây dựng, tập trung vào code thay vì nhà phát triển.
+- Cung cấp ví dụ code thực tế khi đề xuất cải tiến.
+- Làm rõ các yếu tố đánh đổi (ví dụ: độ dễ đọc vs. hiệu năng tối ưu).
+
+## Templates có sẵn
+
+- Không có
+
+## Scripts có sẵn
+
+- Không có
+
+## Ví dụ
+
+Xem thư mục `examples/`.
+
+## Liên kết với các kỹ năng khác
+
+- **unit-test**: Dùng để viết test cases cho các trường hợp biên được phát hiện khi review.
+- **sourcecode-analyzer**: Dùng để phân tích tĩnh mã nguồn tự động.

package/dist/core/templates/skills/content-creation/skill.md

@@ -0,0 +1,69 @@
+# Skill: Content Creation (Cross-Cutting)
+
+## Purpose
+
+Draft high-converting marketing copy and content assets across multiple channels — blog posts, social media, email newsletters, landing pages, case studies, and press releases.
+
+## When to Use
+
+- When writing or editing copy for digital marketing channels.
+- When you need specific structural guidelines for a blog, newsletter, case study, or landing page.
+- When optimizing content for SEO (keyword placement, headers, metadata).
+
+## Step-by-Step Process
+
+### Step 1: Research & Intent Alignment
+- Identify the target audience, channel constraints, and the single call to action (CTA).
+- Define the primary keyword and 2-3 secondary keywords if SEO is required.
+
+### Step 2: Select the Structural Template
+- Use the channel-specific structure (e.g., Blog: Headline -> Intro -> Body H2s -> Conclusion -> Meta; Social: Hook -> Body -> CTA -> Hashtags).
+
+### Step 3: Draft the Copy
+- Write benefit-first copy using active voice. Keep reading level appropriate (e.g., 8th-grade level for general public).
+- Maintain scannability with short paragraphs, subheadings, and bullet points.
+
+### Step 4: Integrate SEO & CTA
+- Insert primary keyword naturally in critical locations (headline, first 100 words, one H2, meta).
+- Build a compelling, action-oriented CTA with low-friction text (e.g., "Start your free trial" instead of "Submit").
+
+### Step 5: Proofread & Optimize
+- Review against the channel checklist (e.g., email subject line length, mobile readability).
+
+## Required Input
+
+- **Content Type**: Blog post, email newsletter, social post, landing page copy, case study, etc.
+- **Goal/CTA**: The action you want the reader to take.
+- **Audience**: Demographics, pain points.
+- **Target Keywords** (Optional): Primary and secondary keywords.
+
+## Expected Output
+
+- **Copy Outline**: Brief breakdown of sections and metadata.
+- **Full Written Draft**: Copy-paste ready markdown draft including headlines, body, subheadings, and CTAs.
+- **Headline Variations**: 3-5 headline options using proven formulas.
+- **Meta Fields**: Title tags and meta descriptions (if web/blog).
+
+## Tone & Rules
+
+- Write in an engaging, benefit-driven, and audience-appropriate tone.
+- Avoid passive voice, corporate jargon, and generic filler sentences.
+- Limit paragraph lengths to 2-4 sentences max for digital readability.
+
+## Available Templates
+
+- None
+
+## Available Scripts
+
+- None
+
+## Examples
+
+See `examples/` directory.
+
+## Links to Other Skills
+
+- **seo-audit**: Use keyword recommendations from the audit to write SEO-optimized content.
+- **documents**: Use to format large-scale guides or technical whitepapers.
+- **ui-ux**: Use to align landing page copy layout with visual hierarchy rules.

package/dist/core/templates/skills/content-creation/skill.vi.md

@@ -0,0 +1,69 @@
+# Kỹ năng: Sáng tạo Nội dung (Content Creation) (Cross-Cutting)
+
+## Mục đích
+
+Soạn thảo nội dung và văn bản quảng cáo (copywriting) có tỷ lệ chuyển đổi cao trên nhiều kênh truyền thông — bài viết blog, mạng xã hội, email newsletter, trang landing page, case study và thông cáo báo chí.
+
+## Khi nào sử dụng
+
+- Khi viết hoặc chỉnh sửa bài viết cho các kênh marketing kỹ thuật số.
+- Khi cần các quy chuẩn cấu trúc cụ thể cho một bài blog, bản tin email, case study hoặc trang landing page.
+- Khi cần tối ưu hóa bài viết chuẩn SEO (phân bổ từ khóa, các thẻ tiêu đề, mô tả meta).
+
+## Quy trình từng bước
+
+### Bước 1: Nghiên cứu & Định hướng Ý định
+- Xác định rõ đối tượng mục tiêu, các ràng buộc của kênh truyền thông và nút kêu gọi hành động (CTA) duy nhất.
+- Xác định từ khóa chính và 2-3 từ khóa phụ nếu nội dung yêu cầu chuẩn SEO.
+
+### Bước 2: Lựa chọn Cấu trúc Mẫu phù hợp
+- Sử dụng cấu trúc riêng của từng kênh (Ví dụ: Blog: Tiêu đề -> Mở bài -> Thân bài với các thẻ H2 -> Kết luận -> Mô tả Meta; Mạng xã hội: Mở đầu thu hút (Hook) -> Thân bài -> Kêu gọi hành động (CTA) -> Hashtags).
+
+### Bước 3: Soạn thảo Nội dung
+- Viết tập trung vào lợi ích của khách hàng thay vì tính năng, sử dụng thể chủ động. Giữ mức độ ngôn ngữ phù hợp, dễ hiểu cho đại chúng.
+- Tăng tính dễ đọc bằng cách ngắt các đoạn ngắn, sử dụng các tiêu đề phụ và danh sách liệt kê.
+
+### Bước 4: Tích hợp SEO & CTA
+- Chèn từ khóa chính một cách tự nhiên vào các vị trí quan trọng (tiêu đề, 100 từ đầu tiên, một thẻ H2, mô tả meta).
+- Xây dựng CTA hấp dẫn, thúc đẩy hành động với văn bản đơn giản, giảm thiểu rào cản (ví dụ: "Bắt đầu dùng thử miễn phí" thay vì "Gửi đi").
+
+### Bước 5: Kiểm tra & Tối ưu hóa
+- Đối chiếu lại với checklist của từng kênh (ví dụ: độ dài tiêu đề email, khả năng hiển thị tốt trên thiết bị di động).
+
+## Input yêu cầu
+
+- **Loại nội dung**: Bài viết blog, newsletter, social post, nội dung landing page, case study, v.v...
+- **Mục tiêu/CTA**: Hành động cụ thể bạn muốn người đọc thực hiện.
+- **Đối tượng độc giả**: Chân dung, các vấn đề nỗi đau của họ.
+- **Từ khóa mục tiêu** (Không bắt buộc): Các từ khóa chính và phụ cần tối ưu.
+
+## Output mong đợi
+
+- **Dàn ý nội dung**: Sắp xếp sơ bộ các phần và siêu dữ liệu (metadata).
+- **Bản thảo chi tiết**: Bài viết hoàn chỉnh định dạng markdown sẵn sàng copy-paste, bao gồm tiêu đề, thân bài, tiêu đề phụ và CTAs.
+- **Các phương án Tiêu đề**: 3-5 tiêu đề mẫu sử dụng các công thức đã được chứng minh hiệu quả.
+- **Các trường Meta**: Thẻ tiêu đề trang và thẻ mô tả meta (nếu đăng web/blog).
+
+## Giọng điệu & Quy tắc
+
+- Viết bằng giọng điệu lôi cuốn, tập trung vào lợi ích khách hàng và phù hợp với nhóm độc giả.
+- Tránh sử dụng thể bị động, thuật ngữ chuyên ngành quá phức tạp và các câu sáo rỗng.
+- Giới hạn độ dài mỗi đoạn từ 2-4 câu để tối ưu trải nghiệm đọc trên màn hình điện thoại/máy tính.
+
+## Templates có sẵn
+
+- Không có
+
+## Scripts có sẵn
+
+- Không có
+
+## Ví dụ
+
+Xem thư mục `examples/`.
+
+## Liên kết với các kỹ năng khác
+
+- **seo-audit**: Sử dụng danh sách từ khóa gợi ý từ kiểm toán SEO để viết bài viết chuẩn SEO.
+- **documents**: Dùng khi viết các hướng dẫn quy mô lớn hoặc sách trắng (whitepapers) kỹ thuật.
+- **ui-ux**: Dùng để phối hợp cấu trúc văn bản landing page khớp với phân cấp thị giác trên trang web.

package/dist/core/templates/skills/content-creation-skill.md

@@ -0,0 +1,69 @@
+# Skill: Content Creation (Cross-Cutting)
+
+## Purpose
+
+Draft high-converting marketing copy and content assets across multiple channels — blog posts, social media, email newsletters, landing pages, case studies, and press releases.
+
+## When to Use
+
+- When writing or editing copy for digital marketing channels.
+- When you need specific structural guidelines for a blog, newsletter, case study, or landing page.
+- When optimizing content for SEO (keyword placement, headers, metadata).
+
+## Step-by-Step Process
+
+### Step 1: Research & Intent Alignment
+- Identify the target audience, channel constraints, and the single call to action (CTA).
+- Define the primary keyword and 2-3 secondary keywords if SEO is required.
+
+### Step 2: Select the Structural Template
+- Use the channel-specific structure (e.g., Blog: Headline -> Intro -> Body H2s -> Conclusion -> Meta; Social: Hook -> Body -> CTA -> Hashtags).
+
+### Step 3: Draft the Copy
+- Write benefit-first copy using active voice. Keep reading level appropriate (e.g., 8th-grade level for general public).
+- Maintain scannability with short paragraphs, subheadings, and bullet points.
+
+### Step 4: Integrate SEO & CTA
+- Insert primary keyword naturally in critical locations (headline, first 100 words, one H2, meta).
+- Build a compelling, action-oriented CTA with low-friction text (e.g., "Start your free trial" instead of "Submit").
+
+### Step 5: Proofread & Optimize
+- Review against the channel checklist (e.g., email subject line length, mobile readability).
+
+## Required Input
+
+- **Content Type**: Blog post, email newsletter, social post, landing page copy, case study, etc.
+- **Goal/CTA**: The action you want the reader to take.
+- **Audience**: Demographics, pain points.
+- **Target Keywords** (Optional): Primary and secondary keywords.
+
+## Expected Output
+
+- **Copy Outline**: Brief breakdown of sections and metadata.
+- **Full Written Draft**: Copy-paste ready markdown draft including headlines, body, subheadings, and CTAs.
+- **Headline Variations**: 3-5 headline options using proven formulas.
+- **Meta Fields**: Title tags and meta descriptions (if web/blog).
+
+## Tone & Rules
+
+- Write in an engaging, benefit-driven, and audience-appropriate tone.
+- Avoid passive voice, corporate jargon, and generic filler sentences.
+- Limit paragraph lengths to 2-4 sentences max for digital readability.
+
+## Available Templates
+
+- None
+
+## Available Scripts
+
+- None
+
+## Examples
+
+See `examples/` directory.
+
+## Links to Other Skills
+
+- **seo-audit**: Use keyword recommendations from the audit to write SEO-optimized content.
+- **documents**: Use to format large-scale guides or technical whitepapers.
+- **ui-ux**: Use to align landing page copy layout with visual hierarchy rules.

package/dist/core/templates/skills/content-creation-skill.vi.md

@@ -0,0 +1,69 @@
+# Kỹ năng: Sáng tạo Nội dung (Content Creation) (Cross-Cutting)
+
+## Mục đích
+
+Soạn thảo nội dung và văn bản quảng cáo (copywriting) có tỷ lệ chuyển đổi cao trên nhiều kênh truyền thông — bài viết blog, mạng xã hội, email newsletter, trang landing page, case study và thông cáo báo chí.
+
+## Khi nào sử dụng
+
+- Khi viết hoặc chỉnh sửa bài viết cho các kênh marketing kỹ thuật số.
+- Khi cần các quy chuẩn cấu trúc cụ thể cho một bài blog, bản tin email, case study hoặc trang landing page.
+- Khi cần tối ưu hóa bài viết chuẩn SEO (phân bổ từ khóa, các thẻ tiêu đề, mô tả meta).
+
+## Quy trình từng bước
+
+### Bước 1: Nghiên cứu & Định hướng Ý định
+- Xác định rõ đối tượng mục tiêu, các ràng buộc của kênh truyền thông và nút kêu gọi hành động (CTA) duy nhất.
+- Xác định từ khóa chính và 2-3 từ khóa phụ nếu nội dung yêu cầu chuẩn SEO.
+
+### Bước 2: Lựa chọn Cấu trúc Mẫu phù hợp
+- Sử dụng cấu trúc riêng của từng kênh (Ví dụ: Blog: Tiêu đề -> Mở bài -> Thân bài với các thẻ H2 -> Kết luận -> Mô tả Meta; Mạng xã hội: Mở đầu thu hút (Hook) -> Thân bài -> Kêu gọi hành động (CTA) -> Hashtags).
+
+### Bước 3: Soạn thảo Nội dung
+- Viết tập trung vào lợi ích của khách hàng thay vì tính năng, sử dụng thể chủ động. Giữ mức độ ngôn ngữ phù hợp, dễ hiểu cho đại chúng.
+- Tăng tính dễ đọc bằng cách ngắt các đoạn ngắn, sử dụng các tiêu đề phụ và danh sách liệt kê.
+
+### Bước 4: Tích hợp SEO & CTA
+- Chèn từ khóa chính một cách tự nhiên vào các vị trí quan trọng (tiêu đề, 100 từ đầu tiên, một thẻ H2, mô tả meta).
+- Xây dựng CTA hấp dẫn, thúc đẩy hành động với văn bản đơn giản, giảm thiểu rào cản (ví dụ: "Bắt đầu dùng thử miễn phí" thay vì "Gửi đi").
+
+### Bước 5: Kiểm tra & Tối ưu hóa
+- Đối chiếu lại với checklist của từng kênh (ví dụ: độ dài tiêu đề email, khả năng hiển thị tốt trên thiết bị di động).
+
+## Input yêu cầu
+
+- **Loại nội dung**: Bài viết blog, newsletter, social post, nội dung landing page, case study, v.v...
+- **Mục tiêu/CTA**: Hành động cụ thể bạn muốn người đọc thực hiện.
+- **Đối tượng độc giả**: Chân dung, các vấn đề nỗi đau của họ.
+- **Từ khóa mục tiêu** (Không bắt buộc): Các từ khóa chính và phụ cần tối ưu.
+
+## Output mong đợi
+
+- **Dàn ý nội dung**: Sắp xếp sơ bộ các phần và siêu dữ liệu (metadata).
+- **Bản thảo chi tiết**: Bài viết hoàn chỉnh định dạng markdown sẵn sàng copy-paste, bao gồm tiêu đề, thân bài, tiêu đề phụ và CTAs.
+- **Các phương án Tiêu đề**: 3-5 tiêu đề mẫu sử dụng các công thức đã được chứng minh hiệu quả.
+- **Các trường Meta**: Thẻ tiêu đề trang và thẻ mô tả meta (nếu đăng web/blog).
+
+## Giọng điệu & Quy tắc
+
+- Viết bằng giọng điệu lôi cuốn, tập trung vào lợi ích khách hàng và phù hợp với nhóm độc giả.
+- Tránh sử dụng thể bị động, thuật ngữ chuyên ngành quá phức tạp và các câu sáo rỗng.
+- Giới hạn độ dài mỗi đoạn từ 2-4 câu để tối ưu trải nghiệm đọc trên màn hình điện thoại/máy tính.
+
+## Templates có sẵn
+
+- Không có
+
+## Scripts có sẵn
+
+- Không có
+
+## Ví dụ
+
+Xem thư mục `examples/`.
+
+## Liên kết với các kỹ năng khác
+
+- **seo-audit**: Sử dụng danh sách từ khóa gợi ý từ kiểm toán SEO để viết bài viết chuẩn SEO.
+- **documents**: Dùng khi viết các hướng dẫn quy mô lớn hoặc sách trắng (whitepapers) kỹ thuật.
+- **ui-ux**: Dùng để phối hợp cấu trúc văn bản landing page khớp với phân cấp thị giác trên trang web.