heraspec 0.1.14 → 0.1.15

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.

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

@@ -0,0 +1,104 @@
+# Skill: Content Optimization (Cross-Cutting)
+
+## Purpose
+
+This skill is used to optimize content and increase CTA (Call-to-Action) conversion for the product/module being developed. Focus on conversion optimization and user engagement.
+
+## When to Use
+
+- When creating landing pages
+- When designing CTA buttons
+- When writing marketing content
+- When optimizing email campaigns
+- When needing to increase conversion rates
+
+## Step-by-Step Process
+
+### Step 1: Analyze Goals
+- Identify conversion goal (signup, purchase, download, etc.)
+- Identify target audience
+- Identify value proposition
+- Research competitors
+
+### Step 2: Create Content Variants
+- Use template: `templates/cta-template.md`
+- Use template: `templates/landing-page-template.md`
+- Create multiple variants for A/B testing
+- Run script: `scripts/generate-ab-test-variants.sh`
+
+### Step 3: Optimize CTA Placement
+- Above the fold for primary CTA
+- Multiple CTAs for long pages
+- Exit-intent CTAs
+- Follow good examples in `examples/high-conversion-cta/`
+
+### Step 4: Test & Measure
+- Setup A/B testing
+- Run script: `scripts/analyze-cta-performance.py`
+- Measure conversion rates
+- Track user behavior
+
+### Step 5: Iterate
+- Analyze results
+- Optimize based on data
+- Test new variants
+- Continuously improve
+
+## Required Input
+
+- **Conversion goal**: Signup, purchase, download, etc.
+- **Target audience**: Demographics, interests, pain points
+- **Value proposition**: Unique selling points
+- **Current conversion rate**: Baseline for comparison
+- **Content type**: Landing page, email, banner, etc.
+
+## Expected Output
+
+- Optimized content with clear CTAs
+- Multiple variants for A/B testing
+- Performance metrics and analysis
+- Recommendations for improvement
+
+## Tone & Rules
+
+### Content Principles
+- **Clear value**: Clear value proposition
+- **Urgency**: Create sense of urgency (if appropriate)
+- **Benefit-focused**: Focus on benefits, not just features
+- **Action-oriented**: Language that stimulates action
+
+### CTA Best Practices
+- Action verbs: "Get Started", "Download Now", "Try Free"
+- Clear and specific
+- Visually prominent
+- Above the fold
+- Mobile-friendly
+
+### Limitations
+- ❌ DO NOT use misleading claims
+- ❌ DO NOT create too many CTAs (confusion)
+- ❌ DO NOT ignore mobile experience
+- ❌ DO NOT skip loading speed
+- ❌ DO NOT test without measuring
+
+## Available Templates
+
+- `templates/cta-template.md` - CTA template
+- `templates/landing-page-template.md` - Landing page template
+- `templates/email-campaign-template.md` - Email marketing template
+
+## Available Scripts
+
+- `scripts/analyze-cta-performance.py` - Analyze CTA performance
+- `scripts/generate-ab-test-variants.sh` - Generate variants for A/B testing
+
+## Examples
+
+See `examples/` directory for reference:
+- `high-conversion-cta/` - Effective CTA (high conversion)
+- `low-conversion-cta/` - CTA that needs improvement (low conversion)
+
+## Links to Other Skills
+
+- **ui-ux**: Use to style CTAs and optimize visual hierarchy
+- **documents**: Use to document conversion strategies

package/dist/core/templates/skills/debug/skill.md

@@ -0,0 +1,69 @@
+# Skill: Debugging (Cross-Cutting)
+
+## Purpose
+
+Run a structured debugging session to systematically reproduce, isolate, diagnose, and fix software bugs.
+
+## When to Use
+
+- When encountering a stack trace, runtime exception, or error message
+- When system behavior diverges from the specifications
+- When a bug is reported in staging or production but cannot be easily explained
+
+## Step-by-Step Process
+
+### Step 1: Reproduce
+- Identify expected vs. actual behavior
+- Define the exact, minimal reproduction steps
+- Determine the scope of the bug (who is affected, when did it start)
+
+### Step 2: Isolate
+- Narrow down the component, module, or code path causing the issue
+- Analyze logs, error outputs, or recent commit histories
+- Check for recent configuration changes or dependency updates
+
+### Step 3: Diagnose
+- Formulate testable hypotheses and trace variables/data flow
+- Determine the root cause of the failure (not just the symptom)
+
+### Step 4: Fix & Prevent
+- Propose and implement a precise code fix
+- Analyze side effects and edge cases introduced by the fix
+- Outline regression test strategies to prevent the issue from reoccurring
+
+## Required Input
+
+- Error message, stack trace, or problem description
+- Reproduction steps (or environment details)
+- Access to relevant logs or code components
+
+## Expected Output
+
+- Debug report containing:
+  - Reproduction (Expected vs. Actual)
+  - Root cause analysis
+  - Code changes or fixes applied
+  - Prevention plan (regression tests to add)
+
+## Tone & Rules
+
+- Debug systematically. Do not guess fixes blindly.
+- Document code constraints and why the fix works.
+- Keep fixes focused; avoid refactoring unrelated components during a bugfix.
+
+## Available Templates
+
+- None
+
+## Available Scripts
+
+- None
+
+## Examples
+
+See `examples/` directory.
+
+## Links to Other Skills
+
+- **unit-test**: Use to write regression tests for the fixed bug.
+- **project-memory**: Use to search for historical bug fixes or related issues.

package/dist/core/templates/skills/debug/skill.vi.md

@@ -0,0 +1,69 @@
+# Kỹ năng: Sửa lỗi (Debugging) (Cross-Cutting)
+
+## Mục đích
+
+Thực hiện một phiên debug có cấu trúc để tái dựng (reproduce), cô lập (isolate), chẩn đoán (diagnose) và sửa lỗi phần mềm một cách hệ thống.
+
+## Khi nào sử dụng
+
+- Khi gặp stack trace, biệt lệ thời gian chạy (runtime exception) hoặc thông báo lỗi
+- Khi hành vi của hệ thống khác biệt so với đặc tả kỹ thuật (specs)
+- Khi phát hiện lỗi trên môi trường staging hoặc production nhưng chưa rõ nguyên nhân
+
+## Quy trình từng bước
+
+### Bước 1: Tái dựng lỗi (Reproduce)
+- Xác định hành vi mong đợi (Expected) vs. hành vi thực tế (Actual)
+- Xác định các bước tối giản để tái dựng lỗi một cách chính xác
+- Đánh giá phạm vi của lỗi (ai bị ảnh hưởng, lỗi bắt đầu từ khi nào)
+
+### Bước 2: Cô lập lỗi (Isolate)
+- Thu hẹp phạm vi tìm kiếm vào component, module hoặc luồng code gây lỗi
+- Phân tích log, lỗi đầu ra hoặc lịch sử các commit gần đây
+- Kiểm tra các thay đổi cấu hình hoặc cập nhật thư viện gần đây
+
+### Bước 3: Chẩn đoán lỗi (Diagnose)
+- Đưa ra giả thuyết có thể kiểm chứng và trace luồng dữ liệu/biến số
+- Xác định nguyên nhân gốc rễ (root cause) thay vì chỉ xử lý triệu chứng bề nổi
+
+### Bước 4: Sửa lỗi & Ngăn ngừa (Fix & Prevent)
+- Đề xuất và triển khai giải pháp sửa lỗi code chính xác
+- Phân tích các tác dụng phụ và trường hợp biên phát sinh từ bản sửa lỗi
+- Xây dựng chiến lược test hồi quy (regression tests) để ngăn ngừa lỗi lặp lại
+
+## Input yêu cầu
+
+- Thông báo lỗi, stack trace hoặc mô tả chi tiết lỗi
+- Các bước tái dựng lỗi (hoặc thông tin môi trường chạy thử)
+- Quyền truy cập vào file log hoặc các component liên quan
+
+## Output mong đợi
+
+- Báo cáo sửa lỗi (Debug Report) bao gồm:
+  - Tái dựng lỗi (Mong đợi vs. Thực tế)
+  - Phân tích nguyên nhân gốc rễ (Root Cause)
+  - Giải pháp sửa lỗi đã áp dụng
+  - Kế hoạch ngăn ngừa (test hồi quy cần bổ sung)
+
+## Giọng điệu & Quy tắc
+
+- Thực hiện debug một cách hệ thống. Không đoán mò giải pháp một cách mù quáng.
+- Tài liệu hóa các ràng buộc của code và lý do tại sao giải pháp sửa lỗi hoạt động hiệu quả.
+- Tập trung vào bản sửa lỗi; tránh refactor các phần code không liên quan trong khi sửa lỗi.
+
+## 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 hồi quy cho lỗi vừa sửa.
+- **project-memory**: Dùng để tìm kiếm các bản sửa lỗi lịch sử hoặc vấn đề liên quan.

package/dist/core/templates/skills/debug-skill.md

@@ -0,0 +1,69 @@
+# Skill: Debugging (Cross-Cutting)
+
+## Purpose
+
+Run a structured debugging session to systematically reproduce, isolate, diagnose, and fix software bugs.
+
+## When to Use
+
+- When encountering a stack trace, runtime exception, or error message
+- When system behavior diverges from the specifications
+- When a bug is reported in staging or production but cannot be easily explained
+
+## Step-by-Step Process
+
+### Step 1: Reproduce
+- Identify expected vs. actual behavior
+- Define the exact, minimal reproduction steps
+- Determine the scope of the bug (who is affected, when did it start)
+
+### Step 2: Isolate
+- Narrow down the component, module, or code path causing the issue
+- Analyze logs, error outputs, or recent commit histories
+- Check for recent configuration changes or dependency updates
+
+### Step 3: Diagnose
+- Formulate testable hypotheses and trace variables/data flow
+- Determine the root cause of the failure (not just the symptom)
+
+### Step 4: Fix & Prevent
+- Propose and implement a precise code fix
+- Analyze side effects and edge cases introduced by the fix
+- Outline regression test strategies to prevent the issue from reoccurring
+
+## Required Input
+
+- Error message, stack trace, or problem description
+- Reproduction steps (or environment details)
+- Access to relevant logs or code components
+
+## Expected Output
+
+- Debug report containing:
+  - Reproduction (Expected vs. Actual)
+  - Root cause analysis
+  - Code changes or fixes applied
+  - Prevention plan (regression tests to add)
+
+## Tone & Rules
+
+- Debug systematically. Do not guess fixes blindly.
+- Document code constraints and why the fix works.
+- Keep fixes focused; avoid refactoring unrelated components during a bugfix.
+
+## Available Templates
+
+- None
+
+## Available Scripts
+
+- None
+
+## Examples
+
+See `examples/` directory.
+
+## Links to Other Skills
+
+- **unit-test**: Use to write regression tests for the fixed bug.
+- **project-memory**: Use to search for historical bug fixes or related issues.

package/dist/core/templates/skills/debug-skill.vi.md

@@ -0,0 +1,69 @@
+# Kỹ năng: Sửa lỗi (Debugging) (Cross-Cutting)
+
+## Mục đích
+
+Thực hiện một phiên debug có cấu trúc để tái dựng (reproduce), cô lập (isolate), chẩn đoán (diagnose) và sửa lỗi phần mềm một cách hệ thống.
+
+## Khi nào sử dụng
+
+- Khi gặp stack trace, biệt lệ thời gian chạy (runtime exception) hoặc thông báo lỗi
+- Khi hành vi của hệ thống khác biệt so với đặc tả kỹ thuật (specs)
+- Khi phát hiện lỗi trên môi trường staging hoặc production nhưng chưa rõ nguyên nhân
+
+## Quy trình từng bước
+
+### Bước 1: Tái dựng lỗi (Reproduce)
+- Xác định hành vi mong đợi (Expected) vs. hành vi thực tế (Actual)
+- Xác định các bước tối giản để tái dựng lỗi một cách chính xác
+- Đánh giá phạm vi của lỗi (ai bị ảnh hưởng, lỗi bắt đầu từ khi nào)
+
+### Bước 2: Cô lập lỗi (Isolate)
+- Thu hẹp phạm vi tìm kiếm vào component, module hoặc luồng code gây lỗi
+- Phân tích log, lỗi đầu ra hoặc lịch sử các commit gần đây
+- Kiểm tra các thay đổi cấu hình hoặc cập nhật thư viện gần đây
+
+### Bước 3: Chẩn đoán lỗi (Diagnose)
+- Đưa ra giả thuyết có thể kiểm chứng và trace luồng dữ liệu/biến số
+- Xác định nguyên nhân gốc rễ (root cause) thay vì chỉ xử lý triệu chứng bề nổi
+
+### Bước 4: Sửa lỗi & Ngăn ngừa (Fix & Prevent)
+- Đề xuất và triển khai giải pháp sửa lỗi code chính xác
+- Phân tích các tác dụng phụ và trường hợp biên phát sinh từ bản sửa lỗi
+- Xây dựng chiến lược test hồi quy (regression tests) để ngăn ngừa lỗi lặp lại
+
+## Input yêu cầu
+
+- Thông báo lỗi, stack trace hoặc mô tả chi tiết lỗi
+- Các bước tái dựng lỗi (hoặc thông tin môi trường chạy thử)
+- Quyền truy cập vào file log hoặc các component liên quan
+
+## Output mong đợi
+
+- Báo cáo sửa lỗi (Debug Report) bao gồm:
+  - Tái dựng lỗi (Mong đợi vs. Thực tế)
+  - Phân tích nguyên nhân gốc rễ (Root Cause)
+  - Giải pháp sửa lỗi đã áp dụng
+  - Kế hoạch ngăn ngừa (test hồi quy cần bổ sung)
+
+## Giọng điệu & Quy tắc
+
+- Thực hiện debug một cách hệ thống. Không đoán mò giải pháp một cách mù quáng.
+- Tài liệu hóa các ràng buộc của code và lý do tại sao giải pháp sửa lỗi hoạt động hiệu quả.
+- Tập trung vào bản sửa lỗi; tránh refactor các phần code không liên quan trong khi sửa lỗi.
+
+## 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 hồi quy cho lỗi vừa sửa.
+- **project-memory**: Dùng để tìm kiếm các bản sửa lỗi lịch sử hoặc vấn đề liên quan.