← Back to Skills Marketplace
128
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install obsidian-master
Description
Especialista em Obsidian com domínio em Zettelkasten, PARA, BASB, MOCs, Dataview, Templater e organização estruturada de vaults.
Usage Guidance
This skill is functionally consistent with an Obsidian Local REST API integration, but there are notable mismatches you should resolve before installing:
- Confirm required environment variables: package.json and README require OBSIDIAN_API_KEY and OBSIDIAN_URL, but the registry metadata claimed none. Expect to provide an API key and URL.
- Understand scope: the skill reads and writes your entire vault (creates/moves/deletes notes, modifies canvases, runs searches). Only install if you trust the skill and are comfortable granting that level of access.
- Ensure OBSIDIAN_URL is pointed to your local Obsidian plugin (e.g. https://127.0.0.1:27124). Do NOT point it to a remote or unknown URL — doing so could send your vault contents to an external server.
- Review the bundled code (the tools/*.js files) yourself or run them in a sandbox/VM first. The package includes many executable files (no external install step), so copying the skill into your environment will allow it to run.
- Back up your vault before enabling the skill, and consider limiting exposure (use a dedicated vault or test vault) until you’ve validated behavior.
Because some source files were truncated in the submission, consider asking the author for: (1) a clear list of required env vars in the registry metadata, (2) confirmation that OBSIDIAN_URL defaults to localhost and (3) a signed/hosted release or repository link you can inspect fully. If you want, I can produce a checklist of specific files and code patterns to review for exfiltration (e.g., any hardcoded external URLs, non-local default for OBSIDIAN_URL, or use of remote network libraries).
Capability Analysis
Type: OpenClaw Skill
Name: obsidian-master
Version: 1.0.0
The Obsidian Master skill bundle is a comprehensive and well-structured toolset for managing an Obsidian vault via the Local REST API. It implements productivity methodologies like PARA and Zettelkasten, providing 66 tools for note CRUD operations, Canvas manipulation, vault diagnostics (health/stats), and automated Map of Content (MOC) generation. The code is modular, lacks external dependencies, and follows security best practices such as requiring explicit confirmation and performing automatic archiving (moving to an archive folder) before deleting files or folders. No indicators of data exfiltration, malicious execution, or harmful prompt injection were found; all behaviors are strictly aligned with the stated purpose of personal knowledge management.
Capability Assessment
Purpose & Capability
The skill's name, description, SKILL.md, README and the tool code all align with an Obsidian-local-REST-API integration and need an OBSIDIAN_API_KEY and OBSIDIAN_URL to operate. However the registry metadata at the top of the submission claims "Required env vars: none" while package.json lists required_env [OBSIDIAN_API_KEY, OBSIDIAN_URL]. This mismatch is an incoherence: a consumer should expect the skill to require those credentials for its stated purpose.
Instruction Scope
SKILL.md explicitly instructs the agent to read and write vault content, process the inbox and run many operations that access the user's entire vault. The runtime instructions and the included tool files also perform GET/PUT/POST/HEAD requests against the configured OBSIDIAN_URL for arbitrary vault files. That is expected for this use-case, but it grants the skill broad read/write access to a user's notes — a privacy-sensitive scope. Also SKILL.md tells the user to copy the skill directory into their skills folder which, combined with the bundled code, will run code that interacts with the vault.
Install Mechanism
There is no external installer or network download; the README instructs local copy into the skills directory. That reduces supply-chain risk. However the submission is marked as "instruction-only" while the package contains 140+ code files. This discrepancy should be clarified: code is present and will be executed by the agent runtime if installed.
Credentials
The code requires an Obsidian API Key and URL (package.json and tools reference CONFIG.apiKey/OBSIDIAN_API_KEY and buildUrl(OBSIDIAN_URL)). These credentials are appropriate for controlling a local Obsidian REST API. The incoherence is that registry metadata lists no required env vars while package.json and README instruct the user to set them. Also note the skill's behavior depends entirely on the OBSIDIAN_URL value — if the user points it to a remote host instead of localhost, the skill could send vault contents to an external server, so the user must ensure OBSIDIAN_URL is set only to a trusted local endpoint.
Persistence & Privilege
The skill is not marked always:true and uses normal model invocation (default). It does require broad vault read/write access by design, but it does not request elevated platform-wide privileges or modify other skills' configs based on the provided files and metadata.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install obsidian-master - After installation, invoke the skill by name or use
/obsidian-master - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Obsidian Master 1.0.0 – initial release.
- Apresenta regras completas de nomenclatura e estrutura do vault (Zettelkasten, PARA, BASB, MOC, etc.)
- Define fluxos automáticos para criação, busca e processamento de notas, projetos, diários e zettels
- Detalha comandos de linguagem natural suportados e respostas padronizadas (sucesso, erro, aviso)
- Inclui exemplos de frontmatter para diferentes tipos de notas e pastas
- Describe o processo inteligente para processar a Inbox e sugerir ações
- Estabelece filosofia de trabalho e boas práticas para organização e revisão contínua
Metadata
Frequently Asked Questions
What is Obsidian Perfect?
Especialista em Obsidian com domínio em Zettelkasten, PARA, BASB, MOCs, Dataview, Templater e organização estruturada de vaults. It is an AI Agent Skill for Claude Code / OpenClaw, with 128 downloads so far.
How do I install Obsidian Perfect?
Run "/install obsidian-master" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Obsidian Perfect free?
Yes, Obsidian Perfect is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Obsidian Perfect support?
Obsidian Perfect is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Obsidian Perfect?
It is built and maintained by Nettin (@playandogamer150-commits); the current version is v1.0.0.
More Skills