← 返回 Skills 市场
107
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install znote
功能描述
Create, manage, and operate a Zettelkasten slip-box note system using the zk.py CLI script. Use this skill whenever a user wants to build or use a Zettelkast...
安全使用建议
This skill appears to do what it says: manage a local Zettelkasten vault and needs only optional ZK_VAULT and EDITOR environment variables. Before installing or running it:
- Review the script yourself (it is provided) and run it from a user account you control. The code is local-file oriented and does not phone home.
- Be cautious with the EDITOR environment variable: the script uses os.system(f'{editor} "{path}"'). If EDITOR is set to a malicious string (or contains shell metacharacters), that could execute undesired shell commands. Prefer setting EDITOR to a trusted program (e.g., vim, nano) or modify the script to use subprocess.run([...], shell=False).
- Be mindful of ZK_VAULT: if you override the vault path, the tool will scan and read all .md files under that path. Don’t point it at directories containing sensitive files.
- If you plan to allow autonomous invocation by an agent, consider whether automatic file creation/editing is acceptable; you can require explicit user invocation instead.
- If you want extra safety, run the script in a confined environment (different user account, container, or VM) until you’re comfortable with behavior.
功能分析
Type: OpenClaw Skill
Name: znote
Version: 1.0.0
The znote skill provides a functional Zettelkasten note-taking CLI tool. However, the script 'scripts/zk.py' contains a shell injection vulnerability in the '_open_in_editor' function, which uses 'os.system()' to execute a command string constructed from the 'EDITOR' environment variable and a file path. While the file paths are sanitized using a slugification function, the reliance on 'os.system' for executing external commands is a high-risk practice that could be exploited if the environment is compromised. No evidence of intentional malice, data exfiltration, or prompt injection was found.
能力评估
Purpose & Capability
Name/description match the provided code and instructions: a single-file Python CLI to create and manage a local Zettelkasten vault. No unrelated binaries, env vars, or network endpoints are requested.
Instruction Scope
SKILL.md and the CLI operate locally on a vault (default ~/Zettelkasten) and instruct the agent to deliver the script to the user. The runtime instructions do not direct data to external endpoints or request unrelated files. Note: the script reads all .md files under the vault and opens an editor via os.system, which executes a shell command — see user guidance.
Install Mechanism
No install spec; this is instruction-only with a bundled script file. No downloads or third-party package installs are performed by the skill itself.
Credentials
Only optional environment variables are used (ZK_VAULT to set vault location and EDITOR to open files). These are appropriate and proportional to a local note-management tool; no credentials or unrelated secrets are requested.
Persistence & Privilege
always:false and user-invocable:true. The skill writes files to the user-specified vault (normal for this purpose). It does not modify other skills or global agent configuration.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install znote - 安装完成后,直接呼叫该 Skill 的名称或使用
/znote触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release of znote: a Python CLI tool to create and manage a Zettelkasten slip-box note system.
- Implements full Zettelkasten workflow including fleeting, literature, permanent notes, and Maps of Content.
- Provides commands for inbox processing, note linking, orphan finding, map generation, full-text search, and stats.
- Uses Markdown files compatible with Obsidian, with double-bracket wiki-linking.
- No dependencies beyond Python 3.8+; supports custom vault locations and editors via environment variables.
- Outputs `zk.py` and `README.md` for quick setup and reference.
元数据
常见问题
Zettelkasten note tool 是什么?
Create, manage, and operate a Zettelkasten slip-box note system using the zk.py CLI script. Use this skill whenever a user wants to build or use a Zettelkast... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 107 次。
如何安装 Zettelkasten note tool?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install znote」即可一键安装,无需额外配置。
Zettelkasten note tool 是免费的吗?
是的,Zettelkasten note tool 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Zettelkasten note tool 支持哪些平台?
Zettelkasten note tool 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Zettelkasten note tool?
由 Jay(@goog)开发并维护,当前版本 v1.0.0。
推荐 Skills