← Back to Skills Marketplace
hxy9243

zettel-brainstormer

by Xiaoyu Kevin Hu · GitHub ↗ · v1.1.2 · MIT-0
cross-platform ✓ Security Clean
503
Downloads
0
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install zettel-brainstormer
Description
Build structured brainstorming notes from a seed zettel by retrieving linked notes, preprocessing each note with subagents for relevance extraction, drafting...
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install zettel-brainstormer
  3. After installation, invoke the skill by name or use /zettel-brainstormer
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug zettel-brainstormer
Version 1.1.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 5
Frequently Asked Questions

What is zettel-brainstormer?

Build structured brainstorming notes from a seed zettel by retrieving linked notes, preprocessing each note with subagents for relevance extraction, drafting... It is an AI Agent Skill for Claude Code / OpenClaw, with 503 downloads so far.

How do I install zettel-brainstormer?

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

Is zettel-brainstormer free?

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

Which platforms does zettel-brainstormer support?

zettel-brainstormer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created zettel-brainstormer?

It is built and maintained by Xiaoyu Kevin Hu (@hxy9243); the current version is v1.1.2.

💬 Comments