Agent skill

Good Mp Post

by ImGoodBai in ImGoodBai/goodable

“微信公众号文章发布完整流程管理,包括AI辅助创作、图片生成、排版和发布。”

— description from SKILL.md by ImGoodBai
MITAuto-check: notesProductivity & Automation

Install Good Mp Post

skills CLI
$ npx skills add ImGoodBai/goodable --skill good-mp-post -a claude-code

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

GitHub CLI
$ gh skill install ImGoodBai/goodable good-mp-post --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/ImGoodBai/goodable.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/good-mp-post .claude/skills/good-mp-post && 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
good-mp-post
GitHub stars
195
Token cost
~769 tokens
SKILL.md length
158 words
Files
36 (incl. scripts, references, assets)
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

  • Works in 8 steps: 启动服务 → 创建文章 → 发布文章 → …
  • SKILL.md covers 任务目标, 使用模式, 前置准备 and 标准流程(Web UI), plus 4 more sections
  • Runs Python and JavaScript scripts from its folder; calls python, uvicorn and pip; needs WECHAT_APP_SECRET

About this skill

Good Mp Post is a skill in ImGoodBai/goodable (195 stars). Its SKILL.md is about 769 tokens, with 35 other files in the folder (scripts, references, assets). Licence: MIT.

Workflow steps

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

  1. 启动服务
  2. 创建文章
  3. 发布文章
  4. 创作文章内容
  5. 生成图片
  6. 上传图片
  7. 创建草稿
  8. 发布文章

What it can do on your machine

Read from SKILL.md and the folder at commit c14e5ad. 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 1 file in scripts/ (Python and JavaScript, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • uvicorn
    • pip

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

  • Network

    No URLs in SKILL.md. Its commands use pip, 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:

    • WECHAT_APP_SECRET

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

Context cost

Good Mp Post loads about 769 tokens when it runs, and up to ~3.5k if it reads all its reference files. Until then it costs about 12 tokens; SKILL.md has 158 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~12
When it runs · the whole SKILL.md, loaded when a task matches
~769
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.5k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:61
    - 在 .env 文件配置 `WECHAT_APP_ID` 和 `WECHAT_APP_SECRET`

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 ImGoodBai/goodable at commit c14e5ad, republished under its MIT licence (© ImGoodBai). 158 words, ~769 tokens.

Download SKILL.mdSave it as .claude/skills/good-mp-post/SKILL.md (or your agent's skills folder). This skill also uses 35 other files; get the full folder from GitHub.
name
good-mp-post
description
微信公众号文章发布完整流程管理,包括AI辅助创作、图片生成、排版和发布。
displayName
Good 公众号发布
version
1.0.0
license
MIT

Good 公众号发布

任务目标

通过AI辅助完成微信公众号文章的创作、排版和发布全流程。

能力: 文章创作、图片生成与上传、草稿创建、文章发布

触发: 用户需要创建或发布微信公众号文章

使用模式

模式1:Web UI (推荐)

可视化界面,支持文章管理、在线编辑和发布:

bash
# 安装依赖
pip install -r requirements.txt

# 启动服务(默认端口8000)
uvicorn app.main:app --reload

# 浏览器访问
http://localhost:8000

功能:

  • 文章CRUD操作(创建、查看、编辑、删除)
  • Markdown内容编辑
  • 数据库持久化(SQLite)
  • 直接发布到微信公众号
  • 发布历史记录
模式2:脚本 (命令行)

适合自动化场景,与Web UI共享数据库:

bash
# 上传图片
python scripts/upload_media.py /path/to/image.jpg thumb

# 创建草稿
python scripts/create_draft.py --title "标题" --content "内容"

# 发布文章
python scripts/publish_article.py --media_id <草稿ID>

数据互通: 脚本发布的文章会自动记录到数据库,Web UI可查看和管理。

前置准备

依赖: requests>=2.28.0, python-dotenv>=1.0.0, fastapi>=0.104.1, sqlalchemy>=2.0.35

凭证配置:

  • 在 .env 文件配置 WECHAT_APP_ID 和 WECHAT_APP_SECRET
  • 获取方式:微信公众平台 → 开发 → 基本配置
  • 需配置IP白名单

数据库: 自动创建 SQLite 数据库(data/articles.db),无需手动配置

标准流程(Web UI)

1. 启动服务
bash
cd skills/good-mp-post
uvicorn app.main:app --reload
2. 创建文章
3. 发布文章
  • 在文章列表点击"发布"按钮
  • 自动处理封面图上传、草稿创建、发布流程
  • 查看发布状态

脚本流程(命令行)

1. 创作文章内容
  • 根据用户需求创作文章(Markdown格式)
  • 参考 assets/templates/article-template.md 了解格式建议
2. 生成图片
  • 生成封面图(建议 900×383px,<5MB)
  • 生成插图(宽度≤900px)
3. 上传图片

调用 scripts/upload_media.py:

bash
python scripts/upload_media.py /path/to/cover.jpg thumb    # 封面图
python scripts/upload_media.py /path/to/image.png image    # 正文图
4. 创建草稿

调用 scripts/create_draft.py:

bash
python scripts/create_draft.py \
  --title "文章标题" \
  --author "作者名" \
  --thumb_media_id <封面图ID> \
  --content "<p>HTML正文</p>" \
  --media_ids '[]'

注意: 作者名最长8个中文字符

5. 发布文章

调用 scripts/publish_article.py:

bash
python scripts/publish_article.py --media_id <草稿ID>

资源索引

  • app/main.py - FastAPI 主应用入口
  • app/api/articles.py - 文章管理 API
  • app/api/images.py - 图片上传 API
  • app/database.py - 数据库模型和连接
  • app/static/index.html - Web UI 界面
  • scripts/upload_media.py - 上传图片到素材库
  • scripts/create_draft.py - 创建图文草稿
  • scripts/publish_article.py - 发布草稿
  • scripts/db_logger.py - 数据库日志记录(可选)
  • references/api-guide.md - API详细说明
  • assets/templates/article-template.md - 文章格式模板

图片路径规范(重要)

AI生成文章时必须遵循以下规范:

禁止使用相对路径

❌ 错误示例:

markdown
![封面](./cover.jpg)
![插图](../images/chart.png)
![示例](images/demo.jpg)
正确的图片处理流程
  1. 先生成图片文件并保存到临时目录
  2. 调用 upload_media.py 上传到微信获取 media_id
  3. 使用占位符或说明文字,不要直接插入本地路径

✅ 正确示例:

markdown
<!-- 步骤1:生成图片 -->
<!-- 步骤2:上传图片 -->
python scripts/upload_media.py /path/to/cover.jpg thumb

<!-- 步骤3:记录 media_id,在创建草稿时使用 -->
<!-- 正文中不插入相对路径 -->
原因说明
  • 相对路径在预览和发布时无法正常显示
  • 微信公众号要求先上传图片获取 media_id
  • 已有的工作流(上传图片→创建草稿)是正确的

关键注意事项

  1. 作者名限制: 最长8个中文字符
  2. 图片有效期: 封面图永久,正文图3天
  3. 图片路径: 禁止使用相对路径(见上方图片路径规范)
  4. HTML要求: 使用简单标签(p/h1-h3/ul/li/img/a),避免复杂CSS
  5. 发布审核: 发布后需微信审核才能展示
  6. 调用频率: 上传1000次/天,创建草稿100次/天,发布10次/天

© ImGoodBai, 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 35 other files (scripts, references, assets) in skills/good-mp-post of ImGoodBai/goodable.

  • SKILL.md
  • .env.example
  • .gitignore
  • README.md
  • app/__init__.py
  • app/api/__init__.py
  • app/api/articles.py
  • app/api/images.py
  • app/database.py
  • app/main.py
  • app/static/css/style.css
  • app/static/index.html
  • app/static/js/app.js
  • arch.md
  • assets/templates
  • … and 21 more

Open the folder on GitHubat commit c14e5ad

Compare with similar skills

Good Mp Post 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.

Good Mp Post compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Good Mp Post this skillImGoodBai/goodable195—~769Automated safety check: NotesMIT
BunwvNatiCha/bunwv220—~4.6kAutomated safety check: NotesMIT
Pinchtab Helpershepherdjerred/monorepo112—~3.9kAutomated safety check: PassGPL-3.0
Control Browserzai-org/ZCode7.6k—~4.6kAutomated safety check: PassApache-2.0
Peated QAdcramer/peated102—~1.9kAutomated safety check: NotesApache-2.0
Sap Browser Automationsecondsky/sap-skills462—~3.3kAutomated safety check: PassGPL-3.0

Similar skills

  • Bunwv

    NatiCha/bunwv

    Headless browser testing via persistent Bun.WebView session.

    220 GitHub stars~4.6k tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check: notes
  • Pinchtab Helper

    shepherdjerred/monorepo

    PinchTab browser automation for interactive tasks, API fallback, local development, UI verification, and visual proof; also profiles, instances, multi-instance routing, tabs, actions, and…

    112 GitHub stars~3.9k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Control Browser

    zai-org/ZCode

    A skill your agent uses when opening, navigating, inspecting, testing, clicking, typing, filling, screenshotting, or verifying web pages and local HTTP targets (localhost, 127.0.0.1, ::1) inside…

    7.6k GitHub stars~4.6k tokensUpdated 10 days ago
    Productivity & AutomationAuto-check passed
  • Peated QA

    dcramer/peated

    A skill your agent uses when manually QAing Peated changes across the API, CLI, or web UI; selecting smoke checks after code changes; using agent-browser for Peated flows; verifying local behavior…

    102 GitHub stars~1.9k tokensUpdated 7 days ago
    Productivity & AutomationAuto-check: notes
  • Sap Browser Automation

    secondsky/sap-skills

    A skill your agent uses when an agent must inspect or operate an authenticated SAP web UI through an in-app Browser, Microsoft Edge CDP, or an existing Playwright client, especially when SAP SSO…

    462 GitHub stars~3.3k tokensUpdated 4 days ago
    Productivity & AutomationAuto-check passed
  • Browser Inspect

    ntorga/agent-starter-kit

    Browser inspection and interaction for verifying rendered web UI during development.

    146 GitHub stars~2k tokensUpdated 27 days ago
    Productivity & AutomationAuto-check passed

More from ImGoodBai/goodable

  • Goodqunbot

    ImGoodBai/goodable

    AI-powered WeChat message assistant. An agent skill from ImGoodBai/goodable.

    195 GitHub stars~1.8k tokensUpdated 8 mo ago
    Auto-check passed

Questions about Good Mp Post

How do I install Good Mp Post in Claude Code?

Run `npx skills add ImGoodBai/goodable --skill good-mp-post -a claude-code`. Or copy the skill folder (skills/good-mp-post in ImGoodBai/goodable) into .claude/skills/good-mp-post in your project. Claude Code loads it when a task matches its description.

How do I install Good Mp Post in Codex?

Run `npx skills add ImGoodBai/goodable --skill good-mp-post -a codex`. Or copy the skill folder (skills/good-mp-post in ImGoodBai/goodable) into .agents/skills/good-mp-post in your project. Codex loads it when a task matches its description.

Can I use Good Mp Post 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 ImGoodBai/goodable --skill good-mp-post -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/good-mp-post, .gemini/skills/good-mp-post, .github/skills/good-mp-post and .opencode/skills/good-mp-post in your project.

What does Good Mp Post need to run?

Going by SKILL.md and its folder, Good Mp Post needs Python and JavaScript for the scripts in its folder, the command-line tools its instructions call (python, uvicorn and pip) and credentials named WECHAT_APP_SECRET.

Does Good Mp Post access the network?

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

Is Good Mp Post safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. 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 Good Mp Post use?

Good Mp Post is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Good Mp Post use?

About 769 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.7k tokens, read only when the agent opens those files.

What are the alternatives to Good Mp Post?

Skills that share tags, products or a category with Good Mp Post: Bunwv (NatiCha/bunwv, 220 stars), Pinchtab Helper (shepherdjerred/monorepo, 112 stars), Control Browser (zai-org/ZCode, 7.6k stars) and Peated QA (dcramer/peated, 102 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Good Mp Post?

ImGoodBai (a GitHub user) maintains it in ImGoodBai/goodable, which has 195 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on January 29, 2026.

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