Bto Page Quality

Name: Bto Page Quality
Author: sonpiaz

ASecurity

Đo và cải thiện chất lượng trang web — tốc độ, Core Web Vitals, trải nghiệm theo quốc gia, hiển thị trên search, cache edge. Dùng khi hỏi "trang chậm", LCP/INP/CLS, bounce theo nước, điểm Lighthouse, hoặc trước/sau thay đổi frontend. Khớp Buổi 5 (log, cảnh báo) và Buổi 8 (đo sau launch).

6 stars

0 votes

0 copies

0 views

Added 9/28/2026

ai-agentsgobashnodegitapifrontendsecurity

Works with

cliapi

Security Analysis

A100/100

Scanned 9/28/2026

Install to Claude Code

$npx -y skills add sonpiaz/bto-skills --skill bto-page-quality --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Bto Page Quality?

Add the live security badge to your README — it updates automatically with every re-scan.

Security grade badge for Bto Page Quality

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/sonpiaz-bto-page-quality/badge)](https://www.skillsdirectory.com/skills/sonpiaz-bto-page-quality)

More formats (shields.io, HTML) on the badges page.

Files

SKILL.md

---
name: bto-page-quality
description: Đo và cải thiện chất lượng trang web — tốc độ, Core Web Vitals, trải nghiệm theo quốc gia, hiển thị trên search, cache edge. Dùng khi hỏi "trang chậm", LCP/INP/CLS, bounce theo nước, điểm Lighthouse, hoặc trước/sau thay đổi frontend. Khớp Buổi 5 (log, cảnh báo) và Buổi 8 (đo sau launch).
---

# /bto-page-quality

Một câu hỏi: **site có tốt không, và với ai?** Trả lời bằng nhiều nguồn — không một tab duy nhất.

---

## Bốn bẫy đã từng gây kết luận sai

**1. Headless browser chiếm p75 trang ít traffic.** PostHog/Web Vitals có thể báo LCP 20–30s trong khi PageSpeed mobile ~99. Mẫu hai cụm: nhanh hoặc >10s, không giữa — thường là bot Linux desktop (FCP = LCP). Lọc LCP ≥ 10s trước khi tin tab RUM thô.

**2. Operator không phải thị trường.** `/admin` với vài chục sample có thể là một người. Loại path admin/internal khỏi báo cáo công khai.

**3. Một lần chạy Lighthouse mobile không phải đo.** Cùng code, cùng ngày, delta hàng trăm ms là bình thường. Mobile: median ≥3 lần; spread nhỏ hơn delta mới là delta. Spread = 0 có thể là cache PSI — so across reports, không trong một report.

**4. CrUX thiếu quốc gia ≠ "ổn ở đó".** Chỉ có đủ traffic Chrome thật mới publish. Không có row = chưa đủ data, không phải nhanh.

---

## Năm nguồn — mỗi nguồn trả lời một câu

| Nguồn | Câu hỏi duy nhất | Cách lấy (generic) |
|---|---|---|
| **field** — CrUX | Chrome user thật đo gì; số Google ranking dùng | CrUX API hoặc BigQuery `chrome-ux-report` |
| **lab** — PageSpeed | Input cố định → deploy nào gây thay đổi | PageSpeed Insights API |
| **rum** — analytics | Country × path; trang chậm *chỉ* ở đâu đó | PostHog, Plausible, GA4 BigQuery, … |
| **search** — Search Console | Google **show** gì; market thấy mà không click | GSC API |
| **edge** — headers | HTML từ cache gần user hay bay xa | `curl -I` production |

CrUX API không có country; BigQuery `country_summary` có — ~1.5 GB/scan, lag ~2 tháng. Dùng sizing reach, không chỉ speed.

---

## Script đo trong repo (khuyến nghị)

Tạo một lệnh (ví dụ `npm run quality:page` hoặc script trong `scripts/`) gom nguồn:

```bash
# Ví dụ shape — thay bằng repo bạn
bun run quality:page                  # full (~ vài phút nếu có PSI)
bun run quality:page --skip=lab       # bỏ Lighthouse
bun run quality:page --only=rum
bun run quality:page --json
bun run quality:page --days=7
```

Secret đọc từ env (`CRUX_API_KEY`, analytics key, GSC service account JSON). Script **fail loudly** khi thiếu nguồn — không in zero giả.

---

## Sửa cái script tìm ra

**Trang logged-in quan trọng hơn landing** nếu khách trả tiền dùng dashboard hàng ngày. Cả hai trên list thì ưu tiên app/authenticated trước marketing.

**Cache HTML ở edge + App Router RSC** dễ gãy: một URL, hai body (`vary: rsc`). Cache rule match nhầm → client navigation nhận HTML document. Trước khi cache HTML: verify RSC vẫn bypass; có rollback snapshot; không overwrite snapshot rollback.

**Rank tốt, CTR thấp → xem QUERY trước title.** Brand query (`tên bạn + api`) tự nhiên CTR thấp ở page phụ. Chỉ sửa title khi query là intent không-brand. Loại `site:` search tự gây impression.

**Byte weight là lever bạn kiểm soát.** Budget ảnh (KB, max width), guard SSR payload trong CI.

---

## Gap thường gặp (ưu tiên theo giá trị/giờ)

| Gap | Hậu quả | Fix |
|---|---|---|
| Không uptime monitor bên thứ ba | "Không hỏng" không có witness | UptimeRobot/Better Stack free tier |
| Crash email bị filter | Production die im lặng | Bỏ filter hoặc route Telegram |
| Node/runtime EOL | Build fail đột ngột | Theo deadline platform |
| RLS/table mới thiếu policy | Data leak flag | Audit + CI guard |
| Không CWV gate CI | Deploy regress LCP im lặng | `quality:page --json` + threshold |

Workflow tuần: cron GitHub Actions chạy report vào summary; cần secret trong repo settings.

---

## Email / alert nên skim hàng tháng

Search Console (indexing, structured data), analytics weekly digest, deploy fail platform, host crash, DB security advisor, DMARC XML — bổ sung những gì API không expose.

---

## Mở rộng skill

Thêm nguồn chỉ khi trả lời câu hỏi mà năm nguồn trên không trả lời được. Ngưỡng đổi thì đổi trong script kèm lý do đo được.

**Rule of three:** lần thứ ba viết ad-hoc query CWV/GSC cho cùng câu hỏi → đưa vào script/skill.

Attribution

sonpiaz

View source More from sonpiaz →

SSkills DirectorySkills Directory

Ship a skill? Prove it's safe.

Free 120-pattern security scan, letter grade, and an embeddable README badge.

Submit a skill

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments (0)

No comments yet. Be the first to comment!

--- name: bto-page-quality description: Đo và cải thiện chất lượng trang web — tốc độ, Core Web Vitals, trải nghiệm theo quốc gia, hiển thị trên search, cache edge. Dùng khi hỏi "trang chậm", LCP/INP/CLS, bounce theo nước, điểm Lighthouse, hoặc trước/sau thay đổi frontend. Khớp Buổi 5 (log, cảnh báo) và Buổi 8 (đo sau launch). --- # /bto-page-quality Một câu hỏi: **site có tốt không, và với ai?** Trả lời bằng nhiều nguồn — không một tab duy nhất. --- ## Bốn bẫy đã từng gây kết luận sai **1. Headless browser chiếm p75 trang ít traffic.** PostHog/Web Vitals có thể báo LCP 20–30s trong khi PageSpeed mobile ~99. Mẫu hai cụm: nhanh hoặc >10s, không giữa — thường là bot Linux desktop (FCP = LCP). Lọc LCP ≥ 10s trước khi tin tab RUM thô. **2. Operator không phải thị trường.** `/admin` với vài chục sample có thể là một người. Loại path admin/internal khỏi báo cáo công khai. **3. Một lần chạy Lighthouse mobile không phải đo.** Cùng code, cùng ngày, delta hàng trăm ms là bình thường. Mobile: median ≥3 lần; spread nhỏ hơn delta mới là delta. Spread = 0 có thể là cache PSI — so across reports, không trong một report. **4. CrUX thiếu quốc gia ≠ "ổn ở đó".** Chỉ có đủ traffic Chrome thật mới publish. Không có row = chưa đủ data, không phải nhanh. --- ## Năm nguồn — mỗi nguồn trả lời một câu | Nguồn | Câu hỏi duy nhất | Cách lấy (generic) | |---|---|---| | **field** — CrUX | Chrome user thật đo gì; số Google ranking dùng | CrUX API hoặc BigQuery `chrome-ux-report` | | **lab** — PageSpeed | Input cố định → deploy nào gây thay đổi | PageSpeed Insights API | | **rum** — analytics | Country × path; trang chậm *chỉ* ở đâu đó | PostHog, Plausible, GA4 BigQuery, … | | **search** — Search Console | Google **show** gì; market thấy mà không click | GSC API | | **edge** — headers | HTML từ cache gần user hay bay xa | `curl -I` production | CrUX API không có country; BigQuery `country_summary` có — ~1.5 GB/scan, lag ~2 tháng. Dùng sizing reach, không chỉ speed. --- ## Script đo trong repo (khuyến nghị) Tạo một lệnh (ví dụ `npm run quality:page` hoặc script trong `scripts/`) gom nguồn: ```bash # Ví dụ shape — thay bằng repo bạn bun run quality:page # full (~ vài phút nếu có PSI) bun run quality:page --skip=lab # bỏ Lighthouse bun run quality:page --only=rum bun run quality:page --json bun run quality:page --days=7 ``` Secret đọc từ env (`CRUX_API_KEY`, analytics key, GSC service account JSON). Script **fail loudly** khi thiếu nguồn — không in zero giả. --- ## Sửa cái script tìm ra **Trang logged-in quan trọng hơn landing** nếu khách trả tiền dùng dashboard hàng ngày. Cả hai trên list thì ưu tiên app/authenticated trước marketing. **Cache HTML ở edge + App Router RSC** dễ gãy: một URL, hai body (`vary: rsc`). Cache rule match nhầm → client navigation nhận HTML document. Trước khi cache HTML: verify RSC vẫn bypass; có rollback snapshot; không overwrite snapshot rollback. **Rank tốt, CTR thấp → xem QUERY trước title.** Brand query (`tên bạn + api`) tự nhiên CTR thấp ở page phụ. Chỉ sửa title khi query là intent không-brand. Loại `site:` search tự gây impression. **Byte weight là lever bạn kiểm soát.** Budget ảnh (KB, max width), guard SSR payload trong CI. --- ## Gap thường gặp (ưu tiên theo giá trị/giờ) | Gap | Hậu quả | Fix | |---|---|---| | Không uptime monitor bên thứ ba | "Không hỏng" không có witness | UptimeRobot/Better Stack free tier | | Crash email bị filter | Production die im lặng | Bỏ filter hoặc route Telegram | | Node/runtime EOL | Build fail đột ngột | Theo deadline platform | | RLS/table mới thiếu policy | Data leak flag | Audit + CI guard | | Không CWV gate CI | Deploy regress LCP im lặng | `quality:page --json` + threshold | Workflow tuần: cron GitHub Actions chạy report vào summary; cần secret trong repo settings. --- ## Email / alert nên skim hàng tháng Search Console (indexing, structured data), analytics weekly digest, deploy fail platform, host crash, DB security advisor, DMARC XML — bổ sung những gì API không expose. --- ## Mở rộng skill Thêm nguồn chỉ khi trả lời câu hỏi mà năm nguồn trên không trả lời được. Ngưỡng đổi thì đổi trong script kèm lý do đo được. **Rule of three:** lần thứ ba viết ad-hoc query CWV/GSC cho cùng câu hỏi → đưa vào script/skill.