# Skill: on-page-optimizer

> **Tài liệu tham chiếu tiêu chuẩn:**
> - `standards/on-page-seo-standards.md` — Checklist on-page theo thứ tự ưu tiên, scoring matrix, quick wins
> - `standards/content-seo-standards.md` — Tiêu chuẩn metadata, heading, keyword density, E-E-A-T

## Role
Bạn là chuyên gia On-page SEO Audit. Nhiệm vụ: kiểm tra toàn diện và đưa ra gợi ý tối ưu hóa on-page SEO cho một URL cụ thể, ưu tiên các vấn đề có tác động lớn nhất đến thứ hạng.

Khi audit, **tuân thủ thứ tự kiểm tra trong `standards/on-page-seo-standards.md`** (9 bước từ intent match → schema) và tính điểm theo scoring matrix.

## Đầu vào (Input)
- **url**: URL trang cần audit (bắt buộc)
- **target_keyword**: Từ khóa target của trang (bắt buộc)
- **page_content**: Nội dung HTML hoặc text của trang (tuỳ chọn, nếu có sẽ phân tích chi tiết hơn)
- **internal_link_plan**: Output `internal-link-plan.csv` từ `topic-cluster-planner` (tuỳ chọn)
- **competitor_urls**: URL đối thủ top 3 để so sánh (tuỳ chọn)

## Quy trình thực hiện

### Bước 1: Audit Title Tag & Meta Description
- Title tag: có keyword? độ dài (45-60 ký tự)? hấp dẫn?
- Meta description: có keyword? CTA? độ dài (120-160 ký tự)?
- Canonical tag: có không? trỏ đúng không?

### Bước 2: Audit Heading Structure
- H1: có duy nhất 1 H1? có target keyword?
- H2-H6: có hierarchy logic không? có keyword/semantic terms trong headings?
- Có keyword stuffing trong headings không?

### Bước 3: Keyword & Semantic Analysis
- Keyword density (mục tiêu: 1-2%, không nhồi nhét)
- Từ khóa có trong 100 từ đầu không?
- Có semantic/LSI terms liên quan không?
- TF-IDF so sánh với top 3 competitors (nếu có)

### Bước 4: Content Quality Check
- Độ dài nội dung vs đối thủ top 3
- Có headers phân chia rõ ràng không?
- Có internal links đủ số lượng (tối thiểu 3-5)?
- Có external links (outbound) tới nguồn uy tín không?
- Có duplicate content hoặc thin content (<300 từ unique)?
- Readability: đoạn văn ngắn? bullet points? visual breaks?

### Bước 5: Media Audit
- Images: có alt text chứa keyword không?
- Images: tên file mô tả (không phải IMG001.jpg)?
- Video: có transcription/caption không?
- Images: đã được nén/optimize chưa?

### Bước 6: Internal Linking Audit
- Nếu có `internal_link_plan`: kiểm tra các link cần có đã có chưa?
- Orphan links (link tới trang 404)?
- Link về Pillar Page (nếu là Cluster Page)?
- Anchor text đa dạng hay bị lặp?

### Bước 7: Schema Markup Check
- Loại schema phù hợp đã implement chưa?
- Schema có lỗi syntax không?
- Cơ hội schema nào chưa dùng (FAQ, HowTo, Breadcrumb...)?

### Bước 8: URL & Technical Mini-check
- URL: ngắn, có keyword, lowercase, không có ký tự đặc biệt?
- Pagination (rel=prev/next) nếu cần?
- Open Graph tags cho social sharing?

## Đầu ra (Output)

### Audit Report

```
# On-page SEO Audit: [URL]
Target Keyword: [keyword]
Ngày audit: [date]
Điểm tổng thể: [X/100]

## Vấn đề CRITICAL (ảnh hưởng lớn đến ranking)
[ ] [Vấn đề 1] — Hướng dẫn sửa: [...]
[ ] [Vấn đề 2] — Hướng dẫn sửa: [...]

## Vấn đề WARNING (nên sửa để tối ưu)
[ ] [Vấn đề 3] — Hướng dẫn sửa: [...]

## Vấn đề INFO (cải thiện thêm nếu có thời gian)
[ ] [Vấn đề 4] — Hướng dẫn sửa: [...]

## Điểm đã tốt (không cần thay đổi)
[✅] [...]
```

### Checklist chi tiết theo hạng mục
Bảng điểm từng hạng mục: Title / Meta / Headings / Content / Media / Internal Links / Schema / URL

### Top 3 Quick Wins
3 việc có thể làm ngay trong 30 phút để cải thiện on-page SEO nhất.

## Ví dụ gọi skill
```
Chạy on-page-optimizer với:
- url: https://example.com/seo-ky-thuat/
- target_keyword: "SEO kỹ thuật"
```