obsidian-cloudflare-pages

What This Skill Does

The obsidian-cloudflare-pages skill is a powerful automation utility designed to bridge the gap between personal knowledge management and public digital presence. By acting as a specialized CI/CD pipeline for your Obsidian vault, it automates the complex steps required to convert Markdown notes into a professional static website powered by Quartz and hosted on Cloudflare Pages. It manages the entire workflow from selective synchronization of vault folders to the final deployment of your content, ensuring that your publishing process is both safe and repeatable. It respects privacy through frontmatter filtering and folder-based allowlisting, giving you granular control over what reaches the public web.

Installation

To install this skill, use the ClawHub command: clawhub install openclaw/skills/skills/davidyoh/obsidian-cloudflare-pages-skill. After installation, navigate to the skill directory to configure your environment. Initialize your configuration by running the command node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js init, then follow the interactive setup using node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js wizard. Ensure you have Node.js 20+, rsync, npm, and the Cloudflare Wrangler CLI installed on your machine. For authentication, create a Cloudflare API token with Pages permissions and save it in the skill-local .env file for secure access.

Use Cases

This skill is perfect for creators maintaining digital gardens, technical writers publishing documentation from their personal vaults, or students sharing research notes. It is particularly effective for those using the Obsidian Web Clipper to aggregate content, as it allows for a seamless 'clip, organize, and publish' loop. It is ideal for developers who want to avoid manual file management or complex build scripts when updating their portfolio sites or public knowledge bases.

Example Prompts

1. "OpenClaw, run the obsidian-cloudflare-pages sync and build commands to check if my recent updates are ready for the web."
2. "Can you help me set up the deployment for my new digital garden site using the obsidian-cloudflare-pages wizard?"
3. "Please execute a full deployment of my vault using the obsidian-cloudflare-pages run command, and let me know when it goes live."

Tips & Limitations

Always use the doctor command to ensure your dependencies and paths are correctly configured before attempting a full deployment. Remember that the skill excludes private folders by default; verify your frontmatter settings (publish: true) if specific notes are missing from your output. The skill relies on external binaries like rsync and Wrangler, so ensure your system environment variables are correctly inherited or set in the local .env file. Avoid publishing sensitive personal data by double-checking your folder-level permissions, as this skill performs direct file-system operations and network deployments.