# gen-blog-quality-baseline

> Evaluate gen-blog output quality and regression risk by measuring dist size, posts index size, home payload, and cover image sizes. Use when reviewing generated static output (dist/) for performance or content degradation, especially after adding many posts or assets.

- Author: jiachen
- Repository: yujiachen-y/gen-blog
- Version: 20260208213926
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-08
- Source: https://github.com/yujiachen-y/gen-blog
- Web: https://mule.run/skillshub/@@yujiachen-y/gen-blog~gen-blog-quality-baseline:20260208213926

---

---
name: gen-blog-quality-baseline
description: Evaluate gen-blog output quality and regression risk by measuring dist size, posts index size, home payload, and cover image sizes. Use when reviewing generated static output (dist/) for performance or content degradation, especially after adding many posts or assets.
---

# Gen Blog Quality Baseline

## Overview

Run a lightweight quality check against `dist/` after `npm run generate` to spot early regressions in payload size, HTML growth, and image bloat.

## Workflow

### 1) Generate the site

Run the generator first to produce `dist/`.

```
npm run generate -- <markdownDir> dist
```

### 2) Run the baseline script

Use the bundled script. Defaults match the recommended thresholds in `references/thresholds.md`.

```
node .codex/skills/gen-blog-quality-baseline/scripts/quality_baseline.js --dist dist
```

Optional overrides:

```
node .codex/skills/gen-blog-quality-baseline/scripts/quality_baseline.js \
  --dist dist \
  --max-home-kb 1024 \
  --max-total-mb 120 \
  --max-cover-kb 1800 \
  --max-html-mb 15 \
  --max-page-kb 400
```

Use JSON output for machine parsing:

```
node .codex/skills/gen-blog-quality-baseline/scripts/quality_baseline.js --dist dist --json
```

### 3) Interpret results

- **Failures** indicate hard regressions (e.g., missing `index.html`, oversized post index).
- **Warnings** indicate growing performance risk (home payload, HTML total, oversized images).
- Use the thresholds as a starting point; tune once real usage data is available.

### 4) Fix warnings quickly

Avoid persistent warnings to prevent alert fatigue. See `references/remediation.md` for common fixes.

## Resources

### scripts/

- `scripts/quality_baseline.js`: Computes size metrics and validates thresholds.

### references/

- `references/thresholds.md`: Recommended baseline thresholds and scaling guidance.
- `references/remediation.md`: Common fixes to clear warnings.