thanh-kit 2.5.0

package/templates/skills/INSTALLATION.md

@@ -0,0 +1,360 @@
+# Skills Installation Guide
+
+This guide explains how to install dependencies for Claude Code skills.
+
+## Overview
+
+Skills are organized into groups with Python utility scripts. Each skill's scripts directory contains a `requirements.txt` file listing dependencies.
+
+## Automated Installation (Recommended)
+
+Use the provided installation scripts for automated setup:
+
+### Linux/macOS
+
+```bash
+cd .claude/skills
+chmod +x install.sh
+./install.sh
+```
+
+The script will:
+- Detect your OS (Linux or macOS)
+- Install package managers (Homebrew for macOS, apt-get for Linux)
+- Install system dependencies (FFmpeg, ImageMagick)
+- Install Node.js and global packages (rmbg-cli, pnpm, wrangler, repomix)
+- Create Python virtual environment
+- Install Python packages for all skills
+- Install test dependencies
+- Verify all installations
+
+### Windows (PowerShell)
+
+Run as Administrator:
+
+```powershell
+cd .claude\skills
+Set-ExecutionPolicy Bypass -Scope Process -Force
+.\install.ps1
+```
+
+Options:
+```powershell
+# Skip Chocolatey installation if already installed
+.\install.ps1 -SkipChocolatey
+
+# Show help
+.\install.ps1 -Help
+```
+
+The script will:
+- Install Chocolatey package manager (if needed)
+- Install system dependencies (FFmpeg, ImageMagick)
+- Install Node.js and global packages
+- Create Python virtual environment
+- Install Python packages
+- Verify all installations
+
+### What Gets Installed
+
+**System Tools:**
+- FFmpeg (video/audio processing)
+- ImageMagick (image processing)
+
+**Node.js Packages (global):**
+- rmbg-cli (AI background removal)
+- pnpm (package manager)
+- wrangler (Cloudflare CLI)
+- repomix (repository packaging)
+
+**Python Packages:**
+- google-genai (Gemini API)
+- pypdf, python-docx (document processing)
+- Pillow (image processing)
+- pytest, pytest-cov (testing)
+
+## Manual Installation
+
+If you prefer manual installation or the automated script fails:
+
+## Quick Start
+
+### Option 1: Install All Dependencies (Recommended)
+
+```bash
+# Create virtual environment
+python3 -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+
+# Install all skill dependencies
+pip install -r .claude/skills/ai-multimodal/scripts/requirements.txt
+
+# Install test dependencies for development
+pip install pytest pytest-cov pytest-mock
+```
+
+### Option 2: Install Per-Skill
+
+Navigate to specific skill and install:
+
+```bash
+cd .claude/skills/ai-multimodal/scripts
+pip install -r requirements.txt
+```
+
+## Skills Dependencies
+
+### Python Package Dependencies
+
+Most skills use only Python standard library. Only **ai-multimodal** requires external packages:
+
+**ai-multimodal** (`.claude/skills/ai-multimodal/scripts/requirements.txt`):
+- `google-genai>=0.1.0` - Google Gemini API
+- `pypdf>=4.0.0` - PDF processing
+- `python-docx>=1.0.0` - DOCX conversion
+- `docx2pdf>=0.1.8` - PDF conversion (Windows only)
+- `markdown>=3.5.0` - Markdown processing
+- `Pillow>=10.0.0` - Image processing
+- `python-dotenv>=1.0.0` - Environment variables
+
+### System Tool Dependencies
+
+Several skills require external CLI tools:
+
+#### media-processing
+- **FFmpeg**: Video/audio processing
+  - Ubuntu/Debian: `sudo apt-get install ffmpeg`
+  - macOS: `brew install ffmpeg`
+  - Windows: `choco install ffmpeg`
+- **ImageMagick**: Image processing
+  - Ubuntu/Debian: `sudo apt-get install imagemagick`
+  - macOS: `brew install imagemagick`
+  - Windows: `choco install imagemagick`
+- **RMBG CLI**: AI background removal
+  - All platforms: `npm install -g rmbg-cli`
+
+#### devops
+- **Cloudflare Wrangler**: `npm install -g wrangler`
+- **Docker**: https://docs.docker.com/get-docker/
+- **Google Cloud CLI**: https://cloud.google.com/sdk/docs/install
+
+#### better-auth, repomix, shopify
+- **Node.js 18+**: https://nodejs.org/
+- **Better Auth**: `npm install better-auth`
+- **Repomix**: `npm install -g repomix`
+- **Shopify CLI**: `npm install -g @shopify/cli @shopify/theme`
+
+#### databases
+- **PostgreSQL client**: `sudo apt-get install postgresql-client` (Linux)
+- **MongoDB Shell**: https://www.mongodb.com/try/download/shell
+- **MongoDB Tools**: https://www.mongodb.com/try/download/database-tools
+
+#### web-frameworks, ui-styling
+- **Node.js 18+**: https://nodejs.org/
+- **pnpm**: `npm install -g pnpm`
+- **yarn**: `npm install -g yarn`
+
+## Installation by Platform
+
+### Linux (Ubuntu/Debian)
+
+```bash
+# Python environment
+python3 -m venv .venv
+source .venv/bin/activate
+
+# Python packages (ai-multimodal only)
+cd .claude/skills/ai-multimodal/scripts
+pip install -r requirements.txt
+
+# System tools
+sudo apt-get update
+sudo apt-get install -y ffmpeg imagemagick postgresql-client
+
+# Node.js and tools
+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+sudo apt-get install -y nodejs
+npm install -g pnpm wrangler repomix rmbg-cli @shopify/cli
+```
+
+### macOS
+
+```bash
+# Python environment
+python3 -m venv .venv
+source .venv/bin/activate
+
+# Python packages (ai-multimodal only)
+cd .claude/skills/ai-multimodal/scripts
+pip install -r requirements.txt
+
+# System tools via Homebrew
+brew install ffmpeg imagemagick postgresql
+
+# Node.js and tools
+brew install node
+npm install -g pnpm wrangler repomix rmbg-cli @shopify/cli
+```
+
+### Windows
+
+```powershell
+# Python environment
+python -m venv .venv
+.venv\Scripts\activate
+
+# Python packages (ai-multimodal only)
+cd .claude\skills\ai-multimodal\scripts
+pip install -r requirements.txt
+
+# System tools via Chocolatey
+choco install ffmpeg imagemagick nodejs
+
+# Node.js tools
+npm install -g pnpm wrangler repomix rmbg-cli @shopify/cli
+```
+
+## Testing Dependencies
+
+All skills include test dependencies in `requirements.txt`:
+
+```txt
+pytest>=8.0.0
+pytest-cov>=4.1.0
+pytest-mock>=3.12.0
+```
+
+To run tests for a skill:
+
+```bash
+cd .claude/skills/{skill-name}/scripts
+python -m pytest tests/ -v --cov=. --cov-report=term-missing
+```
+
+## Environment Variables
+
+Skills respect environment variable loading priority:
+
+1. **process.env** (highest priority - runtime environment)
+2. **`.claude/skills/{skill-name}/.env`** (skill-specific config)
+3. **`.claude/skills/.env`** (shared skills config)
+4. **`.claude/.env`** (global Claude config)
+
+Example `.env` files are provided where needed (e.g., `devops/.env.example`).
+
+## Troubleshooting
+
+### "externally-managed-environment" Error
+
+If you see this error when installing packages:
+
+```bash
+# Use virtual environment (recommended)
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+
+# Or use pipx for CLI tools
+pipx install google-genai
+```
+
+### Missing System Tools
+
+If scripts fail with "command not found":
+
+```bash
+# Check if tool is installed
+which ffmpeg
+which docker
+which node
+
+# Verify tool works
+ffmpeg -version
+docker --version
+node --version
+```
+
+### Permission Errors
+
+On Linux/macOS, you may need to make scripts executable:
+
+```bash
+chmod +x .claude/skills/*/scripts/*.py
+```
+
+## Minimal Installation
+
+If you only want to use specific skills:
+
+**For ai-multimodal only:**
+```bash
+pip install google-genai pypdf python-docx markdown Pillow python-dotenv
+```
+
+**For media-processing only:**
+```bash
+# macOS
+brew install ffmpeg imagemagick
+npm install -g rmbg-cli
+
+# Linux
+sudo apt-get install ffmpeg imagemagick
+npm install -g rmbg-cli
+
+# Windows
+choco install ffmpeg imagemagick
+npm install -g rmbg-cli
+```
+
+**For other skills:**
+Most other skills (better-auth, repomix, shopify, devops, web-frameworks, ui-styling, databases) use only Python stdlib and require no `pip install`.
+
+## Development Setup
+
+For contributors working on skills:
+
+```bash
+# Install all test dependencies
+pip install pytest pytest-cov pytest-mock
+
+# Install pre-commit hooks (if available)
+pre-commit install
+
+# Run all tests
+pytest .claude/skills/*/scripts/tests/ -v
+
+# Check coverage across all skills
+pytest .claude/skills/*/scripts/tests/ --cov=.claude/skills --cov-report=html
+```
+
+## Skill-Specific Notes
+
+### ai-multimodal
+- Requires `GEMINI_API_KEY` in environment
+- Get API key: https://aistudio.google.com/app/apikey
+- Windows users: `docx2pdf` requires Microsoft Word installed
+
+### media-processing
+- FFmpeg must be in PATH
+- ImageMagick must be in PATH
+- RMBG CLI must be installed globally
+- Test with: `ffmpeg -version`, `convert -version`, and `rmbg --version`
+
+### devops
+- Cloudflare: Requires `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID`
+- GCloud: Requires `GOOGLE_APPLICATION_CREDENTIALS` path to service account JSON
+- Docker: Must have Docker daemon running
+
+### shopify
+- Requires Shopify CLI authentication: `shopify auth login`
+- Partner account needed for app development
+
+## Getting Help
+
+If dependencies fail to install or scripts don't work:
+
+1. Check the skill's `scripts/requirements.txt` for specific versions
+2. Verify system tools are installed and in PATH
+3. Check environment variables are set correctly
+4. Review skill's `SKILL.md` for additional setup instructions
+5. Open an issue: https://github.com/anthropics/claude-code/issues

package/templates/skills/README.md

@@ -0,0 +1,309 @@
+# 📚 Skills - Kho Kiến Thức Chuyên Môn
+
+## Skills là gì?
+
+**Skills** là các "bộ kiến thức chuyên sâu" mà AI sẽ học khi cần làm việc chuyên môn. Giống như khi bạn cần làm món ăn đặc biệt, bạn sẽ mở sách dạy nấu ăn để xem công thức vậy.
+
+**Ví dụ đơn giản:**
+- Cần làm **giao diện đẹp** → AI load skill `ui-ux-pro-max` (50 styles thiết kế)
+- Cần làm **React component** → AI load skill `frontend-development` (best practices React)
+- Cần **sửa bug khó** → AI load skill `debugging` (kỹ thuật debug chuyên nghiệp)
+
+---
+
+## Khi Nào AI Load Skills?
+
+| Tình huống | AI có load skill? |
+|------------|-------------------|
+| "Sửa typo trong text" | ❌ Không (quá đơn giản) |
+| "Tạo button màu xanh" | ❌ Không (không cần kiến thức đặc biệt) |
+| "Thiết kế dashboard đẹp" | ✅ Có (cần kiến thức UI/UX) |
+| "Tối ưu database chậm" | ✅ Có (cần kiến thức performance) |
+| "Implement OAuth2" | ✅ Có (cần kiến thức authentication) |
+
+**Nguyên tắc:** Chỉ load khi thực sự cần, không load thừa.
+
+---
+
+## Danh Sách 59 Skills Theo Nhóm
+
+### 🎨 Nhóm Giao Diện & Thiết Kế (11 skills)
+
+| Skill | Dùng Khi Nào | Có Gì Bên Trong |
+|-------|--------------|-----------------|
+| **ui-ux-pro-max** | Cần thiết kế đẹp, chuyên nghiệp | 50 styles, 21 bảng màu, 50 cặp fonts |
+| **frontend-design** | Tạo giao diện production-ready | Hướng dẫn thiết kế chuẩn |
+| **frontend-design-pro** | Cần ảnh thật (Unsplash/Pexels) | Tích hợp ảnh stock chất lượng |
+| **frontend-development** | Viết code React/TypeScript | Best practices, patterns chuẩn |
+| **ui-styling** | Dùng Tailwind, shadcn/ui | Components và styling guide |
+| **threejs** | Làm 3D, WebGL | Hướng dẫn Three.js đầy đủ |
+| **web-frameworks** | Dùng Next.js, Turborepo | Setup và best practices |
+| **webapp-testing** | Test giao diện với Playwright | Kỹ thuật test UI |
+
+### 🔧 Nhóm Backend & Database (4 skills)
+
+| Skill | Dùng Khi Nào | Có Gì Bên Trong |
+|-------|--------------|-----------------|
+| **backend-development** | Viết API, server logic | Node.js, Python, Go, Rust guides |
+| **databases** | Làm việc với MongoDB, PostgreSQL | Queries, optimization, migrations |
+| **better-auth** | Implement đăng nhập, OAuth | OAuth2, 2FA, session management |
+| **payment-integration** | Tích hợp thanh toán | SePay (VN), Polar (quốc tế) |
+
+### 🐛 Nhóm Sửa Lỗi & Testing (5 skills)
+
+| Skill | Dùng Khi Nào | Có Gì Bên Trong |
+|-------|--------------|-----------------|
+| **debugging** | Debug lỗi khó, phức tạp | Framework debug 4 bước |
+| **bug-diagnosis** | Phân tích nguyên nhân lỗi | Quy trình chẩn đoán bug |
+| **test-generation** | Viết test theo BDD | Given/When/Then templates |
+| **tasks-test-generation** | Viết unit test | xUnit (C#), Jest (JS) |
+| **chrome-devtools** | Debug trên browser | Puppeteer, performance analysis |
+
+### 🏗️ Nhóm Kiến Trúc & Hiệu Năng (3 skills)
+
+| Skill | Dùng Khi Nào | Có Gì Bên Trong |
+|-------|--------------|-----------------|
+| **arch-performance-optimization** | App chạy chậm | Kỹ thuật tối ưu performance |
+| **arch-security-review** | Review bảo mật | OWASP Top 10, security checklist |
+| **arch-cross-service-integration** | Kết nối nhiều services | Message bus, API patterns |
+
+### 📚 Nhóm Tài Liệu & Lập Kế Hoạch (7 skills)
+
+| Skill | Dùng Khi Nào | Có Gì Bên Trong |
+|-------|--------------|-----------------|
+| **documentation** | Lên kế hoạch viết docs | Framework 4 phases |
+| **tasks-documentation** | Viết docs thực tế | Templates cho comments, API docs |
+| **feature-docs** | Viết docs cho tính năng | Template với test cases |
+| **readme-improvement** | Cải thiện README | Best practices README |
+| **planning** | Lập kế hoạch kỹ thuật | Framework planning |
+| **plan-analysis** | Phân tích kế hoạch có sẵn | Đánh giá impact, risks |
+| **project-index** | Tạo index cấu trúc dự án | Scan và generate docs/structure.md |
+
+### 🤖 Nhóm AI & Đa Phương Tiện (3 skills)
+
+| Skill | Dùng Khi Nào | Có Gì Bên Trong |
+|-------|--------------|-----------------|
+| **ai-multimodal** | Xử lý audio, video, ảnh | Google Gemini API guides |
+| **ai-artist** | Viết prompt cho AI | Prompt engineering techniques |
+| **google-adk-python** | Xây dựng AI agents | Google ADK framework |
+
+### ⚙️ Nhóm DevOps & Công Cụ (7 skills)
+
+| Skill | Dùng Khi Nào | Có Gì Bên Trong |
+|-------|--------------|-----------------|
+| **devops** | Deploy, CI/CD | Cloudflare, Docker, GCP |
+| **mcp-builder** | Tạo MCP server | Hướng dẫn build MCP |
+| **mcp-management** | Quản lý MCP tools | Discover, execute MCP |
+| **repomix** | Đóng gói code cho AI | Pack codebase thành 1 file |
+| **package-upgrade** | Upgrade dependencies | Analyze breaking changes |
+| **media-processing** | Xử lý video, ảnh | FFmpeg, ImageMagick guides |
+
+### 🔍 Nhóm Review & Chất Lượng (4 skills)
+
+| Skill | Dùng Khi Nào | Có Gì Bên Trong |
+|-------|--------------|-----------------|
+| **code-review** | Review code kỹ lưỡng | Checklist review chuyên sâu |
+| **dual-pass-review** | Review 2 lượt bắt buộc | Đảm bảo chất lượng |
+| **tasks-code-review** | Review PR nhanh | Checklist ngắn gọn |
+| **tasks-spec-update** | Cập nhật specs | Sync docs với code |
+
+### 🔬 Nhóm Nghiên Cứu & Giải Quyết Vấn Đề (5 skills)
+
+| Skill | Dùng Khi Nào | Có Gì Bên Trong |
+|-------|--------------|-----------------|
+| **research** | Nghiên cứu công nghệ | Framework research |
+| **problem-solving** | Bị stuck, không biết làm gì | 6 kỹ thuật giải quyết |
+| **sequential-thinking** | Vấn đề phức tạp nhiều bước | Structured thinking |
+| **feature-investigation** | Tìm hiểu code hiện có | Trace flow, explain logic |
+| **branch-comparison** | So sánh branches | Git diff analysis |
+
+### 📱 Nhóm Mobile & E-commerce (2 skills)
+
+| Skill | Dùng Khi Nào | Có Gì Bên Trong |
+|-------|--------------|-----------------|
+| **mobile-development** | Làm app mobile | React Native, Flutter, Swift |
+| **shopify** | Làm app Shopify | APIs, themes, extensions |
+
+### 🛠️ Nhóm Quản Lý Skills (3 skills)
+
+| Skill | Dùng Khi Nào | Có Gì Bên Trong |
+|-------|--------------|-----------------|
+| **skill-creator** | Tạo skill mới | Template và hướng dẫn |
+| **skill-share** | Chia sẻ skill qua Slack | Auto-share workflow |
+| **claude-code** | Dùng Claude Code | Commands, MCP, hooks |
+
+### 📄 Nhóm Xử Lý Tài Liệu (4 skills)
+
+| Skill | Dùng Khi Nào | Có Gì Bên Trong |
+|-------|--------------|-----------------|
+| **docx** | Tạo/sửa Word | python-docx guides |
+| **pdf** | Xử lý PDF | Extract, merge, fill forms |
+| **pptx** | Tạo PowerPoint | Slides, layouts |
+| **xlsx** | Tạo Excel | Formulas, formatting |
+
+### 🔧 Nhóm Tiện Ích (4 skills)
+
+| Skill | Dùng Khi Nào | Có Gì Bên Trong |
+|-------|--------------|-----------------|
+| **docs-seeker** | Tìm tài liệu kỹ thuật | Search strategies |
+| **domain-name-brainstormer** | Tìm tên domain | Generate + check availability |
+| **developer-growth-analysis** | Phân tích coding patterns | Self-improvement insights |
+
+---
+
+## Cấu Trúc Một Skill
+
+Mỗi skill là một thư mục chứa:
+
+```
+skill-name/
+├── SKILL.md          ← File chính (AI đọc file này)
+├── references/       ← Tài liệu tham khảo (nếu có)
+│   ├── api.md
+│   └── examples.md
+└── scripts/          ← Scripts hỗ trợ (nếu có)
+    └── helper.js
+```
+
+**File SKILL.md chứa:**
+```markdown
+---
+name: tên-skill
+description: Mô tả ngắn gọn
+---
+
+# Tên Skill
+
+## Khi Nào Dùng
+- Tình huống 1
+- Tình huống 2
+
+## Hướng Dẫn Chi Tiết
+[Nội dung hướng dẫn...]
+
+## Ví Dụ
+[Các ví dụ cụ thể...]
+```
+
+---
+
+## Cách AI Chọn Skills
+
+### Ví dụ 1: Không cần skill
+```
+Bạn: "Đổi màu button từ xanh sang đỏ"
+
+AI phân tích:
+- Việc đơn giản, không cần kiến thức đặc biệt
+- Không load skill nào
+
+→ AI làm luôn
+```
+
+### Ví dụ 2: Cần 1 skill
+```
+Bạn: "Tối ưu trang chạy chậm"
+
+AI phân tích:
+- Cần kiến thức performance optimization
+- Load: arch-performance-optimization
+
+→ AI đọc skill, áp dụng techniques
+```
+
+### Ví dụ 3: Cần nhiều skills
+```
+Bạn: "Xây dựng dashboard đẹp với data từ API"
+
+AI phân tích:
+- Cần thiết kế đẹp → ui-ux-pro-max
+- Cần code React → frontend-development
+- Cần fetch data → backend-development
+
+→ AI load 3 skills, kết hợp kiến thức
+```
+
+---
+
+## Cài Đặt Dependencies
+
+Một số skills cần cài thêm phần mềm:
+
+### Cài Tự Động (Khuyến nghị)
+
+**Windows (PowerShell Admin):**
+```powershell
+cd .claude\skills
+.\install.ps1
+```
+
+**Linux/macOS:**
+```bash
+cd .claude/skills
+./install.sh
+```
+
+### Sẽ Cài Những Gì?
+
+| Loại | Phần mềm |
+|------|----------|
+| System tools | FFmpeg, ImageMagick |
+| Node.js packages | rmbg-cli, pnpm, repomix |
+| Python packages | google-genai, pypdf, Pillow |
+
+---
+
+## Tạo Skill Mới
+
+Nếu muốn tạo skill riêng:
+
+1. **Tạo thư mục:**
+```
+.claude/skills/ten-skill-cua-ban/
+```
+
+2. **Tạo file SKILL.md:**
+```markdown
+---
+name: ten-skill-cua-ban
+description: Mô tả skill làm gì
+---
+
+# Tên Skill
+
+## Khi Nào Dùng
+- Tình huống sử dụng
+
+## Hướng Dẫn
+- Bước 1: ...
+- Bước 2: ...
+
+## Ví Dụ
+- Ví dụ cụ thể
+```
+
+3. **Đăng ký trong settings** (tùy chọn)
+
+Xem chi tiết: [skill-creator/SKILL.md](skill-creator/SKILL.md)
+
+---
+
+## Tóm Tắt
+
+| Khái niệm | Giải thích |
+|-----------|------------|
+| **Skill là gì** | Bộ kiến thức chuyên môn AI sẽ học |
+| **Có bao nhiêu** | 59 skills chia thành 14 nhóm |
+| **Khi nào load** | Chỉ khi công việc cần kiến thức chuyên sâu |
+| **Ai quyết định** | AI tự động chọn dựa trên yêu cầu |
+| **Có thể tạo thêm** | Có, theo template trong skill-creator |
+
+---
+
+## Xem Thêm
+
+- [Danh sách Agents (Vai trò)](../agents/README.md)
+- [Danh sách Commands (Quy trình)](../commands/README.md)
+- [Router (Bộ định tuyến)](../router/README.md)
+- [Hướng dẫn tạo Skill](skill-creator/SKILL.md)
+- [Cài đặt chi tiết](INSTALLATION.md)