Skip to content
Skills Library
Personal productivity · Tool integration

greenbubbles-setup

/greenbubbles-setup

Install or diagnose the local GreenBubbles CLI and read-only WeChat access. Use for a missing CLI, failed database access, source selection, or initial owner-operated key capture.

Licence
MIT
Last repository change
01.10.2026

Assessment and security

85/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content20 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 01.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/doctor.py

What it does and when to use it

Install or diagnose the local GreenBubbles CLI and read-only WeChat access. Use for a missing CLI, failed database access, source selection, or initial owner-operated key capture.

Original author description

Install or diagnose the local GreenBubbles CLI and read-only WeChat access. Use for a missing CLI, failed database access, source selection, or initial owner-operated key capture.

How it works

  1. Check access
  2. Fix the failed check
  3. Continue the requested task
Original SKILL.md headings · 40 lines, 255 words
SKILL.md preview
---
name: greenbubbles-setup
description: Install or diagnose the local GreenBubbles CLI and read-only WeChat access. Use for a missing CLI, failed database access, source selection, or initial owner-operated key capture.
---

# Set up GreenBubbles

Work on the user's Mac with the local CLI. Resolve file links relative to this
skill. Setup needs no embedded agent, MCP server, or separate model API key.

## Check access

Run `python3 <this-skill>/scripts/doctor.py` first. Supply
`--greenbubbles /absolute/path/to/greenbubbles` or `--profile NAME` when known.
The doctor checks capabilities and read-only source access without printing keys
or messages. A failed check is a setup issue, not evidence of empty history.

## Fix the failed check

Read [references/setup.md](references/setup.md) for the relevant installation,
source/profile, or capture steps. Use `command -v greenbubbles` and
`greenbubbles --version` to identify the selected executable; 0.10.0 includes
`chats find`, name selection, and command-line `--query` search. Do not silently substitute
another executable after a failed check.

Ordinary live use needs no profile after capture: the CLI discovers the account
and reads `~/.greenbubbles-acquire/passphrase.txt`. Custom paths belong in
`~/.greenbubbles/config.toml`. Use profiles for a second account or a snapshot.
Never put credentials in chat, arguments, logs, or projects.

If a source hangs, diagnose one directory open with a timeout before retrying.
Workspace permissions, Unix ownership, and macOS privacy access are separate;
compare the user's terminal with the agent host and verify changes with a fresh
read. Key capture is owner-operated; follow the setup reference's authorization
requirements for steps that re-sign WeChat.

## Continue the requested task

After `source status` succeeds, use [context](../greenbubbles-context/SKILL.md)
for a query or [personal memory](../greenbubbles-personal-memory/SKILL.md) for
maintained notes. Reading messages across all chats is unnecessary to verify
setup. Keep the complete sibling skill package available; installation into
host discovery folders is optional.
Files in this package (3)
  • SKILL.md 2 KB
  • references/setup.md 5 KB
  • scripts/doctor.py 2 KB

Versions

The database has no other skills named greenbubbles-setup.

Database snapshot: 13.11.2026 · package version 98f6fbc99125 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90greenbubbles-context
    Find chats by name, read or search WeChat messages with the local GreenBubbles CLI. Use for bounded live or snapshot queries; route setup problems to greenbubbles-setup and maintained notes to greenbubbles-personal-memory.
  • 90greenbubbles-personal-memory
    Build or revise private, cited Markdown notes from the user's WeChat history in the current agent session. Use for a maintained personal wiki or incremental notes; use greenbubbles-context for a one-off lookup or summary.
  • 95wechat-local
    读取和分析 Windows 微信(WeChat)聊天记录的 Agent Skill,提供本地 MCP / CLI。支持聊天搜索、消息统计、图片查看、语音转写、视频与附件读取、朋友圈缓存和 Obsidian 导出。用户提到微信聊天记录导出、WeChat MCP、查群聊、转写微信语音、微信数据分析或迁移手机历史时使用。
  • 95wechat-setup
    First-time setup and health check for driving WeChat for Mac. Builds the native helpers, walks the user through the macOS permissions (Accessibility, Screen Recording, optional Full Disk Access), creates config.toml with their persona, sizes the WeChat window and runs a dry-run…
  • 100wechat
    在本地查询、导出微信 4.1+ 聊天记录为 AI 可读文本 —— 支持双人会话、群聊、以及按消息量排名的重要联系人排名。当用户想导出、搜索或分析自己的微信聊天记录,或为其他 skill(前任.skill / 同事.skill 等)准备聊天记录原材料时使用。

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.