# 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.

- Skill: `yujiachen-y/gen-blog-quality-baseline` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add yujiachen-y/gen-blog-quality-baseline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yujiachen-y/gen-blog-quality-baseline/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: yujiachen-y (https://skillmd.com/u/yujiachen-y)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yujiachen-y/gen-blog-quality-baseline

---


# 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.