← 返回 Skills 市场
198
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install kindle2md
功能描述
Convert Kindle HTML notebook exports to Obsidian Markdown format. Use this when the user wants to convert a Kindle book notes HTML file (exported from the Ki...
使用说明 (SKILL.md)
Kindle to Markdown
Use this skill to convert Kindle HTML notebook exports to Obsidian Markdown format.
Setup (First Time Only)
Before using, configure the output directory by editing references/config.md.
Read references/config.md to get the output_dir value. If the value is still "CHANGE_TO_YOUR_OBSIDIAN_BOOKS_PATH", remind the user to configure it first.
Input
The user will provide an HTML file path, for example:
/kindle2md "下载/动物农场.html"/kindle2md "C:/Users/Downloads/动物农场 (Z-Library) - 笔记本.html"
Extract the book title from the HTML filename:
- Remove path and extension
- Remove metadata like "[英]作者", "(Z-Library)", " - 笔记本"
Output
Output directory: Read from references/config.md → output_dir
Output filename: {书名}.md
Example: for input file 动物农场 ([英]乔治·奥威尔) (Z-Library) - 笔记本.html, output should be 动物农场.md
If file already exists, overwrite it.
Runtime
Run the conversion script from the scripts folder:
python "\x3Cskill_path>/scripts/kindle_notes_to_md.py" --override -o "\x3Coutput_dir>/\x3C书名>.md" "\x3C用户提供的HTML路径>"
Where:
\x3Cskill_path>is the path to this skill folder\x3Coutput_dir>is read fromreferences/config.md
Success
Report to the user:
- "转换完成！文件已保存到: {output_path}"
Errors
If the HTML file doesn't exist or is invalid, report the error to the user clearly.
安全使用建议
This skill appears to implement the advertised conversion, but there are mismatches and missing pieces you should address before running it:
- Dependencies: The script requires Python plus packages (bs4/BeautifulSoup, pyperclip, eglogging). The skill provides no install instructions. Install those packages in a virtualenv or inspect and add an install step before use.
- Config mismatch: SKILL.md tells you to edit references/config.md for output_dir, but the script never reads that file. Either run the script with -o pointing to your desired path, or modify the script to read config.md if you want that behavior.
- File safety: The script will overwrite output files when run with --override. Double-check output paths to avoid accidental data loss.
- Clipboard & logging: The script can copy output to the system clipboard (pyperclip) and uses eglogging which may load user logging configuration—review those behaviors if clipboard or local logging config access is a concern.
Recommendations: inspect the script locally, run it in a controlled environment (e.g., temp folder or VM), install required Python packages explicitly, and correct the SKILL.md/install metadata or the script so the declared config and runtime behavior match. If you want higher assurance, request the author add an explicit install spec and a config-reading implementation (or remove the config.md instruction).
功能分析
Type: OpenClaw Skill
Name: kindle2md
Version: 1.0.0
The kindle2md skill is a utility designed to convert Kindle HTML notebook exports into Obsidian-compatible Markdown files. The core logic in `scripts/kindle_notes_to_md.py` uses BeautifulSoup to parse local HTML files and generates structured Markdown with YAML frontmatter. The instructions in `SKILL.md` are well-aligned with the stated purpose, and no indicators of data exfiltration, malicious execution, or prompt injection were found.
能力评估
Purpose & Capability
The code implements Kindle HTML → Markdown conversion which matches the name/description. However the SKILL.md asks the user to set output_dir in references/config.md, while the included Python script does not read that config file (it uses a CLI --output argument or defaults to next to the input file). Also required Python packages (bs4/pyperclip/eglogging) and the need for Python itself are not declared in the skill metadata or install spec.
Instruction Scope
SKILL.md instructs the agent to read references/config.md to obtain output_dir; that's reasonable, but the conversion script does not read that file, so the instructions and runtime behavior are inconsistent. The runtime instructions also rely on executing a local Python script with a user-supplied path (which can overwrite files if --override is used). The script has a clipboard mode (pyperclip) that can read/write the system clipboard but SKILL.md doesn't document that option in detail.
Install Mechanism
There is no install spec. The Python script depends on third-party packages (BeautifulSoup/bs4, pyperclip, eglogging) which are not declared or installed by the skill. Running the script may fail or require manual package installation; absence of an install step is an incoherence but not necessarily malicious.
Credentials
The skill does not request environment variables, credentials, or config paths. The script operates on user-supplied local files and can write output; these privileges are proportional to the stated purpose. Note: pyperclip interacts with the system clipboard (local) and eglogging may read user-level logging config depending on that library's behavior.
Persistence & Privilege
The skill does not request permanent presence (always:false) and does not modify other skills or system-wide agent settings. It writes output files only when invoked and can overwrite existing files if the --override flag is used.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install kindle2md - 安装完成后，直接呼叫该 Skill 的名称或使用
/kindle2md触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
- Initial release of kindle2md skill: Convert Kindle HTML notebook exports to Obsidian Markdown format.
- Supports file path input, automatic book title extraction, and filename formatting.
- Reads output directory from configuration; prompts if not set.
- Runs included Python script for conversion and overwrites existing files.
- Provides clear success and error messages to users.
元数据
常见问题
kindle2md 是什么？
Convert Kindle HTML notebook exports to Obsidian Markdown format. Use this when the user wants to convert a Kindle book notes HTML file (exported from the Ki... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 198 次。
如何安装 kindle2md？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install kindle2md」即可一键安装，无需额外配置。
kindle2md 是免费的吗？
是的，kindle2md 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
kindle2md 支持哪些平台？
kindle2md 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 kindle2md？
由 henrCh1（@henrch1）开发并维护，当前版本 v1.0.0。
推荐 Skills