Agent skill

Yichen Wecom Local Vault

by mcncarl in mcncarl/yichen-skills

Read, decrypt, query, search, and export local WeCom/企业微信 5.x desktop databases on macOS into a private read-only vault.

Custom licenceAuto-check passedData & Analytics

Install Yichen Wecom Local Vault

skills CLI
$ npx skills add mcncarl/yichen-skills --skill yichen-wecom-local-vault -a claude-code

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

GitHub CLI
$ gh skill install mcncarl/yichen-skills yichen-wecom-local-vault --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/mcncarl/yichen-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/yichen-wecom-local-vault .claude/skills/yichen-wecom-local-vault && 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
yichen-wecom-local-vault
GitHub stars
4.4k
Token cost
~1.3k tokens
SKILL.md length
224 words
Files
9 (incl. scripts, references)
Skills in repo
19
Repo updated
First seen
Licence
Custom licence

At a glance

Read, decrypt, query, search, and export local WeCom/企业微信 5.x desktop databases on macOS into a private read-only vault.

  • Works in 5 steps: 第一次使用或用户问“能不能解析”:运行 status,只检查数据库,不附加进程。 → 已有私密 key 文件:运行 decrypt 创建新快照;默认合并已提交的… → 缺少 key:先说明需要明确授权捕获;可选只读 attach,若 macOS… → …
  • The user asks to parse 企业微信本地数据、企微聊天记录、WeCom/WXWork contacts
  • SKILL.md covers 强制边界, 入口, 自动选择工作流 and 数据库发现与检查, plus 6 more sections
  • Runs Python scripts from its folder; calls python3

What it does

Yichen Wecom Local Vault is an agent skill from mcncarl/yichen-skills. Read, decrypt, query, search, and export local WeCom/企业微信 5.x desktop databases on macOS into a private read-only vault. Use when the user asks to parse 企业微信本地数据、企微聊天记录、WeCom/WXWork contacts, sessions, groups, customers, message history, local database backup, structured export, or a Mac enterprise-WeChat data analysis workflow.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/database-notes.md` and `scripts/capture_key_macos.py`).

It sits in Data & Analytics, covering Messaging and chat bots, Database administration and Data analysis. It works with macOS, WeChat and Frida.

When your agent uses it

  • The user asks to parse 企业微信本地数据、企微聊天记录、WeCom/WXWork contacts
  • Message history
  • Local database backup
  • Structured export

Example prompts

  • “/yichen-wecom-local-vault”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 第一次使用或用户问“能不能解析”:运行 status,只检查数据库,不附加进程。
  2. 已有私密 key 文件:运行 decrypt 创建新快照;默认合并已提交的 WAL 帧。
  3. 缺少 key:先说明需要明确授权捕获;可选只读 attach,若 macOS 拒绝 task_for_pid,再使用重签副本捕获。
  4. 已有快照:直接用 sessions、contacts、history、search、export,不要重新解密。
  5. 用户指定会话或时间范围:只查询该范围;消息较多时先落 Markdown/JSON 文件。

What it can do on your machine

Read from SKILL.md and the folder at commit 9bd7898. 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 6 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    Links to these hosts (documentation or services it may open):

    • frida.re

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Yichen Wecom Local Vault loads about 1.3k tokens when it runs, and up to ~2k if it reads all its reference files. Until then it costs about 89 tokens; SKILL.md has 224 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 224 words (~1,328 tokens).

name
yichen-wecom-local-vault

Read the full SKILL.md on GitHub

Files

SKILL.md and 8 other files (scripts, references) in yichen-wecom-local-vault of mcncarl/yichen-skills.

  • SKILL.md
  • agents/openai.yaml
  • references/database-notes.md
  • scripts/capture_key_macos.py
  • scripts/scan_dbkey_manager_macos.py
  • scripts/test_wecom_local_vault.py
  • scripts/vault_cli.py
  • scripts/wecom_common.py
  • scripts/wecom_crypto.py

Open the folder on GitHubat commit 9bd7898

Compare with similar skills

Yichen Wecom Local Vault 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.

Yichen Wecom Local Vault compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yichen Wecom Local Vault this skillmcncarl/yichen-skills4.4k—~1.3kAutomated safety check: PassCustom licence
WeChat Group Activity Statspunk2898/wechat-group-stats121—~2.8kAutomated safety check: NotesMIT
Greenbubbles Setupbojieli/greenbubbles365—~537Automated safety check: PassMIT
Wechat Exporterrobbin/wechat-exporter214—~2kAutomated safety check: NotesNone
Wechat Article Extractfreestylefly/WeChatBridge1.2k—~236Automated safety check: PassMIT
Greenbubbles Contextbojieli/greenbubbles365—~603Automated safety check: PassMIT

Similar skills

  • WeChat Group Activity Stats

    punk2898/wechat-group-stats

    Counts messages per member in a WeChat group on macOS, tags how active each person is, and shows the results in a web dashboard with a JSON API.

    121 GitHub stars~2.8k tokensUpdated 4 mo ago
    Data & AnalyticsAuto-check: notes
  • Greenbubbles Setup

    bojieli/greenbubbles

    Install or diagnose the local GreenBubbles CLI and read-only WeChat access.

    365 GitHub stars~537 tokensUpdated 7 days ago
    Productivity & AutomationAuto-check passed
  • Wechat Exporter

    robbin/wechat-exporter

    A skill your agent uses when the user says "wechat-exporter", "导出微信", "更新微信聊天记录", or wants to export, decrypt, or refresh WeChat chat history and contacts on macOS.

    214 GitHub stars~2k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check: notes
  • Wechat Article Extract

    freestylefly/WeChatBridge

    从微信聊天记录导出文件中识别公众号文章链接或分享卡片,提取标题、公众号名称、发布时间、正文和图片,并保留原文链接。当用户要求整理、摘录或归档聊天记录里的公众号文章时使用。

    1.2k GitHub stars~236 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Greenbubbles Context

    bojieli/greenbubbles

    Find chats by name, read or search WeChat messages with the local GreenBubbles CLI.

    365 GitHub stars~603 tokensUpdated 7 days ago
    Productivity & AutomationAuto-check passed
  • Greenbubbles Personal Memory

    bojieli/greenbubbles

    Build or revise private, cited Markdown notes from the user's WeChat history in the current agent session.

    365 GitHub stars~669 tokensUpdated 7 days ago
    Knowledge ManagementAuto-check passed

More from mcncarl/yichen-skills

All 19 skills in this repo
  • Yichen Asr

    mcncarl/yichen-skills

    逸尘自用的统一音视频转写入口,在 StepFun Step ASR 与火山引擎豆包 ASR 之间按输出需求、安全边界和可用状态路由。用于本地音频或视频的纯文本转写、时间戳、SRT 字幕、口播粗剪,以及转写前体检;用户明确指定服务商时不得静默切换。Use when a local audio or video file needs transcription and the correct…

    4.4k GitHub stars~780 tokensUpdated 6 days ago
    Auto-check passed
  • Yichen Mac Wechat Dual Open

    mcncarl/yichen-skills

    Create, inspect, repair, and polish a second WeChat app on macOS by copying WeChat, changing the bundle identifier, ad-hoc re-signing, preparing it for the user to open manually, setting Chinese…

    4.4k GitHub stars~1.5k tokensUpdated 6 days ago
    Auto-check passed
  • Yichen Web Research

    mcncarl/yichen-skills

    逸尘自用的互联网研究总入口。用于跨平台且跨阶段、用户尚未确定工具,或明确要求对公司、产品、人物、技术、行业和领域做横纵分析、发展史加现状对比或有来源约束的系统深度研究;先生成有截止日期和证据闸门的计划,再把搜索发现、候选核验、有限归档、按需转写和证据综合路由到…

    4.4k GitHub stars~1.9k tokensUpdated 6 days ago
    Auto-check passed
  • Yichen Wechat Mp Batch Exporter

    mcncarl/yichen-skills

    批量下载微信公众号文章正文、历史文章列表、原创文章筛选、历史计数口径、阅读量、点赞/转发等指标、评论和评论回复。Use when the user asks to batch fetch mp.weixin.qq.com articles, export WeChat public-account history, distinguish publish groups vs expanded…

    4.4k GitHub stars~1.5k tokensUpdated 6 days ago
    Auto-check passed
  • Yichen X Slicer

    mcncarl/yichen-skills

    将公开 X 推文、Quote 或同作者 Thread 转为 1080×1440 图片切片和 MP4;也支持显式 source-only 素材桥接。保留所选原生视频及对应音频,不发布。

    4.4k GitHub stars~2.2k tokensUpdated 6 days ago
    Auto-check passed
  • Yichen Bookmarks Export

    mcncarl/yichen-skills

    在用户当轮明确授权后,只读导出其小红书收藏、抖音收藏或 X/Twitter 书签为本地链接文件;本 Skill 直接完成收藏页滚动、链接提取、去重、数量核验、Field Theory GraphQL-only 导出和抽样验证。用于“导出/备份/同步我的收藏或书签链接”等私人数据导出任务;不得用于公开搜索、收藏内容分析、媒体下载、正文归档、推荐发现或未获当轮授权的私人读取。

    4.4k GitHub stars~1.1k tokensUpdated 6 days ago
    Auto-check passed

Questions about Yichen Wecom Local Vault

What does Yichen Wecom Local Vault do?

Read, decrypt, query, search, and export local WeCom/企业微信 5.x desktop databases on macOS into a private read-only vault. Yichen Wecom Local Vault is an agent skill from mcncarl/yichen-skills.x desktop databases on macOS into a private read-only vault.

When should I use Yichen Wecom Local Vault?

Yichen Wecom Local Vault fits situations like: the user asks to parse 企业微信本地数据、企微聊天记录、WeCom/WXWork contacts; message history; local database backup; structured export.

How do I install Yichen Wecom Local Vault in Claude Code?

Run `npx skills add mcncarl/yichen-skills --skill yichen-wecom-local-vault -a claude-code`. Or copy the skill folder (yichen-wecom-local-vault in mcncarl/yichen-skills) into .claude/skills/yichen-wecom-local-vault in your project. Claude Code loads it when a task matches its description.

How do I install Yichen Wecom Local Vault in Codex?

Run `npx skills add mcncarl/yichen-skills --skill yichen-wecom-local-vault -a codex`. Or copy the skill folder (yichen-wecom-local-vault in mcncarl/yichen-skills) into .agents/skills/yichen-wecom-local-vault in your project. Codex loads it when a task matches its description.

Can I use Yichen Wecom Local Vault 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 mcncarl/yichen-skills --skill yichen-wecom-local-vault -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/yichen-wecom-local-vault, .gemini/skills/yichen-wecom-local-vault, .github/skills/yichen-wecom-local-vault and .opencode/skills/yichen-wecom-local-vault in your project.

What does Yichen Wecom Local Vault need to run?

Going by SKILL.md and its folder, Yichen Wecom Local Vault needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Yichen Wecom Local Vault access the network?

SKILL.md names 1 domain. As links in the text: frida.re. This is read from the text; nothing was executed.

Is Yichen Wecom Local Vault safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. 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 Yichen Wecom Local Vault use?

Yichen Wecom Local Vault has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Yichen Wecom Local Vault use?

About 1.3k tokens (SKILL.md is roughly 5.3k 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 672 tokens, read only when the agent opens those files.

What are the alternatives to Yichen Wecom Local Vault?

Skills that share tags, products or a category with Yichen Wecom Local Vault: WeChat Group Activity Stats (punk2898/wechat-group-stats, 121 stars), Greenbubbles Setup (bojieli/greenbubbles, 365 stars), Wechat Exporter (robbin/wechat-exporter, 214 stars) and Wechat Article Extract (freestylefly/WeChatBridge, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yichen Wecom Local Vault?

mcncarl (a GitHub user) maintains it in mcncarl/yichen-skills, which has 4,362 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 4, 2026.

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