skills.rest
rafael-fae
rafael-faeCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

quartz-build-troubleshooting

Diagnose and resolve Quartz 4 build, serve, and routing failures.

5|Updated Jun 3, 2026
Search Tags:#routing#static site#blog#pm2#quartz#build troubleshooting
One-click install
npx skills add https://github.com/rafael-fae/agent-ops-worflow --skill quartz-build-troubleshooting
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: quartz-build-troubleshooting
Source: https://github.com/rafael-fae/agent-ops-worflow/tree/main/archive/skills/operacao/quartz-build-troubleshooting
Command: npx skills add https://github.com/rafael-fae/agent-ops-worflow --skill quartz-build-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose and resolve Quartz 4 build and serve failures for a blog workflow, especially when output cleanup, routing, or configuration issues break the local or PM2-hosted site.

Core Features & Use Cases

  • Build troubleshooting: Fix ENOTEMPTY errors, stale output folders, and rebuild conflicts caused by a running server.
  • Configuration repair: Correct baseUrl settings and remove unwanted tag generation that pollutes the site with excessive tag pages.
  • Serve and routing support: Ensure Quartz serves clean URLs properly instead of relying on a basic HTTP server that cannot handle SPA routing.
  • Operational recovery: Restart, rebuild, and verify the blog pipeline after failures in a production-like environment.

Quick Start

Use this skill to identify the Quartz build or serve problem, apply the correct fix, and verify that the blog is running cleanly again.

Frequently Asked Questions about quartz-build-troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix ENOTEMPTY errors during a Quartz build?▼

Quartz build ENOTEMPTY errors happen when a running server locks the output directory, requiring you to stop the PM2 process, clean the stale output folders, and rebuild to restore the blog.

Why does my Quartz static site return 404s for clean URLs?▼

Quartz clean URL routing fails when using a basic HTTP server that cannot handle SPA routing, requiring the Quartz serve command to properly resolve paths instead of a generic static file server.

How do I remove unwanted tag pages from my Quartz blog deployment?▼

To remove unwanted tag pages from a Quartz blog, you must apply configuration repair to disable tag generation, preventing excessive tag page pollution across the static site output.

Can I use PM2 to manage my Quartz 4 blog in a production-like environment?▼

Yes, PM2 process control supports Quartz 4 blog deployments by managing the serve lifecycle, enabling operational recovery through restart, rebuild, and verification after build failures.

What is the best way to correct baseUrl misconfiguration in Quartz?▼

Correcting Quartz baseUrl misconfiguration involves updating the configuration file to match your deployment path, ensuring the static site generates proper internal links and routes correctly.

Quartz build is not working after output directory conflicts, how do I recover?▼

Recover from Quartz output directory conflicts by stopping the running server, performing filesystem cleanup on the output folder, and executing a clean rebuild to restore the blog pipeline.

Related Skills

Explore More Software Engineering Skills→
davidyohdavidyoh
2

obsidian-cloudflare-pages

Publish Obsidian markdown notes to Cloudflare Pages using Quartz.

Community
Intermediate
MadumtvMadumtv

deploy-to-pages

Deploy static websites to GitHub Pages using branch management and Git commands.

Community
Basic
ceviocevio
1

http-next

Integrate Next.js rendering and API controllers into a Koa HTTP service.

Community
Intermediate
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate