clipsmith-wechatlisted
Install: claude install-skill OctopusGarage/clipsmith
# clipsmith-wechat
> **MANDATORY — load `references/plan.md` before any browser or extraction action begins.**
## ⚠️ NEVER WRITE YOUR OWN SCRIPT
**The download logic is fully implemented. Always invoke the existing script — do NOT write a new one.**
```bash
cd <clipsmith-repo>/skills/clipsmith-wechat
npx tsx scripts/run.ts \
--post_url "<url>" \
--output_dir "$HOME/Downloads/wechat"
```
The sections below are **implementation documentation for the script itself**, not instructions for you to re-implement. If the script doesn't exist or can't run, report the error — never substitute with hand-written Playwright code.
## Clipsmith Bundle Normalization
The copied downloader produces a raw article folder with `article.md`,
`article.mhtml`, and images. Before finalizing a Clipsmith capture job, convert
that raw folder into a bundle with the shared normalizer:
```bash
cd <clipsmith-repo>
uv run clipsmith normalize raw wechat "<raw_dir>" "<bundle_dir>" \
--source-url "<original_url>" \
--canonical-url "<canonical_url>" \
--title "<title>" \
--author "<account_or_author>" \
--published-at "<publish_date>" \
--captured-at "<iso8601_time>" \
--json
uv run clipsmith validate-bundle "<bundle_dir>" --json
```
The normalizer converts `article.md` to bundle `post.md`, creates or copies
`summary.md`, preserves `ocr.md`/`ocr.txt` as `kind: "ocr-text"` if present,
and writes `capture.json`. It intentionally does not copy `article.mhtml` or
downloaded images into the