← 返回 Skills 市场
zettel-brainstormer
作者
Xiaoyu Kevin Hu
· GitHub ↗
· v1.1.2
· MIT-0
503
总下载
0
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install zettel-brainstormer
功能描述
Build structured brainstorming notes from a seed zettel by retrieving linked notes, preprocessing each note with subagents for relevance extraction, drafting...
安全使用建议
This skill appears internally consistent and implements the described local-note brainstorming pipeline, but consider these practical cautions before installing:
- Privacy: the workflow reads your local vault (zettel_dir) and the SKILL.md explicitly requires the agent to "ALWAYS include" the final list of references in chat replies — that may expose note titles and absolute file paths in conversation logs. If you keep sensitive notes in the vault, either avoid using the skill or remove/segregate sensitive files first.
- External dependency: the skill will optionally call an external `zettel-link` skill if available. Review that other skill before allowing it to run, since its semantic retrieval behavior could include different I/O or network interactions.
- Model calls & cost: the workflow spawns one subagent per candidate note plus drafting/publisher subagents. This can result in many model invocations (cost and data sent to your model provider). Confirm which models are configured in config/models.json and whether those model invocations are acceptable for your privacy/cost constraints.
- Local writes: the setup script saves config to config/models.json and the scripts write intermediate outputs (e.g., /tmp). If you prefer not to persist config, run setup in a safe environment or edit config manually.
- Audit before use: because this is instruction + script bundle, you can safely inspect and run the Python scripts in a sandbox to confirm behavior. If you plan to allow autonomous agent invocation, limit the agent's permissions or review platform audit logs so you can see which notes were accessed.
If none of these concerns are blocking, the skill is consistent with its stated purpose and reasonable to use.
功能分析
Type: OpenClaw Skill
Name: zettel-brainstormer
Version: 1.1.2
The zettel-brainstormer skill bundle is a well-structured tool for synthesizing Obsidian/Zettelkasten notes into blog posts. The Python scripts (scripts/find_links.py, scripts/compile_preprocess.py, scripts/obsidian_utils.py) focus on local file I/O, regex-based parsing of wikilinks and tags, and relevance filtering without any evidence of network exfiltration or dangerous shell execution. The agent instructions in SKILL.md and the agents/ directory are strictly aligned with the stated purpose of research and drafting, and no malicious prompt injection or unauthorized access patterns were detected.
能力评估
Purpose & Capability
Name/description match the actual behavior: scripts and agent prompts operate on an Obsidian/Zettelkasten vault (zettel_dir), find linked notes, preprocess them, compile a draft packet, and run drafting/publishing subagents. There are no unrelated environment variables, external credentials, or unexpected binaries required.
Instruction Scope
Runtime instructions explicitly tell the agent to read the user's notes (zettel_dir and seed note), run local scripts, spawn one subagent per candidate note, and always include the final list of references in the chat response. This is consistent with the feature, but be aware that the forced inclusion of references may expose absolute filepaths or note titles from your local vault in agent responses and telemetry. The skill also optionally invokes an external 'zettel-link' skill if present — you should confirm the behavior of that skill before allowing it to run.
Install Mechanism
No install spec is provided (instruction-only), and bundled scripts are plain Python code — there are no downloads from untrusted URLs or extract/install steps. The setup script writes a local config file (config/models.json) and scripts read/write intermediate files under /tmp or configured output_dir.
Credentials
The skill declares no required environment variables or credentials. The bundled config_manager will read optional DEFAULT_MODEL or MODEL environment variables if present (to choose model tiers), but these are not secrets. No keys, tokens, or unrelated service credentials are requested.
Persistence & Privilege
always is false and the skill does not request to be always-enabled. It writes/reads only its own config (config/models.json) and temporary outputs; it does not modify other skills or system-wide agent settings.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install zettel-brainstormer - 安装完成后,直接呼叫该 Skill 的名称或使用
/zettel-brainstormer触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.1.2
docs: gracefully fallback if zettel-link is missing and mandate references in user output
v1.1.1
Refactor into 4-stage workflow (Retrieval/Preprocess/Draft/Publish); add relevance-filtered draft packet + stronger citation requirements; cleanup deprecated scripts & examples.
v1.1.0
- Added integration with obsidian-cli for native, high-performance note discovery.
- Optional semantic discovery via the zettel-link skill to find conceptually relevant (but unlinked) notes.
- Introduced a new config field: discovery_mode (options: standard, cli, semantic).
- Clarified and updated documentation for workflows and configuration.
- Added a README.md file for easier onboarding.
v1.0.1
- No changes detected; this release does not introduce any updates to code or documentation.
- Version number updated to 1.0.1 without file modifications.
v1.0.0
Initial release: 3-stage pipeline for linking, preprocessing, and drafting.
元数据
常见问题
zettel-brainstormer 是什么?
Build structured brainstorming notes from a seed zettel by retrieving linked notes, preprocessing each note with subagents for relevance extraction, drafting... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 503 次。
如何安装 zettel-brainstormer?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install zettel-brainstormer」即可一键安装,无需额外配置。
zettel-brainstormer 是免费的吗?
是的,zettel-brainstormer 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
zettel-brainstormer 支持哪些平台?
zettel-brainstormer 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 zettel-brainstormer?
由 Xiaoyu Kevin Hu(@hxy9243)开发并维护,当前版本 v1.1.2。
推荐 Skills