Agent skill

Wjs Publishing Hugo

by jianshuo in jianshuo/claude-skills

当用户想给自己的 Hugo 静态博客(如 maggiacito.com)新增或编辑帖子、管理类目、上传图片并发布上线时使用——对话式后台,说一句就改文件、commit、推送、自动部署,不需要任何 CMS/服务器。触发词:「发一篇博客」「给 Hugo 加文章」「写篇帖子到博客」「管理博客类目」「上传图片到博客」「博客后台」「/wjs-publishing-hugo」。

MITAuto-check passedFrontend & Design

Install Wjs Publishing Hugo

skills CLI
$ npx skills add jianshuo/claude-skills --skill wjs-publishing-hugo -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jianshuo/claude-skills wjs-publishing-hugo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jianshuo/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/wjs-publishing-hugo .claude/skills/wjs-publishing-hugo && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
wjs-publishing-hugo
GitHub stars
131
Token cost
~707 tokens
SKILL.md length
181 words
Files
6 (incl. scripts)
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

当用户想给自己的 Hugo 静态博客(如 maggiacito.com)新增或编辑帖子、管理类目、上传图片并发布上线时使用——对话式后台,说一句就改文件、commit、推送、自动部署,不需要任何 CMS/服务器。触发词:「发一篇博客」「给 Hugo 加文章」「写篇帖子到博客」「管理博客类目」「上传图片到博客」「博客后台」「/wjs-publishing-hugo」。

  • Works in 5 steps: 新增帖子 → 编辑帖子 → 管理类目 → …
  • Tasks that involve Static sites and blogs
  • SKILL.md covers 前置检测(每次开工先做), 帖子的权威格式(maggiacito 现状), 工作流 and 范围(YAGNI), plus 1 more section
  • Runs Python and Shell scripts from its folder; calls python3, bash and git; needs GITHUB_TOKEN

What it does

Wjs Publishing Hugo is an agent skill from jianshuo/claude-skills. 当用户想给自己的 Hugo 静态博客(如 maggiacito.com)新增或编辑帖子、管理类目、上传图片并发布上线时使用——对话式后台,说一句就改文件、commit、推送、自动部署,不需要任何 CMS/服务器。触发词:「发一篇博客」「给 Hugo 加文章」「写篇帖子到博客」「管理博客类目」「上传图片到博客」「博客后台」「/wjs-publishing-hugo」。

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `README.md`, `scripts/add-image.py` and `scripts/categories.sh`).

It sits in Frontend & Design, covering Static sites and blogs. It works with GitHub. The repository describes itself as: 13 Claude Code skills for video production (transcribe / translate / dub / multicam / subtitles / reframe) + WeChat publishing. Compatible with Claude Code, OpenAI Codex CLI… The licence is MIT.

When your agent uses it

  • Tasks that involve Static sites and blogs

Example prompts

  • “/wjs-publishing-hugo”

Requirements

  • Python 3
  • A Bash shell
  • A credential in GITHUB_TOKEN

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 新增帖子
  2. 编辑帖子
  3. 管理类目
  4. 上传图片
  5. 发布上线

What it can do on your machine

Read from SKILL.md and the folder at commit b2690f5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 4 files in scripts/ (Python and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • bash
    • git
    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git and gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GITHUB_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Wjs Publishing Hugo loads about 707 tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 181 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~707

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from jianshuo/claude-skills at commit b2690f5, republished under its MIT licence (© jianshuo). 181 words, ~707 tokens.

Download SKILL.mdSave it as .claude/skills/wjs-publishing-hugo/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
wjs-publishing-hugo
description
当用户想给自己的 Hugo 静态博客(如 maggiacito.com)新增或编辑帖子、管理类目、上传图片并发布上线时使用——对话式后台,说一句就改文件、commit、推送、自动部署,不需要任何 CMS/服务器。触发词:「发一篇博客」「给 Hugo 加文章」「写篇帖子到博客」「管理博客类目」「上传图片到博客」「博客后台」「/wjs-publishing-hugo」。

wjs-publishing-hugo

Hugo 博客的对话式后台。我就是后台——没有 CMS、没有 /admin 页面、没有 PAT、没有 Cloudflare。 你说要发什么,我按仓库约定改 content/、放图、commit、push,走仓库现有部署流自动上线。

适用:maggiacito.com 这类 Hugo 站(content/posts/*.md + categories/tags taxonomy + GitHub Pages Actions 部署)。其它 Hugo 仓库也能用,先按下面「前置检测」对齐约定。

前置检测(每次开工先做)

  1. 确认在 Hugo 仓库根:有 hugo.toml(或 config.toml)和 content/。不在就让用户给路径。
  2. 读 hugo.toml:拿 timeZone、[taxonomies](确认 categories/tags)。
  3. 看一篇现有帖子的 front matter(content/posts/ 里随便挑一篇),确认字段与下面「权威格式」一致; 不一致就以仓库现状为准,别套用本文档的默认。

帖子的权威格式(maggiacito 现状)

文件:content/posts/<slug>.md。front matter 严格如下,日期用 YYYY-MM-DD HH:MM:SS(Asia/Shanghai):

---
title: "标题"
date: 2026-06-04 21:30:00
lastmod: 2026-06-04 21:30:00
categories: ["知天命"]
tags: []
url: /知天命/标题/
---

正文 markdown……
  • url 显式写 /<主类目>/<标题或slug>/(沿用 WordPress 迁来的链接风格;类目和标题可含中文)。
  • categories / tags 是字符串数组,可空 []。
  • 不要手写 front matter——用 scripts/new-post.py 生成,格式才不会漂。

工作流

1. 新增帖子

拿到标题 + 正文(用户给草稿/链接/零散思路都行;要润色按需润),选好类目,然后:

echo "<正文 markdown>" | python3 <SKILL_DIR>/scripts/new-post.py \
  --repo <仓库根> --title "标题" --category "知天命" --slug 可选英文slug

脚本生成 content/posts/<slug>.md 并打印路径。不传 --slug 时按标题派生文件名(中文也行,文件名读者看不到)。 不传 --url 时默认 /<首个类目>/<标题或slug>/。需要别的链接用 --url 覆盖。

2. 编辑帖子

直接改对应 content/posts/*.md:改正文随意;改了内容把 lastmod 更新成当前时间,date 不动。

3. 管理类目
  • 先列现有类目给用户挑(避免造重复):bash <SKILL_DIR>/scripts/categories.sh <仓库根>
  • 新类目:现场加进帖子的 categories[] 即可,Hugo taxonomy 自动建 /categories/<名>/ 页,无需别的配置。
  • 改名/合并类目:扫所有 content/posts/*.md 的 categories[] 批量替换(这是 CMS 做不到、我能做的)。改完提醒用户旧的 /categories/<旧名>/ 链接会失效。
4. 上传图片

新图放 static/uploads/<年>/(served 为 /uploads/...);老的 static/wp-content/uploads/ 不动。

python3 <SKILL_DIR>/scripts/add-image.py <本地图片> --repo <仓库根> --alt "说明"

打印一行 markdown 图片链接,插进正文。超 2000px 宽的图会用 macOS sips 自动缩小。

5. 发布上线

本地预览(可选):hugo server -D → 看 http://localhost:1313 。 确认后发布:

bash <SKILL_DIR>/scripts/publish.sh "post: <标题>" <仓库根>

普通用户的 git push 会触发 deploy.yml(on: push)构建上线——只有反馈机器人那种 GITHUB_TOKEN 推送才会被 GitHub 防递归挡掉,你自己推不受影响。push 完可 gh run watch 看部署。

范围(YAGNI)

只做:新增/编辑帖子、管理类目、上传图片、发布。不做评论、用户管理、草稿工作流、定时发布。

常见错误

  • ❌ 手写 front matter 导致日期格式/字段漂移 → ✅ 一律走 new-post.py。
  • ❌ 图片塞进 static/wp-content/uploads/(那是迁移来的历史目录)→ ✅ 新图进 static/uploads/。
  • ❌ 改了帖子忘了更 lastmod → ✅ 编辑后同步 lastmod。
  • ❌ 造了和现有同名/近义的类目 → ✅ 先 categories.sh 看一遍再定。
  • ❌ 以为 push 不会自动部署(被反馈闭环那条 GITHUB_TOKEN 限制误导)→ ✅ 你本人 push 会触发 deploy.yml。
  • ❌ 设了会撞车的 url(和已有帖子重复)→ ✅ 用 categories.sh/grep 查重,必要时 --url 指定唯一路径。

© jianshuo, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts) in wjs-publishing-hugo of jianshuo/claude-skills.

  • SKILL.md
  • README.md
  • scripts/add-image.py
  • scripts/categories.sh
  • scripts/new-post.py
  • scripts/publish.sh

Open the folder on GitHubat commit b2690f5

Compare with similar skills

Wjs Publishing Hugo next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Wjs Publishing Hugo compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wjs Publishing Hugo this skilljianshuo/claude-skills131—~707Automated safety check: PassMIT
Great Docspymc-labs/pathmc132—~2.7kAutomated safety check: PassMIT
Publish AI Sitebubblevv/ai-api-gongyi-nav102—~959Automated safety check: PassNone
Linkyee Style DesignerZhgChgLi/linkyee180—~4.4kAutomated safety check: NotesMIT
Site Operationsauthcrunch/authcrunch.github.io108—~3.2kAutomated safety check: PassNone
GitHub Pages Publisherartwist-polyakov/polyakov-claude-skills208—~1.2kAutomated safety check: PassMIT

Similar skills

  • Great Docs

    pymc-labs/pathmc

    Generate documentation sites for Python packages with Great Docs.

    132 GitHub stars~2.7k tokensUpdated 8 days ago
    Frontend & DesignAuto-check passed
  • Publish AI Site

    bubblevv/ai-api-gongyi-nav

    A skill your agent uses when adding or publishing an AI API public-benefit or relay-site listing from promotional copy in this repository, including validating the referral link, regenerating the…

    102 GitHub stars~959 tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Linkyee Style Designer

    ZhgChgLi/linkyee

    A skill your agent uses when the user wants to design, customize, or generate a custom visual theme for their linkyee site (a Hexo-like LinkTree-style static site).

    180 GitHub stars~4.4k tokensUpdated yesterday
    Frontend & DesignAuto-check: notes
  • Site Operations

    authcrunch/authcrunch.github.io

    Install, build, preview, and troubleshoot the AuthCrunch documentation site; maintain npm dependencies, local command workflows, and GitHub Pages CI.

    108 GitHub stars~3.2k tokensUpdated 5 days ago
    Frontend & DesignAuto-check passed
  • GitHub Pages Publisher

    artwist-polyakov/polyakov-claude-skills

    Publishes already-built static pages to a GitHub Pages repo under a year, year-month and slug folder layout, optimizes large images and returns the public URL.

    208 GitHub stars~1.2k tokensUpdated 2 days ago
    DevOps & CloudAuto-check passed
  • Markdown

    facioquo/stock-indicators-dotnet

    Format and lint Markdown in this repository against GitHub Flavored Markdown and its markdownlint-cli2 configuration — headers, lists, code fences, callouts (VitePress containers on docs-site pages…

    1.2k GitHub stars~812 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed

More from jianshuo/claude-skills

All 38 skills in this repo
  • Wjs Segmenting Video

    jianshuo/claude-skills

    A skill your agent uses when the user has a long-form video (interview / lecture / podcast / conversation) and a transcript SRT, and wants to extract 3–6 stand-alone topical short clips from it.

    131 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Wjs Uploading Video

    jianshuo/claude-skills

    Upload one or many videos to YouTube. An agent skill from jianshuo/claude-skills.

    131 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Wjs Converting Wp To Hugo

    jianshuo/claude-skills

    A skill your agent uses 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…

    131 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Wjs Burning Subtitles

    jianshuo/claude-skills

    A skill your agent uses when the user has a video + an SRT and wants the subtitles either burned into the pixels (libass, always-visible) or soft-muxed as a togglable track.

    131 GitHub stars~3k tokensUpdated 1 mo ago
    Auto-check passed
  • Wjs Cleaning Spam

    jianshuo/claude-skills

    A skill your agent uses when the user complains about spam on his X/Twitter posts — 同城面付 / 寻固炮 / 线下上门 / 免费破处 这类引流号在他推文下刷的 emoji 垃圾回复 — and wants them removed.

    131 GitHub stars~532 tokensUpdated 1 mo ago
    Auto-check passed
  • Wjs Creating Video Book

    jianshuo/claude-skills

    A skill your agent uses when the user wants a book turned into YouTube chapter videos — 每章用 VoiceDrop 读书的有声书 mp3 做音轨,配 GPT Image 2 画面和中心思想大字,输出 1920×1080 横屏视频发 YouTube。Triggers — "把这本书做成视频"…

    131 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Wjs Publishing Hugo

What does Wjs Publishing Hugo do?

当用户想给自己的 Hugo 静态博客(如 maggiacito.com)新增或编辑帖子、管理类目、上传图片并发布上线时使用——对话式后台,说一句就改文件、commit、推送、自动部署,不需要任何 CMS/服务器。触发词:「发一篇博客」「给 Hugo 加文章」「写篇帖子到博客」「管理博客类目」「上传图片到博客」「博客后台」「/wjs-publishing-hugo」。. Wjs Publishing Hugo is an agent skill from jianshuo/claude-skills.

When should I use Wjs Publishing Hugo?

Wjs Publishing Hugo fits situations like: tasks that involve Static sites and blogs.

How do I install Wjs Publishing Hugo in Claude Code?

Run `npx skills add jianshuo/claude-skills --skill wjs-publishing-hugo -a claude-code`. Or copy the skill folder (wjs-publishing-hugo in jianshuo/claude-skills) into .claude/skills/wjs-publishing-hugo in your project. Claude Code loads it when a task matches its description.

How do I install Wjs Publishing Hugo in Codex?

Run `npx skills add jianshuo/claude-skills --skill wjs-publishing-hugo -a codex`. Or copy the skill folder (wjs-publishing-hugo in jianshuo/claude-skills) into .agents/skills/wjs-publishing-hugo in your project. Codex loads it when a task matches its description.

Can I use Wjs Publishing Hugo in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jianshuo/claude-skills --skill wjs-publishing-hugo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wjs-publishing-hugo, .gemini/skills/wjs-publishing-hugo, .github/skills/wjs-publishing-hugo and .opencode/skills/wjs-publishing-hugo in your project.

What does Wjs Publishing Hugo need to run?

Going by SKILL.md and its folder, Wjs Publishing Hugo needs Python and a shell for the scripts in its folder, the command-line tools its instructions call (python3, bash, git and gh) and credentials named GITHUB_TOKEN. Our summary lists: Python 3; A Bash shell; A credential in GITHUB_TOKEN.

Does Wjs Publishing Hugo access the network?

SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Wjs Publishing Hugo safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Wjs Publishing Hugo use?

Wjs Publishing Hugo is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Wjs Publishing Hugo use?

About 707 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Wjs Publishing Hugo?

Skills that share tags, products or a category with Wjs Publishing Hugo: Great Docs (pymc-labs/pathmc, 132 stars), Publish AI Site (bubblevv/ai-api-gongyi-nav, 102 stars), Linkyee Style Designer (ZhgChgLi/linkyee, 180 stars) and Site Operations (authcrunch/authcrunch.github.io, 108 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wjs Publishing Hugo?

jianshuo (a GitHub user) maintains it in jianshuo/claude-skills, which has 131 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on August 20, 2026.

Source: jianshuo/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.