heraspec 0.1.14 → 0.1.15

package/dist/core/templates/skills/README.md

@@ -1,38 +1,41 @@
-# Skills Templates
-
-This directory contains skill.md templates and resources for HeraSpec skills.
-
-## Available Skills
-
-- `module-codebase-skill.md` - For Perfex module codebase structure
-- `ui-ux-skill.md` - For UI/UX design and styling (with UI/UX Builder integration)
-- `documents-skill.md` - For technical and user documentation
-- `content-optimization-skill.md` - For content and CTA optimization
-- `wordpress-plugin-check-skill.md` - Run WordPress Plugin Check and fix issues
-- `plugin-directory-skill.md` - **NEW** Review plugin against 18 WordPress.org Directory Guidelines
-
-## UI/UX Skill Resources
-
-The `ui-ux-skill.md` includes integration with UI/UX Builder (built upon [UI UX Pro Max Skill](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill)):
-
-- **Scripts**: `scripts/search.py` and `scripts/core.py` for searching design database
-- **Search Modes**: 
-  - **BM25** (default) - Fast keyword-based search, zero dependencies
-  - **Vector** - Semantic search with ~15-20% better results (requires: `pip install sentence-transformers scikit-learn`)
-  - **Hybrid** - Best of both worlds with ~25% better results (requires: `pip install sentence-transformers scikit-learn`)
-- **Data**: `data/` folder contains CSV databases for:
-  - Styles (57 UI styles)
-  - Colors (95 color palettes)
-  - Typography (56 font pairings)
-  - Charts (24 chart types)
-  - Products (product recommendations)
-  - Pages (9+ page types for multi-page websites)
-  - Landing pages (page structures)
-  - UX guidelines (98 best practices)
-  - Stacks (8 tech stack guidelines)
-
-## Usage
-
-When creating a new skill, copy the appropriate template and customize it for your specific skill.
-
-For UI/UX tasks, agents will automatically use the search scripts to find relevant design intelligence before implementing.
+# Skills Templates
+
+This directory contains self-contained skill templates and resources for HeraSpec skills. Every skill is placed inside its own subdirectory to hold its `skill.md` and associated assets (templates, scripts, design knowledge, etc.).
+
+## Directory Structure
+
+```
+skills/
+├── <skill-name>/
+│   ├── skill.md                 ← Skill guidelines (English)
+│   ├── skill.vi.md              ← Skill guidelines (Vietnamese, optional)
+│   ├── templates/               ← Skill-specific templates (optional)
+│   ├── scripts/                 ← Skill-specific automation scripts (optional)
+│   └── data/                    ← Skill-specific databases/assets (optional)
+└── knowledge/                   ← HeRaSpec global knowledge base (pre-analyzed profiles)
+```
+
+## Available Skills
+
+- **`ui-ux/`** - For UI/UX design and styling (includes search script, design databases, and prompt templates).
+- **`design-system/`** - For designing according to specific popular design systems (references `knowledge/design-systems`).
+- **`documents/`** - For technical and user documentation.
+- **`content-optimization/`** - For content and CTA optimization.
+- **`unit-test/`**, **`integration-test/`**, **`e2e-test/`** - Testing skills.
+- **`sourcecode-analyzer/`** - Pre-analyzed codebase scanning.
+- **`project-memory/`** - Memory-aware session summary and indexing.
+- **`smart-explore/`** - Smart file/project exploration.
+- **`deploy-documentation/`** - Automating deploy instructions.
+- **`code-review/`**, **`debug/`**, **`system-design/`**, **`tech-debt/`**, **`spec-writer/`** - Standard coding lifecycle skills.
+- **`seo-audit/`**, **`campaign-plan/`**, **`content-creation/`**, **`email-sequence/`**, **`sql-queries/`** - Marketing, SEO, and database planning skills.
+- **`perfex-module/module-codebase/`** - Perfex CRM module codebase skill.
+- **`wordpress/ux-element/`** - flatsome UX Builder element development.
+- **`wordpress/plugin-standard/`** - WordPress plugin coding standards.
+- **`wordpress/plugin-check/`** - WordPress Plugin Check tool running and fix guidelines.
+- **`wordpress/plugin-directory/`** - WordPress.org Plugin Directory submission guideline checks.
+
+## UI/UX & Design System Resources
+
+- **`ui-ux/scripts/`**: `search.py` and `core.py` for searching the design databases.
+- **`ui-ux/data/`**: CSV databases for Styles, Colors, Typography, Stacks, UX guidelines, etc.
+- **`design-system/knowledge/design-systems/`**: Complete markdown design guidelines (`DESIGN.md`) for popular platforms like Stripe, Notion, Linear, Vercel, etc.

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

@@ -0,0 +1,76 @@
+# Skill: Campaign Plan (Cross-Cutting)
+
+## Purpose
+
+Generate a comprehensive marketing campaign brief covering goals, target audience, key messaging, week-by-week channel strategy, content calendar, and success metrics.
+
+## When to Use
+
+- When planning a new product launch, lead-generation push, or brand awareness campaign.
+- When you need a week-by-week content calendar mapping dependencies between assets.
+- When translating business and marketing goals into structured, executable campaign tasks.
+
+## Step-by-Step Process
+
+### Step 1: Objective & Audience Definition
+- Formulate SMART objectives (e.g., generate 200 SQLs in 6 weeks).
+- Define primary and secondary audience segments, their pain points, and stage in the buyer's journey.
+
+### Step 2: Messaging & Differentiation
+- Define one core campaign message and 3-4 supporting messages tailored to pain points.
+- Identify solid proof points (case studies, data, testimonials) to support the messaging.
+
+### Step 3: Channel Strategy
+- Select channels based on audience habits:
+  - Owned (blog, email, social)
+  - Earned (PR, influencer, guest posts)
+  - Paid (SEM, social ads, sponsorships)
+- Map effort levels (low, medium, high) and budget allocations.
+
+### Step 4: Content Calendar & Asset Mapping
+- Build a week-by-week content calendar in table format.
+- List all required content assets with priority and creation deadlines.
+
+### Step 5: Success Metrics & KPIs
+- Define primary and secondary KPIs.
+- Establish tracking mechanisms and risk mitigation plans.
+
+## Required Input
+
+- **Campaign Goal**: Drive signups, product launch, lead-gen, etc.
+- **Target Audience**: Roles, industry, pain points.
+- **Timeline**: Campaign duration and key launch dates.
+- **Budget Tier** (Optional): Paid media budget range.
+
+## Expected Output
+
+- **Executive Summary**: One-sentence summary and main measurable target.
+- **Audience Profile**: 2-3 sentence summary of the target buyers.
+- **Messaging Matrix**: Key message, supporting points, and proof points.
+- **Content Calendar Table**: Columns for Week, Asset Name, Channel, and Notes.
+- **Success Metrics Table**: List of KPIs, target numbers, and tracking methods.
+- **Next Steps Checklist**: Actionable kick-off tasks.
+
+## Tone & Rules
+
+- Write in a highly structured, strategic, and professional tone.
+- Ensure all campaign goals follow the SMART framework.
+- Always include clear dependencies in the content calendar.
+
+## Available Templates
+
+- None
+
+## Available Scripts
+
+- None
+
+## Examples
+
+See `examples/` directory.
+
+## Links to Other Skills
+
+- **documents**: Use to write the final campaign plan document.
+- **content-creation**: Use to write the copy for the assets mapped in the campaign plan.
+- **ui-ux**: Use to design landing pages and ad creative layouts required for the campaign.

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/campaign-plan-skill.md

@@ -0,0 +1,76 @@
+# Skill: Campaign Plan (Cross-Cutting)
+
+## Purpose
+
+Generate a comprehensive marketing campaign brief covering goals, target audience, key messaging, week-by-week channel strategy, content calendar, and success metrics.
+
+## When to Use
+
+- When planning a new product launch, lead-generation push, or brand awareness campaign.
+- When you need a week-by-week content calendar mapping dependencies between assets.
+- When translating business and marketing goals into structured, executable campaign tasks.
+
+## Step-by-Step Process
+
+### Step 1: Objective & Audience Definition
+- Formulate SMART objectives (e.g., generate 200 SQLs in 6 weeks).
+- Define primary and secondary audience segments, their pain points, and stage in the buyer's journey.
+
+### Step 2: Messaging & Differentiation
+- Define one core campaign message and 3-4 supporting messages tailored to pain points.
+- Identify solid proof points (case studies, data, testimonials) to support the messaging.
+
+### Step 3: Channel Strategy
+- Select channels based on audience habits:
+  - Owned (blog, email, social)
+  - Earned (PR, influencer, guest posts)
+  - Paid (SEM, social ads, sponsorships)
+- Map effort levels (low, medium, high) and budget allocations.
+
+### Step 4: Content Calendar & Asset Mapping
+- Build a week-by-week content calendar in table format.
+- List all required content assets with priority and creation deadlines.
+
+### Step 5: Success Metrics & KPIs
+- Define primary and secondary KPIs.
+- Establish tracking mechanisms and risk mitigation plans.
+
+## Required Input
+
+- **Campaign Goal**: Drive signups, product launch, lead-gen, etc.
+- **Target Audience**: Roles, industry, pain points.
+- **Timeline**: Campaign duration and key launch dates.
+- **Budget Tier** (Optional): Paid media budget range.
+
+## Expected Output
+
+- **Executive Summary**: One-sentence summary and main measurable target.
+- **Audience Profile**: 2-3 sentence summary of the target buyers.
+- **Messaging Matrix**: Key message, supporting points, and proof points.
+- **Content Calendar Table**: Columns for Week, Asset Name, Channel, and Notes.
+- **Success Metrics Table**: List of KPIs, target numbers, and tracking methods.
+- **Next Steps Checklist**: Actionable kick-off tasks.
+
+## Tone & Rules
+
+- Write in a highly structured, strategic, and professional tone.
+- Ensure all campaign goals follow the SMART framework.
+- Always include clear dependencies in the content calendar.
+
+## Available Templates
+
+- None
+
+## Available Scripts
+
+- None
+
+## Examples
+
+See `examples/` directory.
+
+## Links to Other Skills
+
+- **documents**: Use to write the final campaign plan document.
+- **content-creation**: Use to write the copy for the assets mapped in the campaign plan.
+- **ui-ux**: Use to design landing pages and ad creative layouts required for the campaign.

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.