codymaster 4.1.4 → 4.4.1

package/skills/skill-creator-ultra/examples/example_anthropic_frontend.md

@@ -0,0 +1,109 @@
+# Example: frontend-design (🟢 Đơn giản nhưng MẠNH — Complexity 5)
+
+> **Nguồn gốc:** Anthropic's official `frontend-design` skill — chỉ 43 dòng!
+> **Điểm hay:** Chứng minh skill tốt không cần dài. Tone "explain the why" tuyệt vời.
+> **Bài học:** Lean = AI follow tốt hơn. Viết ngắn nhưng truyền cảm hứng.
+
+## 📂 Cấu trúc (Anthropic thật)
+
+```
+skills/frontend-design/
+└── SKILL.md        ← CHỈ 43 DÒNG. Không resources, không scripts.
+```
+
+---
+
+## 📄 File 1: SKILL.md (NGUYÊN VĂN từ Anthropic)
+
+```markdown
+---
+name: frontend-design
+description: |
+  Create distinctive, production-grade frontend interfaces with high design
+  quality. Use this skill when the user asks to build web components, pages,
+  artifacts, posters, or applications (examples include websites, landing
+  pages, dashboards, React components, HTML/CSS layouts, or when styling/
+  beautifying any web UI). Generates creative, polished code and UI design
+  that avoids generic AI aesthetics.
+---
+
+This skill guides creation of distinctive, production-grade frontend
+interfaces that avoid generic "AI slop" aesthetics. Implement real working
+code with exceptional attention to aesthetic details and creative choices.
+
+## Design Thinking
+
+Before coding, understand the context and commit to a BOLD aesthetic direction:
+- **Purpose**: What problem does this interface solve? Who uses it?
+- **Tone**: Pick an extreme: brutally minimal, maximalist chaos,
+  retro-futuristic, organic/natural, luxury/refined, playful/toy-like...
+- **Constraints**: Technical requirements (framework, performance).
+- **Differentiation**: What makes this UNFORGETTABLE?
+
+**CRITICAL**: Choose a clear conceptual direction and execute it with
+precision. Bold maximalism and refined minimalism both work — the key
+is intentionality, not intensity.
+
+## Frontend Aesthetics Guidelines
+
+Focus on:
+- **Typography**: Avoid generic fonts (Arial, Inter). Choose distinctive,
+  characterful fonts. Pair display + body font.
+- **Color & Theme**: Dominant colors with sharp accents outperform timid,
+  evenly-distributed palettes.
+- **Motion**: One well-orchestrated page load with staggered reveals
+  creates more delight than scattered micro-interactions.
+- **Backgrounds**: Create atmosphere — gradient meshes, noise textures,
+  layered transparencies, grain overlays.
+
+NEVER use: overused fonts (Inter, Roboto), cliched purple gradients,
+predictable layouts, cookie-cutter design.
+
+Remember: Claude is capable of extraordinary creative work. Don't hold
+back, show what can truly be created.
+```
+
+---
+
+## 🔍 Phân tích: Tại sao 43 dòng mà mạnh?
+
+### ✅ Kỹ thuật Anthropic dùng
+
+| Kỹ thuật | Ví dụ cụ thể | Tại sao hiệu quả |
+|---|---|---|
+| **Role Priming qua tone** | "Don't hold back, show what can truly be created" | AI adopt persona sáng tạo, không generic |
+| **Negative Constraints (NEVER)** | "NEVER use: Inter, Roboto, purple gradients" | AI biết RÕ cái cấm → tránh được |
+| **Specificity thay vì rules** | "Pick an extreme: brutally minimal, maximalist chaos, retro-futuristic..." | Cho danh sách cụ thể > "hãy sáng tạo" |
+| **Explain the Why** | "Dominant colors with sharp accents OUTPERFORM timid palettes" | AI hiểu lý do → áp dụng linh hoạt |
+| **No formal sections** | Không có # Goal, # Instructions, # Examples, # Constraints rõ ràng | Skill creative không cần rigid structure |
+
+### ⚠️ Điều THIẾU (nếu dùng style của chúng ta)
+
+| Thiếu | Nên thêm? | Lý do |
+|---|---|---|
+| **Examples** | ✅ Nên | 2-3 screenshots/descriptions của UI tốt vs xấu |
+| **Constraints** | ⚠️ Optional | Skill creative — quá nhiều constraints = giết creativity |
+| **Verification** | ❌ Không cần | Output chủ quan, không grade được |
+| **Scripts** | ❌ Không cần | Skill này sinh code, không cần scripts |
+
+### 🎯 Key Insight
+
+**Lean ≠ Yếu.** 43 dòng Anthropic > 200 dòng quy tắc generic.
+
+Bí quyết:
+1. **Mỗi câu phải pull its weight** — không câu nào thừa
+2. **Inspire thay vì command** — "Don't hold back" > "MUST create beautiful UI"
+3. **Negative examples > positive rules** — "NEVER use Inter" > "use beautiful fonts"
+4. **Skill creative dùng tone khác skill technical** — ít structure hơn, nhiều inspiration hơn
+
+### 📊 So sánh: 2 phong cách viết skill
+
+| | Anthropic Style | Skill-Generator Style |
+|---|---|---|
+| **Tone** | Inspirational, creative | Structured, systematic |
+| **Length** | 30-50 dòng | 50-200 dòng |
+| **Sections** | Freeform | Goal + Instructions + Examples + Constraints |
+| **Best for** | Creative skills (design, writing) | Technical skills (code, data, automation) |
+| **Downside** | Ít guidance cho edge cases | Có thể over-structure |
+
+**→ Skill Creator Ultra dùng cả 2:** technical skills → structured, creative skills → lean.

package/skills/skill-creator-ultra/examples/example_anthropic_pdf.md

@@ -0,0 +1,116 @@
+# Example: pdf-processor (🟠 Phức tạp — Complexity 18)
+
+> **Nguồn gốc:** Dựa trên Anthropic's official `pdf` skill — 1 trong 16 skills chính thức.
+> **Điểm hay:** Description cực "pushy", progressive disclosure 3 tầng, reference docs dày.
+> **Bài học:** Skill phức tạp nhưng SKILL.md vẫn lean nhờ tách logic vào resources.
+
+## 📂 Cấu trúc (Anthropic thật)
+
+```
+skills/pdf/
+├── SKILL.md         ← 315 dòng — Guide + code snippets
+├── forms.md         ← 11KB — Chi tiết riêng về PDF forms/fill
+├── reference.md     ← 16KB — Advanced: pypdfium2, JavaScript libs
+└── scripts/
+    └── ...          ← Helper scripts
+```
+
+---
+
+## 📄 File 1: SKILL.md (trích — Anthropic style)
+
+```markdown
+---
+name: pdf
+description: |
+  Use this skill whenever the user wants to do anything with PDF files.
+  This includes reading or extracting text/tables from PDFs, combining or
+  merging multiple PDFs into one, splitting PDFs apart, rotating pages,
+  adding watermarks, creating new PDFs, filling PDF forms, encrypting/
+  decrypting PDFs, extracting images, and OCR on scanned PDFs to make
+  them searchable. If the user mentions a .pdf file or asks to produce
+  one, use this skill.
+---
+
+# PDF Processing Guide
+
+## Overview
+
+This guide covers essential PDF processing operations using Python
+libraries and command-line tools. For advanced features, JavaScript
+libraries, and detailed examples, see REFERENCE.md. If you need to
+fill out a PDF form, read FORMS.md and follow its instructions.
+
+## Quick Start
+
+from pypdf import PdfReader, PdfWriter
+
+reader = PdfReader("document.pdf")
+print(f"Pages: {len(reader.pages)}")
+
+text = ""
+for page in reader.pages:
+    text += page.extract_text()
+
+## Python Libraries
+
+### pypdf - Basic Operations
+
+#### Merge PDFs
+[code snippets...]
+
+#### Split PDF
+[code snippets...]
+
+### pdfplumber - Text and Table Extraction
+[code snippets...]
+
+### reportlab - Create PDFs
+[code snippets...]
+
+## Quick Reference
+
+| Task             | Best Tool    | Command/Code               |
+|------------------|--------------|-----------------------------|
+| Merge PDFs       | pypdf        | writer.add_page(page)       |
+| Split PDFs       | pypdf        | One page per file           |
+| Extract text     | pdfplumber   | page.extract_text()         |
+| Extract tables   | pdfplumber   | page.extract_tables()       |
+| Create PDFs      | reportlab    | Canvas or Platypus          |
+| Fill PDF forms   | See FORMS.md | See FORMS.md                |
+
+## Next Steps
+- For advanced pypdfium2 usage, see REFERENCE.md
+- For JavaScript libraries (pdf-lib), see REFERENCE.md
+- If you need to fill out a PDF form, follow FORMS.md
+```
+
+---
+
+## 🔍 Phân tích: Bài học từ Anthropic
+
+### ✅ Điểm hay — nên học
+
+| Pattern | Chi tiết | Áp dụng |
+|---|---|---|
+| **Description cực "pushy"** | Liệt kê TOÀN BỘ use cases: "reading, extracting, combining, merging, splitting, rotating, watermarks, creating, filling forms, encrypting, decrypting, extracting images, OCR" | Viết description cover mọi cách user có thể hỏi |
+| **Progressive Disclosure** | SKILL.md = quick reference, FORMS.md = deep dive, REFERENCE.md = advanced | Tách complexity ra resources/, SKILL.md giữ lean |
+| **Code-as-documentation** | Thay vì giải thích cách merge PDF, cho luôn code snippet | Cho AI copy paste, nhanh hơn đọc text |
+| **Quick Reference Table** | Bảng tổng hợp cuối: Task → Best Tool → Command | User scan nhanh, AI chọn đúng tool |
+| **Routing to resources** | "If you need to fill out a PDF form, read FORMS.md" | Lazy loading — chỉ đọc khi cần |
+
+### ⚠️ Điểm khác biệt với skill-generator
+
+| Anthropic style | Skill-generator style | Nên dùng |
+|---|---|---|
+| Không có Examples section | Có 2-3 ví dụ Input → Output | ✅ Giữ Examples — AI hiểu pattern tốt hơn |
+| Không có Constraints section | Có safety guardrails | ✅ Giữ Constraints — đặc biệt cho production |
+| Viết bằng tiếng Anh | Viết bằng tiếng Việt | 🔀 Tùy user |
+| Code snippets inline | Tách script riêng | 🔀 Tùy complexity |
+
+### 🎯 Key Insight
+
+Anthropic's description viết theo kiểu **"bắn phủ"** — liệt kê MỌI THỨ skill làm được.
+Đây là cách tốt nhất để AI trigger đúng, vì AI agent chỉ đọc description để quyết định.
+
+**Rule:** Description nên dài 50-200 ký tự và cover ≥ 80% use cases có thể xảy ra.

package/skills/skill-creator-ultra/examples/example_api_docs.md

@@ -0,0 +1,189 @@
+# Example: api-docs-writer (🟡 Trung bình — Complexity 9)
+
+> **Nguồn cảm hứng:** Tổng hợp từ Stripe API docs style + OpenAPI spec.
+> **Mức độ:** Trung bình — SKILL.md + resources/ + examples/ (không cần scripts).
+> **Tham khảo:** Anthropic's `doc-coauthoring` skill — tách templates ra resources.
+
+## 📂 Cấu trúc
+
+```
+skills/api-docs-writer/
+├── SKILL.md
+├── README.md
+├── resources/
+│   └── api_template.md         ← Template cho output
+└── examples/
+    └── example_rest_api.md     ← Ví dụ chi tiết Input → Output
+```
+
+---
+
+## 📄 File 1: SKILL.md
+
+```markdown
+---
+name: api-docs-writer
+description: |
+  Sinh tài liệu API chuyên nghiệp từ source code hoặc mô tả endpoint.
+  Hỗ trợ REST, GraphQL, gRPC. Output theo format Stripe-style hoặc OpenAPI.
+  Dùng khi user nói "viết API docs", "document API", "tạo tài liệu endpoint",
+  "swagger docs", "describe API", hoặc khi thấy code có route/controller.
+  KHÔNG dùng cho: viết code API mới, testing API, deploy.
+---
+
+# Goal
+
+Sinh API documentation chuyên nghiệp (Stripe-quality) từ source code hoặc
+mô tả, giúp developer onboard nhanh hơn 80%.
+
+# Instructions
+
+1. Nhận input từ user — 1 trong 3 dạng:
+   - **Source code** (route file, controller) → parse endpoints
+   - **Mô tả text** ("API có 3 endpoint: GET /users, POST /users, ...")
+   - **OpenAPI/Swagger JSON** → parse và format lại
+2. Với MỖI endpoint, trích xuất:
+   - Method (GET/POST/PUT/DELETE/PATCH)
+   - Path + Path params
+   - Query params + Body params (type, required, default)
+   - Response (success + error codes)
+   - Authentication (bearer, API key, none)
+3. Hỏi bổ sung: "Có authentication không? Rate limit? Pagination?"
+   - Nếu user không biết → bỏ qua, ghi "TBD"
+4. Sinh docs theo template `resources/api_template.md`
+5. ✅ VERIFY: Mọi endpoint có ≥1 example request + response?
+   - Nếu thiếu → bổ sung example realistic
+
+📚 **Template chi tiết:** `resources/api_template.md`
+
+# Examples
+
+## Ví dụ 1: REST API đơn giản
+
+**Input:** "API quản lý user, có GET /users, POST /users, GET /users/:id"
+
+**Output:** (xem chi tiết trong `examples/example_rest_api.md`)
+
+```markdown
+## GET /users
+
+Lấy danh sách users.
+
+### Parameters
+
+| Param  | Type   | Required | Default | Description          |
+|--------|--------|----------|---------|----------------------|
+| page   | int    | No       | 1       | Trang hiện tại       |
+| limit  | int    | No       | 20      | Số records mỗi trang |
+
+### Example Request
+
+GET /users?page=1&limit=10
+
+### Example Response (200 OK)
+
+{
+  "data": [{"id": 1, "name": "Nguyễn Văn A", "email": "a@example.com"}],
+  "pagination": {"page": 1, "limit": 10, "total": 42}
+}
+
+### Error Responses
+
+| Code | Description            |
+|------|------------------------|
+| 401  | Unauthorized — missing token |
+| 500  | Internal Server Error  |
+```
+
+# Constraints
+
+- Mọi endpoint PHẢI có example request + response — dev đọc example trước doc
+- Ghi rõ field types (string, int, boolean) — tránh đoán sai
+- Luôn có error responses (≥ 401, 404, 500) — dev cần biết lỗi gì có thể xảy ra
+- Dùng realistic data trong examples — "John Doe" tốt hơn "string"
+
+<!-- Generated by Skill Creator Ultra v1.0 -->
+```
+
+---
+
+## 📄 File 2: resources/api_template.md
+
+```markdown
+# API Documentation Template
+
+## {API Name} API
+
+### Base URL
+{base_url}
+
+### Authentication
+{auth_type}: {description}
+
+---
+
+### {METHOD} {path}
+
+{description}
+
+#### Parameters
+
+| Param | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+
+#### Headers
+
+| Header        | Value             | Required |
+|---------------|-------------------|----------|
+
+#### Example Request
+{method} {path}
+{headers}
+{body}
+
+#### Example Response ({status_code})
+{response_json}
+
+#### Error Responses
+
+| Code | Message | Description |
+|------|---------|-------------|
+```
+
+---
+
+## 📄 File 3: examples/example_rest_api.md
+
+```markdown
+# Ví dụ: REST API quản lý Users
+
+## Tình huống
+Developer mới join team, cần document 3 endpoint user management.
+
+## Input
+"API có 3 endpoint: GET /users (list, có pagination), POST /users (tạo mới,
+cần name + email), GET /users/:id (chi tiết 1 user)"
+
+## Output
+[Full API docs theo template — ~50 dòng cho 3 endpoints]
+(Xem SKILL.md Examples section cho shortform)
+
+## Tại sao output như vậy?
+- Có pagination params cho GET /users — vì GET list luôn cần paginate
+- POST body có validation rules — dev cần biết format
+- Error 404 cho GET /users/:id — user có thể không tồn tại
+```
+
+---
+
+## 🔍 Phân tích: Tại sao skill này tốt?
+
+| Tiêu chí | Đánh giá | Ghi chú |
+|---|---|---|
+| **Progressive Disclosure** | ✅ | SKILL.md có tóm tắt, template tách ra resources/ |
+| **Description "pushy"** | ✅ | 6 trigger + 3 anti-trigger + cover cả "swagger" |
+| **Template-based output** | ✅ | Consistent format qua resources/api_template.md |
+| **Explain The Why** | ✅ | "dev đọc example trước doc" |
+| **Verification Step** | ✅ | Step 5: "mọi endpoint có ≥1 example?" |
+| **Realistic examples** | ✅ | Vietnamese names, real pagination |
+| **SKILL.md < 500 dòng** | ✅ | ~80 dòng, template tách riêng |

package/skills/skill-creator-ultra/examples/example_db_migration.md

@@ -0,0 +1,253 @@
+# Example: db-migration-checker (🟠 Phức tạp — Complexity 16)
+
+> **Nguồn cảm hứng:** Real-world DB migration risks + Anthropic's pdf skill (scripts + resources).
+> **Mức độ:** Phức tạp — SKILL.md + resources/ + examples/ + scripts/.
+> **Tham khảo:** Anthropic's `pdf` skill có SKILL.md 315 dòng + reference.md + forms.md + scripts/.
+
+## 📂 Cấu trúc
+
+```
+skills/db-migration-checker/
+├── SKILL.md                        ← Logic chính (~100 dòng)
+├── README.md
+├── resources/
+│   ├── dangerous_patterns.md      ← Danh sách patterns nguy hiểm
+│   └── rollback_strategies.md     ← Chiến thuật rollback theo DB type
+├── examples/
+│   ├── example_safe_migration.md  ← Case an toàn
+│   └── example_risky_migration.md ← Case nguy hiểm
+└── scripts/
+    └── analyze_migration.py       ← Script parse SQL file
+```
+
+---
+
+## 📄 File 1: SKILL.md
+
+```markdown
+---
+name: db-migration-checker
+description: |
+  Review và đánh giá độ an toàn của file migration SQL/ORM trước khi chạy
+  trên production. Phát hiện breaking changes, data loss risks, locking issues.
+  Dùng khi user nói "review migration", "check migration", "migration safe
+  không", "database migration", "alter table", "schema change", hoặc khi
+  thấy file migration (*.sql, *_migration.py, *.up.sql). KHÔNG dùng cho:
+  viết migration mới, backup database, schema design.
+---
+
+# Goal
+
+Phát hiện 100% migration nguy hiểm TRƯỚC KHI deploy — tránh downtime
+và data loss trên production.
+
+# Mindset
+
+Bạn là **DBA nghiêm khắc** với kinh nghiệm xử lý 50+ production incidents.
+Mặc định mọi migration đều nguy hiểm cho đến khi chứng minh an toàn.
+
+# Instructions
+
+1. Nhận file migration (.sql, .py, .ts, hoặc paste text).
+2. Xác định DB type: PostgreSQL / MySQL / SQLite / MongoDB.
+   - Nếu không rõ → hỏi user
+3. Parse migration → liệt kê operations:
+   - CREATE TABLE, ALTER TABLE, DROP TABLE
+   - ADD COLUMN, DROP COLUMN, RENAME COLUMN
+   - CREATE INDEX, DROP INDEX
+   - INSERT, UPDATE, DELETE (data migration)
+4. Với MỖI operation, check `resources/dangerous_patterns.md`:
+   - 🔴 **CRITICAL**: Data loss, table drop, column rename không backward-compatible
+   - 🟡 **WARNING**: Lock nguy hiểm (ALTER TABLE trên bảng >1M rows)
+   - 🟢 **SAFE**: Additive changes (thêm column nullable, thêm index)
+5. Ước tính lock time:
+   - Table size nếu biết → lock time ≈ f(rows, operation type)
+   - Nếu không biết table size → hỏi user: "Bảng X có bao nhiêu rows?"
+6. Sinh báo cáo theo format:
+
+   ## Migration Review Report
+   
+   | # | Operation | Risk | Lock? | Ghi chú |
+   |---|-----------|------|-------|---------|
+   
+   **Overall Risk: 🔴/🟡/🟢**
+   
+   ### Đề xuất:
+   - [Rollback strategy]
+   - [Safe deployment order]
+
+7. ✅ VERIFY: Mọi DROP/DELETE có rollback strategy?
+   - Nếu thiếu → thêm từ `resources/rollback_strategies.md`
+
+📚 Tham khảo: `resources/dangerous_patterns.md`, `resources/rollback_strategies.md`
+
+# Examples
+
+## Ví dụ 1: Migration an toàn
+**Input:**
+ALTER TABLE users ADD COLUMN avatar_url VARCHAR(255) DEFAULT NULL;
+CREATE INDEX idx_users_email ON users(email);
+
+**Output:**
+| # | Operation | Risk | Lock? | Ghi chú |
+|---|-----------|------|-------|---------|
+| 1 | ADD COLUMN nullable | 🟢 SAFE | ~0s | Additive, không lock |
+| 2 | CREATE INDEX | 🟡 WARN | ~5s (1M rows) | Dùng CONCURRENTLY |
+
+**Overall Risk: 🟢 SAFE** — Chạy được, nhưng nên dùng `CREATE INDEX CONCURRENTLY`.
+
+## Ví dụ 2: Migration nguy hiểm
+**Input:**
+ALTER TABLE orders DROP COLUMN customer_email;
+ALTER TABLE orders RENAME COLUMN total TO amount;
+
+**Output:**
+| # | Operation | Risk | Lock? | Ghi chú |
+|---|-----------|------|-------|---------|
+| 1 | DROP COLUMN | 🔴 CRITICAL | ~10s | DATA LOSS — không thể undo |
+| 2 | RENAME COLUMN | 🔴 CRITICAL | ~10s | App code đang dùng "total" sẽ crash |
+
+**Overall Risk: 🔴 CRITICAL** — KHÔNG CHẠY. Cần 3-phase deployment.
+
+# Constraints
+
+- Mặc định mọi migration = nguy hiểm — "innocent until proven safe" ngược lại
+- DROP/DELETE PHẢI có rollback strategy — vì production không có undo
+- Luôn hỏi table size khi ALTER TABLE — vì lock time phụ thuộc rows
+- Không tự chạy migration — chỉ review, KHÔNG execute
+
+<!-- Generated by Skill Creator Ultra v1.0 -->
+```
+
+---
+
+## 📄 File 2: resources/dangerous_patterns.md
+
+```markdown
+# ⚠️ Dangerous Migration Patterns
+
+## 🔴 CRITICAL — Ngừng ngay, cần redesign
+
+| Pattern | Vì sao nguy hiểm | Giải pháp |
+|---|---|---|
+| `DROP TABLE` | Mất toàn bộ data | Rename → archive → drop sau 30 ngày |
+| `DROP COLUMN` | Mất data column đó | Backup column data trước |
+| `RENAME COLUMN` | App code đang reference tên cũ | 3-phase: add new → migrate → drop old |
+| `ALTER COLUMN type` | Implicit cast có thể fail | Test trên staging trước |
+| `TRUNCATE TABLE` | Mất toàn bộ data, không log | Dùng DELETE + WHERE nếu cần |
+
+## 🟡 WARNING — Xem xét kỹ
+
+| Pattern | Vì sao nguy hiểm | Giải pháp |
+|---|---|---|
+| `ALTER TABLE` on >1M rows | Table lock, downtime | Dùng pt-online-schema-change |
+| `ADD COLUMN NOT NULL` without default | Lock + rewrite toàn bộ table | Thêm DEFAULT hoặc nullable first |
+| `CREATE INDEX` | Lock table (MyISAM) hoặc slow (InnoDB) | Dùng CONCURRENTLY (PostgreSQL) |
+| `UPDATE` toàn bộ table | Lock rows, slow | Batch update 1000 rows/lần |
+
+## 🟢 SAFE — Thường an toàn
+
+| Pattern | Ghi chú |
+|---|---|
+| `ADD COLUMN nullable` | Nhanh, không lock |
+| `CREATE INDEX CONCURRENTLY` | Non-blocking (PostgreSQL only) |
+| `CREATE TABLE` | Bảng mới, không ảnh hưởng existing |
+| `INSERT` vào bảng trống | Không conflict |
+```
+
+---
+
+## 📄 File 3: resources/rollback_strategies.md
+
+```markdown
+# 🔄 Rollback Strategies theo DB Type
+
+## PostgreSQL
+| Operation | Rollback | Command |
+|---|---|---|
+| ADD COLUMN | DROP COLUMN | `ALTER TABLE x DROP COLUMN y;` |
+| CREATE INDEX | DROP INDEX | `DROP INDEX IF EXISTS idx;` |
+| DROP TABLE | Restore from backup | `pg_restore -d db -t table backup.dump` |
+
+## MySQL
+| Operation | Rollback | Command |
+|---|---|---|
+| ADD COLUMN | DROP COLUMN | `ALTER TABLE x DROP COLUMN y;` |
+| CREATE INDEX | DROP INDEX | `DROP INDEX idx ON table;` |
+| DROP TABLE | Restore from backup | `mysqlimport` hoặc point-in-time recovery |
+
+## Quy tắc chung
+1. LUÔN backup trước migration
+2. Chạy migration trong transaction (nếu DB hỗ trợ)
+3. Test trên staging TRƯỚC production
+4. Deploy off-peak hours
+```
+
+---
+
+## 📄 File 4: scripts/analyze_migration.py
+
+```python
+#!/usr/bin/env python3
+"""
+analyze_migration.py — Parse SQL migration file và phát hiện patterns nguy hiểm.
+
+Usage:
+    python analyze_migration.py migration.sql
+    python analyze_migration.py migration.sql --verbose
+    python analyze_migration.py --help
+"""
+
+import sys
+import re
+import argparse
+
+CRITICAL = ["DROP TABLE", "DROP COLUMN", "RENAME COLUMN", "TRUNCATE"]
+WARNING = ["ALTER TABLE", "CREATE INDEX", "UPDATE", "ADD COLUMN .* NOT NULL"]
+SAFE = ["ADD COLUMN .* NULL", "CREATE TABLE", "CREATE INDEX CONCURRENTLY"]
+
+def analyze(sql_content):
+    results = []
+    for line in sql_content.split(";"):
+        line = line.strip().upper()
+        if not line: continue
+        risk = "🟢 SAFE"
+        for p in CRITICAL:
+            if re.search(p, line): risk = "🔴 CRITICAL"; break
+        if risk == "🟢 SAFE":
+            for p in WARNING:
+                if re.search(p, line): risk = "🟡 WARNING"; break
+        results.append({"operation": line[:60], "risk": risk})
+    return results
+
+def main():
+    parser = argparse.ArgumentParser(description="Analyze SQL migration safety")
+    parser.add_argument("file", help="SQL migration file")
+    parser.add_argument("--verbose", "-v", action="store_true")
+    args = parser.parse_args()
+
+    with open(args.file) as f:
+        results = analyze(f.read())
+
+    for r in results:
+        print(f"{r['risk']} | {r['operation']}")
+
+if __name__ == '__main__':
+    main()
+```
+
+---
+
+## 🔍 Phân tích: Tại sao skill này tốt?
+
+| Tiêu chí | Đánh giá | Ghi chú |
+|---|---|---|
+| **Progressive Disclosure** | ✅ | SKILL.md ~100 dòng, details in resources/ |
+| **Explain The Why** | ✅ | "vì production không có undo" |
+| **Role Priming** | ✅ | "DBA nghiêm khắc, 50+ incidents" |
+| **Domain resources** | ✅ | dangerous_patterns.md + rollback_strategies.md |
+| **Script hỗ trợ** | ✅ | analyze_migration.py có --help + --verbose |
+| **Black Box Script** | ✅ | AI dùng --help, không cần đọc source |
+| **Verification Step** | ✅ | "Mọi DROP có rollback strategy?" |
+| **Output Format Anchoring** | ✅ | Table format rõ ràng |
+| **3 mức risk** | ✅ | 🔴 CRITICAL / 🟡 WARNING / 🟢 SAFE |