# wechat-article-to-markdown

Pulls a WeChat Official Account post from mp.weixin.qq.com and writes it out as Markdown, with the images saved next to the file.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 919 installs · ★ 1073
- Author: jackwener
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/jackwener/wechat-article-to-markdown/tree/HEAD/SKILL.md
- Updated: 2026-03-22
- HTML: https://affpapa.org/en/nevibecode/skills/wechat-article-to-markdown

## What it does

Give the skill a link of the form `https://mp.weixin.qq.com/s/...` and it produces `output/<article-title>/<article-title>.md`, keeping the pictures in an `images/` folder beside it. Code that can be read off the page ends up in fenced blocks.

Fetching runs through Camoufox, so the page is requested the way a normal browser would ask for it. You also get the headline, the account name, the day it went out and the address it came from. Pictures are downloaded in parallel and land as local files, which keeps the copy readable offline.

Not every snippet survives. Some code samples in WeChat posts are drawn as images or SVG, and there is no source text to pull from those. The URL has to be public on `mp.weixin.qq.com`, and the tool needs Python 3.8+ installed.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add jackwener/wechat-article-to-markdown --skill wechat-article-to-markdown -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/wechat-article-to-markdown/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/wechat-article-to-markdown/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add jackwener/wechat-article-to-markdown --skill wechat-article-to-markdown -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/wechat-article-to-markdown/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add jackwener/wechat-article-to-markdown --skill wechat-article-to-markdown -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/wechat-article-to-markdown/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jackwener/wechat-article-to-markdown wechat-article-to-markdown
```

2. **Manually: put the files in place**
- File: `.github/skills/wechat-article-to-markdown/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add jackwener/wechat-article-to-markdown --skill wechat-article-to-markdown -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/jackwener/wechat-article-to-markdown
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/wechat-article-to-markdown/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add jackwener/wechat-article-to-markdown --skill wechat-article-to-markdown -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/jackwener/wechat-article-to-markdown/tree/HEAD/SKILL.md

## When to use it
- archive a WeChat post as Markdown
- keep the article images on disk
- capture the headline, account name and publication date
- feed a WeChat article into a summarizer
- load posts into a knowledge base without copy-paste

## Example prompts
- Save `https://mp.weixin.qq.com/s/...` as Markdown, images included
- Convert this WeChat article and tell me which account it belongs to: `https://mp.weixin.qq.com/s/...`
- Grab `https://mp.weixin.qq.com/s/...` and write it into `output/` for the knowledge base

## Similar
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [domain-modeling](https://affpapa.org/en/nevibecode/skills/domain-modeling.md) — skill · 876391 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md