skills.rest
jianshuo
jianshuoCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

wjs-converting-wp-to-hugo

Convert WordPress XML exports to Hugo Markdown and deploy to GitHub Pages.

114|17|Updated May 11, 2026
Search Tags:#WordPress#GitHub Pages#Hugo#static site generation#site migration
One-click install
npx skills add https://github.com/jianshuo/claude-skills --skill wjs-converting-wp-to-hugo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wjs-converting-wp-to-hugo
Source: https://github.com/jianshuo/claude-skills/tree/main/wjs-converting-wp-to-hugo
Command: npx skills add https://github.com/jianshuo/claude-skills --skill wjs-converting-wp-to-hugo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill simplifies the process of migrating a WordPress site to a static site using Hugo and GitHub Pages, ensuring URL preservation and local image management.

Core Features & Use Cases

  • WordPress to Hugo Conversion: Convert WordPress content to Hugo-compatible Markdown files.
  • URL Preservation: Keeps the original site URLs, preserving SEO and links.
  • Local Image Management: Localizes images from the WordPress uploads folder for use in the static site.
  • GitHub Actions Deployment: Automates the deployment process using GitHub Actions.

Quick Start

To convert your WordPress site to a Hugo static site and deploy it to GitHub Pages, run the following commands:

cp -r wjs-converting-wp-to-hugo ~/.claude/skills/
python3 scripts/wxr_to_hugo.py <path_to_wxr_file>.xml
hugo --gc --minify
gh repo create <site> --public --source=. --remote=origin
git push -u origin main
gh api -X POST repos/<owner>/<site>/pages -f build_type=workflow
gh workflow run "Deploy Hugo site to Pages" --repo <owner>/<site>

Frequently Asked Questions about wjs-converting-wp-to-hugo

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

FAQPage Schema
How do I convert a WordPress XML export to Hugo Markdown files?▼

To convert a WordPress XML export to Hugo Markdown files, run a Python script that parses the .xml file and generates Hugo-compatible static site content while preserving original URLs for SEO.

What is the best way to migrate WordPress images to a Hugo static site?▼

The best way to migrate WordPress images to a Hugo static site is to localize them directly from the wp-content uploads folder, ensuring all referenced media is downloaded and managed locally within the generated static site structure.

Do I need Python to migrate a WordPress site to Hugo and GitHub Pages?▼

Yes, you need Python installed to execute the conversion scripts that transform the WordPress XML export into Hugo static site files before deploying them to GitHub Pages.

Can I automate Hugo site deployment to GitHub Pages using GitHub Actions?▼

Yes, you can automate Hugo site deployment to GitHub Pages by triggering a GitHub Actions workflow, which builds the static site and publishes the content directly to your GitHub repository.

Does migrating from WordPress to Hugo preserve my original site URLs?▼

Migrating from WordPress to Hugo preserves your original site URLs, maintaining existing SEO rankings and preventing broken inbound links after the static site generation and deployment process.

What are the limitations of using Hugo for static site generation from WordPress?▼

A limitation of using Hugo for static site generation from WordPress is losing dynamic server-side features like contact forms or user comments, as the output consists entirely of static files deployed to GitHub Pages.

Related Skills

Explore More Product & Management Skills→
CrazySwamiCrazySwami
5

wordpress-admin

Manage WordPress sites via WP-CLI and REST for content, SEO, and media.

Community
Advanced
therealbilltherealbill
3

Hugo GitHub Actions

Automate Hugo site deployment to GitHub Pages with a GitHub Actions workflow.

Community
Advanced
mahg-esmahg-es
3

static-site-generate

Generate static websites from Markdown into deployable HTML with CI workflows.

Official
Intermediate
koolamusickoolamusic
1

wp-to-jekyll

Migrates WordPress sites to Jekyll, preserving content via XML or scraped HTML.

Community
Advanced