前言¶
写公众号长文时，常见路径是：在 Markdown 里写完稿，再手工复制到编辑器里调样式，或依赖平台默认排版。若你已经有一份自定义 CSS（例如 Agent 生成的主题文件），还要自己对照预览、再想办法推到草稿箱，步骤容易散、也容易漏检。
下面介绍 SkillHub 上的 微信公众号自定义主题应用工具（@user_d8946e26/apply-wenyan-custom-theme）。它把「本地试样式 → 可选注册主题 → 推到微信公众号草稿箱」写成 Agent 可执行的标准流程，底层依赖 Wenyan CLI 和本地 Markdown、CSS 文件。与只做 Markdown 转 HTML 的工具相比，它面向的是「带自定义主题的一键发布」场景。
这是什么¶
一句话定位：面向 AI Agent 的 Skill，用于通过 Wenyan CLI 对 Markdown 文章做测试渲染、主题注册，并使用本地自定义 CSS 主题将文章发布到微信公众号。
- 坐标：
@user_d8946e26/apply-wenyan-custom-theme - 版本：1.0.0（SkillHub 页面标注）
- 来源：community，分类 content-creation，发布者
user_d8946e26 - 官方入口：https://api.skillhub.cn/user_d8946e26/apply-wenyan-custom-theme
SkillHub 详情页：https://www.skillhub.cn/skills/user_d8946e26/apply-wenyan-custom-theme
SkillHub 英文简介原文为：AI-ready skill to test, register, and publish Markdown articles to WeChat Official Accounts using a local custom CSS theme via Wenyan CLI. 平台标签含 requires_api_key=true，表示使用前需配置相关 API 凭证（见下文前置要求）。
核心功能¶
以下能力与官方简介及同源技能说明一致，Agent 安装本 Skill 后应按其 SKILL.md 工作流执行：
- 本地测试渲染：发布前用指定 CSS 对 Markdown 做模拟渲染，确认路径与样式无误。
- 发布到公众号草稿箱：在渲染通过后，将文章按本地 CSS 主题推送到微信公众号草稿（需网络与微信接口凭证）。
- 主题注册（按需）：将自定义 CSS 登记到本机 Wenyan 主题库，便于后续用主题名而非文件路径调用。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装或仅安装 CLI：
# 完整安装（CLI + 默认 Skill，推荐）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
# 仅安装 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明见：https://skillhub.cn/install/skillhub.md
2. 安装本 Skill¶
SkillHub 详情页给出的安装提示为：根据 https://skillhub.cn/install/skillhub.md，安装 @user_d8946e26/apply-wenyan-custom-theme。
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别：
skillhub install @user_d8946e26/apply-wenyan-custom-theme --dir <你的 skills 目录>
常用路径示例（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将官方提示词发给 Agent，由其按上述文档完成安装。
3. 前置环境与依赖¶
技能说明中要求（与 Wenyan 发布能力一致）：
- 已安装 wenyan-cli，示例安装命令：
pnpm add -g @wenyan-md/cli - 配置环境变量
WECHAT_APP_ID、WECHAT_APP_SECRET（微信公众号应用凭证） - 本地已有 Markdown（
.md）与 CSS 主题（.css）文件
安装 Skill 本身不替代 Wenyan CLI 与微信凭证配置；发布步骤依赖网络访问微信 API。
典型用法¶
当需要「用某份 theme.css 排版并发布 article.md」时，Agent 应遵循技能内标准操作流程（SOP）。下面为可复现的命令形态，路径请替换为实际文件。
Step 1：测试渲染（发布前建议强制执行）
wenyan render -f <markdown_file_path> -c <css_file_path>
确认命令无报错、输出为预期 HTML 后再继续。
Step 2：发布到微信公众号草稿箱
wenyan publish -f <markdown_file_path> -c <css_file_path>
可选参数（技能说明中列出）：
--no-mac-style：禁用代码块 Mac 风格窗口-h <highlight_theme>：指定代码高亮主题，例如atom-one-dark
Step 3：注册主题（长期使用同一 CSS 时）
wenyan theme --add --name <theme_name> --path <css_file_path>
注册后发布时可改用主题名参数 -t <theme_name>。列出本机主题：
wenyan theme -l
（wenyan theme 子命令行为亦可参考 Wenyan CLI 官方文档：https://github.com/caol64/wenyan-cli/blob/main/docs/theme.md）
适用场景与注意¶
适合谁
- 已在本地用 Markdown 写作，并希望固定一套 CSS 视觉，而不是每次进公众号编辑器手调。
- 希望由 Cursor、Claude Code 等 Agent 按固定 SOP 完成预览与草稿发布，减少漏步骤。
- 团队或个人维护多篇文章、多套主题，需要把 CSS 注册进 Wenyan 主题库复用。
限制与注意
- 平台标记
requires_api_key=true：须正确配置微信应用 ID 与 Secret；若接口返回invalid credential，应核对WECHAT_APP_ID、WECHAT_APP_SECRET。 - 发布依赖外网与微信 API；本地仅
render可在无发布意图时做样式验证。 - CSS 选择器需符合 Wenyan 约定（技能故障说明提到：样式未生效时可检查是否缺少
#wenyan前缀）。 - 文件路径错误会表现为
ENOENT等错误，需核对 Markdown、CSS 路径。 - SkillHub 上本技能为社区来源（
community），安装前可按平台说明用skillhub verify @user_d8946e26/apply-wenyan-custom-theme校验内容与签名（需 SkillHub CLI 2026.7.29+）。
结尾¶
微信公众号自定义主题应用工具把「自定义 CSS + Markdown → 预览 → 公众号草稿」收敛成 Agent 可执行的 Wenyan CLI 流程，适合内容创作类（content-creation）工作流。若你使用 SkillHub，可从官方地址获取并安装：
- API / 安装入口：https://api.skillhub.cn/user_d8946e26/apply-wenyan-custom-theme
- 详情页：https://www.skillhub.cn/skills/user_d8946e26/apply-wenyan-custom-theme
（SkillHub 页面统计：评分 100000，下载 928，安装 89，数据以平台展示为准。）
