← Back to Skills Marketplace
Zettel Link
by
Xiaoyu Kevin Hu
· GitHub ↗
· v1.1.3
592
Downloads
0
Stars
2
Active Installs
5
Versions
Install in OpenClaw
/install zettel-link
Description
This skill maintains the Note Embeddings for Zettelkasten, to search notes, retrieve notes, and discover connections between notes.
Usage Guidance
This skill appears to do what it says: index and search notes by sending note text to an embedding provider. Before installing or running it: (1) decide whether you want note content sent to remote APIs — use a local Ollama model for better privacy; (2) if you use OpenAI/Gemini, set API keys as environment variables instead of placing long-lived keys in the skill folder .env unless you trust the installation location; (3) inspect config/config.json and the scripts (already included) if you have concerns; (4) be aware the scripts will create a .embeddings directory inside the target notes directory to store caches and results. If you want stronger guarantees, run the code on a copy of your vault or run only with a local provider.
Capability Analysis
Type: OpenClaw Skill
Name: zettel-link
Version: 1.1.3
The OpenClaw skill 'zettel-link' is classified as benign. The Python scripts are designed for semantic search and linking of notes, using local or remote embedding providers. A critical security control is implemented in `scripts/embed.py` (and used by `scripts/search.py`): the `validate_url` function strictly enforces `ALLOWED_DOMAINS` for all API calls, preventing data exfiltration to arbitrary external endpoints. API keys are handled securely by reading from environment variables or a local `.env` file for legitimate API authentication, without any evidence of malicious intent or exfiltration. The `SKILL.md` and `README.md` files contain clear, functional instructions without any prompt injection attempts.
Capability Assessment
Purpose & Capability
The name/description (zettelkasten embeddings, search, linking) matches the included Python scripts which enumerate, embed, cache, search, and compute similarities for markdown notes. Network access to embedding providers (Ollama/OpenAI/Gemini) is expected for this purpose.
Instruction Scope
Runtime instructions are narrowly scoped: run config → embed → search/link. The scripts traverse only the supplied notes directory, create/read a local cache (.embeddings) and may send note text to the configured embedding provider. The SKILL.md explicitly instructs providing API keys (env or local .env) for remote providers. This transmission of note contents to remote APIs is expected for embedding but is a privacy consideration the user should be aware of.
Install Mechanism
There is no install spec that downloads external code; the package is instruction-first and includes Python scripts. No remote archives, launchers, or post-install hooks are present in the manifest.
Credentials
The skill does not declare required environment variables in the registry, but supports optional OPENAI_API_KEY and GEMINI_API_KEY (and uses a local .env fallback). That is proportionate to its ability to call remote embedding APIs. Users should avoid placing sensitive/global credentials into the skill directory unless they trust the code and host.
Persistence & Privilege
The skill does not request permanent/always-on inclusion and does not attempt to modify other skills or system-wide agent settings. It writes only to the note-directory cache (.embeddings) and its own config/config.json.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install zettel-link - After installation, invoke the skill by name or use
/zettel-link - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.3
- Added _meta.json file for metadata tracking and improved skill management.
- No changes to core features or functionality.
v1.1.2
Security hardening: switch Gemini to header-based auth, add URL validation, and declare env vars
v1.1.1
Security patch: support local .env for keys
v1.1.0
Support loading API keys from local .env to improve security posture and reduce environment scanning suspicion
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Zettel Link?
This skill maintains the Note Embeddings for Zettelkasten, to search notes, retrieve notes, and discover connections between notes. It is an AI Agent Skill for Claude Code / OpenClaw, with 592 downloads so far.
How do I install Zettel Link?
Run "/install zettel-link" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Zettel Link free?
Yes, Zettel Link is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Zettel Link support?
Zettel Link is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Zettel Link?
It is built and maintained by Xiaoyu Kevin Hu (@hxy9243); the current version is v1.1.3.
More Skills