wjs-converting-wp-to-hugo SKILL.md skillA

wjs-converting-wp-to-hugo from jianshuo/claude-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jianshuo/claude-skills/wjs-converting-wp-to-hugo@git:20260604.a7d43b7

Pins git:20260604.a7d43b7 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jianshuo/claude-skills
Path
wjs-converting-wp-to-hugo/SKILL.md
Versions recorded
4
Latest version
git:20260604.a7d43b7, committed Jun 4, 2026
First version recorded
May 30, 2026
Size
10,929 bytes
Repository stars
138
License
MIT

Use when migrating a WordPress site to a Hugo static site on GitHub Pages from a WXR export (.xml) plus the wp-content/uploads folder — preserving /archives/<id>/ URLs, localizing images, and deploying via GitHub Actions. Triggers — "把 WordPress 迁成 Hugo", "wordpress 转静态站", "migrate WordPress to Hugo", "WXR to Hugo", "publish WordPress to GitHub Pages", "/wjs-converting-wp-to-hugo".

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# wjs-converting-wp-to-hugo

把任意 WordPress 站迁成 **Hugo + Markdown + git** 静态站,部署到 **GitHub Pages**。
输入只需两样,**全程离线、零第三方依赖**:

1. **WXR 导出** — WordPress 后台 `工具 → 导出 → 所有内容` 得到的 `*.xml`(包含全部文章/页面/分类/标签的 HTML 正文)。
2. **`uploads/` 文件夹** — 站点的 `wp-content/uploads/`(按 `年/月` 分目录的图片与附件)。

产出:`content/*.md` + `static/wp-content/uploads/` + 手写极简主题,Hugo 构建,GitHub Actions 发布。
**全站 URL 保持 `/archives/<数字>/` 不变,老链接 100% 不断。**

## When to use

- 用户有一个 WordPress 站,想去掉动态/评论/数据库,改成 git + Markdown 维护。
- 用户提供了 WXR `.xml` 和 `uploads/`(或能拿到)。
- 老链接必须保留(SEO / 外部引用)。

## When NOT to use

- 没有 WXR,只有线上站 → 先在 WP 后台导出,或用 REST API 拉 JSON(本 skill 走 WXR,更可移植)。
- 要保留评论/会员/搜索等动态功能 → 静态站做不了,不适用。
- 站点极小(几篇)→ 手抄更快。

## Core principle

**WXR 是唯一真相源,`uploads/` 直接当静态资源。**
图片不下载、不改名:把 `uploads/` 拷进 `static/wp-content/uploads/`,正文里的图片 URL 改成 **根相对** `/wp-content/uploads/...` 即可原地解析。文章 URL 从 `<link>` 原样保留。转换器是**纯函数 + 单元测试**,先测后写。

## Pipeline

```
WXR .xml + uploads/  →  wxr_to_hugo.py  →  content/*.md + static/wp-content/uploads/  →  hugo build  →  GitHub Actions  →  Pages
```

## Two decisions you MUST ask the user (do not silently decide)

WordPress 里有两类内容静态站处理不了,**必须问用户**,别擅自发布:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jianshuo/claude-skills/wjs-converting-wp-to-hugo@sha256:477a7ddc4103516c

The line at the top of this page pins the label git:20260604.a7d43b7, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_rztbq2ags24ry7sv.svg)](https://markdownregistry.com/a/art_rztbq2ags24ry7sv)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between May 30, 2026 and Jun 4, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20260604.a7d43b7 latest2026-06-04 a7d43b7 10,929 BA view · diff
git:20260604.e2b485e2026-06-04 e2b485e 10,598 BA view · diff
git:20260530.8c246342026-05-30 8c24634 9,831 BA view · diff
git:20260530.acce7a52026-05-30 acce7a5 9,449 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10929 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

jianshuo/claude-skills · 138 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rztbq2ags24ry7sv
GET https://markdownregistry.com/api/v1/resolve?ref=jianshuo/claude-skills/wjs-converting-wp-to-hugo
GET https://markdownregistry.com/api/v1/blob/477a7ddc4103516cc945de626065087e43df8ae41a697f8a3212123f5f66ca5d

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from jianshuo/claude-skills

wangjianshuo-perspective SKILL.md skill
jianshuo/claude-skills · wangjianshuo-perspective/SKILL.md · 王建硕的思维框架与表达方式。基于 7 份深度调研(约 100 万词英文博客 + 约 109 万字中文博客, 2002–2022,全部一手)提炼出 7 个核心心智模型、10 条决策启发式和完整的双语表达…
git:20260517.4dbe939 · audit A · 138 stars
wjs-auditing-project SKILL.md skill
jianshuo/claude-skills · wjs-auditing-project/SKILL.md · Use when the user asks to audit what's wrong with a project, "make it right", "看看项目出了什么问题", "为什么用户的需求还没上线", "为什么没提交App…
git:20260512.543ca8b · audit A · 138 stars
wjs-burning-subtitles SKILL.md skill
jianshuo/claude-skills · wjs-burning-subtitles/SKILL.md · Use when the user has a video + an SRT and wants the subtitles either burned into the pixels (libass, always-visible)…
git:20260512.543ca8b · audit A · 138 stars
wjs-cleaning-spam SKILL.md skill
jianshuo/claude-skills · wjs-cleaning-spam/SKILL.md · Use when the user complains about spam on his X/Twitter posts — 同城面付 / 寻固炮 / 线下上门 / 免费破处 这类引流号在他推文下刷的 emoji 垃圾回复 — and…
git:20260610.c496d29 · audit A · 138 stars
wjs-converting-text-to-video SKILL.md skill
jianshuo/claude-skills · wjs-converting-text-to-video/SKILL.md · Use when the user wants a 王建硕-style WeChat article (article.md) turned into a narrated short MP4 video — TTS voiceover…
git:20260525.b5d2f5b · audit B · 138 stars
wjs-creating-video-book SKILL.md skill
jianshuo/claude-skills · wjs-creating-video-book/SKILL.md · Use when the user wants a book turned into YouTube chapter videos — 每章用 VoiceDrop 读书的有声书 mp3 做音轨,配 GPT Image 2…
git:20260817.25922c1 · audit A · 138 stars
DESIGN.md@wjs-distilling-style DESIGN.md file
jianshuo/claude-skills · wjs-distilling-style/DESIGN.md
git:20260620.2f8ced5 · audit A · 138 stars
wjs-distilling-style SKILL.md skill
jianshuo/claude-skills · wjs-distilling-style/SKILL.md · Use when the user wants to capture a writer's voice from a few sample articles and rewrite text to sound like that…
git:20260701.c459352 · audit A · 138 stars
wjs-dubbing-video SKILL.md skill
jianshuo/claude-skills · wjs-dubbing-video/SKILL.md · Use when the user has a video + a target-language SRT and wants the video to actually speak that language — generates a…
git:20260512.543ca8b · audit A · 138 stars
wjs-eating-and-growing SKILL.md skill
jianshuo/claude-skills · wjs-eating-and-growing/SKILL.md · 吃一堑长一智 — 走完 5 步交互式反思(堑 → 自动输出 → 旧权重 → 新参数 → 替代动作),从「情绪复盘」推进到「行为训练」,把第一反应这一层 L3 权重练新。Use when 王建硕 reflects on a personal…
git:20260518.5644746 · audit A · 138 stars
wjs-editing-multicam SKILL.md skill
jianshuo/claude-skills · wjs-editing-multicam/SKILL.md · Use when the user has 2+ recordings of the same event (each with a `.sync.json` sidecar from wjs-syncing-multicam) and…
git:20260526.587665f · audit A · 138 stars
wjs-evaling-voicedrop-prompts SKILL.md skill
jianshuo/claude-skills · wjs-evaling-voicedrop-prompts/SKILL.md · Use when 王建硕 wants to evaluate whether a change to VoiceDrop's 挖矿 system prompt is actually better than the live…
git:20260630.b59fc57 · audit A · 138 stars

Every file in jianshuo/claude-skills

Browse by kind, by grade A, or by owner.