wx-favorites-report — Claude Code skill: WeChat favorites report
Pulls your WeChat for macOS favorites out of the encrypted database and turns them into a single interactive HTML report.
npx skills add reason-machines/trending-skills --skill wx-favorites-report -a claude-codeWhat wx-favorites-report does
The skill walks the whole chain. It attaches to the WeChat client with Frida, catches PBKDF2 calls to grab the encryption keys, decrypts the SQLCipher favorite.db, parses the XML stored in each record, and renders one HTML file with charts, a word cloud and a filterable card browser.
macOS only, and WeChat Mac 4.x has to be installed and logged in. You also need Python 3.9+ and Frida 17.x, installed with pip3 install frida frida-tools pycryptodome. The App Store build blocks injection, so copy it and re-sign without entitlements first. Do not run any of this with sudo — the data directory shifts to /var/root/… and the database path stops resolving.
Timing matters: the key only shows up once you open the 收藏 tab, so a hook started earlier logs nothing. Inside scripts/ there is parse_favorites.py, which unifies SQLite, CSV or JSON into one JSON file, generate_report.py for the HTML, and demo_data.py with synthetic records if you want to test the pipeline without touching your own database.
What it helps with
- capture the WeChat encryption key from a running client
- decrypt
favorite.dbwithout hand-rolling SQLCipher - turn XML favorites into readable JSON
- produce one HTML file with charts and a word cloud
- test the pipeline on demo data instead of a real database
Example prompts for the agent
- Run the wx-favorites-report pipeline and build an HTML report from my WeChat favorites
- Decrypt
favorite.dband parse the records into JSON withparse_favorites.py - Generate the report from
/tmp/favorite_decrypted.dbusinggenerate_report.py
How to install wx-favorites-report
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill wx-favorites-report -a claude-code2Manually: put the files in place
~/.claude/skills/wx-favorites-report/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/wx-favorites-report/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill wx-favorites-report -a codex2Manually: put the files in place
.agents/skills/wx-favorites-report/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill wx-favorites-report -a cursor2Manually: put the files in place
.cursor/skills/wx-favorites-report/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills wx-favorites-report2Manually: put the files in place
.github/skills/wx-favorites-report/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill wx-favorites-report -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/wx-favorites-reportManually: put the files in place
.devin/skills/wx-favorites-report/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill wx-favorites-report -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about wx-favorites-report
How do I install wx-favorites-report in Claude Code?
Run npx skills add reason-machines/trending-skills --skill wx-favorites-report -a claude-code. The skill lands at ~/.claude/skills/wx-favorites-report/SKILL.md.
What does wx-favorites-report do?
It goes from hooking WeChat with Frida for the keys to decrypting the favorites database and rendering an interactive HTML report with charts and filterable cards.
What do I need before running it?
macOS, a logged-in WeChat Mac 4.x, Python 3.9+ and Frida 17.x with the frida, frida-tools and pycryptodome packages. A re-signed copy of the App Store build is required for injection.
