← Back to Skills Marketplace
ericxie777

WeRead to flomo

by ericxie777 · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
147
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install weread-to-flomo
Description
Sync WeRead (微信读书) highlights and notes into flomo with incremental deduplication and configurable sync scope. Use when the user wants to export or sync WeRe...
Usage Guidance
This skill appears to do what it claims: read local WeRead-exported Markdown files, POST entries to a flomo webhook you supply, and record which items were sent in a state file under the export directory. Before using it: (1) review the script yourself (it's included) to confirm expected behavior; (2) keep your FLOMO_WEBHOOK secret and supply it via an environment variable or CLI argument as suggested — the script will send content to that URL; (3) run --dry-run first to preview what would be sent; (4) be aware the script creates/updates .weread-flomo-state.json in the export directory; (5) the SKILL.md mentions WEREAD_COOKIE but the script doesn't use it — that cookie may only be relevant for producing the Markdown export outside this tool; (6) avoid putting webhook URLs or cookies into the skill directory or any public repo. If you want higher assurance, run the script in a controlled environment and confirm that the webhook endpoint belongs to flomo (or another trusted destination) before sending real data.
Capability Analysis
Type: OpenClaw Skill Name: weread-to-flomo Version: 1.0.1 The skill is a straightforward utility designed to sync WeRead highlights from local Markdown files to flomo. The core logic in `scripts/weread_to_flomo.py` uses standard Python libraries to parse exported notes and send them to a user-provided webhook via HTTP POST. No evidence of malicious intent, unauthorized data exfiltration, or suspicious execution patterns was found.
Capability Assessment
Purpose & Capability
The script and SKILL.md implement WeRead -> flomo syncing as described: parsing local Markdown exports, building content, POSTing to a flomo webhook, and tracking sent entries. Minor mismatch: SKILL.md suggests setting WEREAD_COOKIE, but the included script does not use any cookie — likely the cookie is needed outside the skill when producing WeRead Markdown exports, not for this script itself.
Instruction Scope
Runtime instructions are narrowly scoped: they direct the agent/user to run the included script against a specified local directory of exported .md files and to provide a flomo webhook. The skill only reads files from the provided weread-dir and a per-directory state file; it does not instruct reading unrelated system files or secrets.
Install Mechanism
There is no install step (instruction-only with an included script). Nothing is downloaded or written outside the user's explicit weread-dir/state file. This is the lowest-risk install posture.
Credentials
The registry metadata lists no required env vars, but SKILL.md advises setting FLOMO_WEBHOOK (and mentions WEREAD_COOKIE). The script accepts the flomo webhook as an argument and will POST content to whichever URL is provided — this is expected and proportionate. The webhook is a sensitive secret (it can accept arbitrary notes), so the skill's need for that secret is reasonable but should be treated carefully. The advertised WEREAD_COOKIE is not used by the script and therefore appears unnecessary here.
Persistence & Privilege
The script writes a local state file (.weread-flomo-state.json) inside the provided weread export directory to track sent items. The skill does not request persistent platform-wide privileges, does not set always:true, and does not modify other skill configs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install weread-to-flomo
  3. After installation, invoke the skill by name or use /weread-to-flomo
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Refine public docs, clarify today/date/all sync scopes, and improve rollout guidance for existing flomo archives.
v1.0.0
Initial public release: sync WeRead highlights/notes to flomo with today/date/all modes, dry-run, and local dedup state.
Metadata
Slug weread-to-flomo
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is WeRead to flomo?

Sync WeRead (微信读书) highlights and notes into flomo with incremental deduplication and configurable sync scope. Use when the user wants to export or sync WeRe... It is an AI Agent Skill for Claude Code / OpenClaw, with 147 downloads so far.

How do I install WeRead to flomo?

Run "/install weread-to-flomo" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is WeRead to flomo free?

Yes, WeRead to flomo is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does WeRead to flomo support?

WeRead to flomo is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created WeRead to flomo?

It is built and maintained by ericxie777 (@ericxie777); the current version is v1.0.1.

💬 Comments