← 返回 Skills 市场
221
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install obsidian-github-sync
功能描述
Automated GitHub synchronization for Obsidian vault with conflict detection and notification. Use when the user wants to: - Sync their Obsidian vault to a Gi...
安全使用建议
This skill appears to do what it says (auto-commit, pull --rebase, push, and signal conflicts), but review and test before deploying. Concrete precautions:
- Inspect the two scripts yourself. They run git init / git remote add and will modify the vault directory and .git metadata; run them first on a throwaway test copy of your vault.
- The registry metadata does not declare required env vars; set and verify these before running: OBSIDIAN_VAULT_DIR and GITHUB_REMOTE_URL. Ensure the remote URL/branch is correct (script hardcodes 'origin master').
- The script relies on your Git/SSH credentials (it does not prompt for or store tokens). Ensure your SSH keys are configured and that you understand whether the remote uses 'main' vs 'master'.
- Backup your vault before enabling automated cron/systemd runs. Automated commits + rebase can rewrite history or cause surprises if misconfigured.
- Consider changing log/flag file locations and permissions if multiple users share the system; /tmp is world-readable on many systems and will contain repository path/remote in the flag file.
- If you want the skill in an agent context, require that the agent only run it with an explicit configured OBSIDIAN_VAULT_DIR (avoid letting the skill infer paths) and avoid granting broad filesystem access.
If you want, I can point out exact lines in the scripts to modify (branch name, logging path, preventing automatic git init/remote add) and produce a safer variant you can test.
功能分析
Type: OpenClaw Skill
Name: obsidian-github-sync
Version: 1.0.0
The skill provides a legitimate utility for synchronizing an Obsidian vault with a GitHub repository using shell scripts (`obsidian-sync.sh` and `check-conflict.sh`). The logic follows standard Git workflows (add, commit, rebase, push), uses user-defined environment variables for configuration, and includes helpful documentation for manual conflict resolution and automation via cron or systemd.
能力评估
Purpose & Capability
The name/description (Obsidian <-> GitHub sync) aligns with the included scripts: they commit local changes, pull --rebase, and push to a remote. The behavior (conflict flagging, cron/systemd examples) is consistent with the stated purpose. Minor mismatch: scripts assume branch name 'master' which may not match many repos using 'main'.
Instruction Scope
SKILL.md and the two scripts instruct the agent (and a user) to read and write the vault directory, create/modify the .git repository, write logs (/tmp/obsidian-sync.log) and a conflict flag (/tmp/obsidian-sync-conflict.flag), and run git operations (init, remote add, commit, pull --rebase, push). These actions stay within the scope of syncing but are far-reaching (they can initialize repos and modify git history). The instructions do not request or transmit data to any unexpected external endpoints beyond the configured GitHub remote.
Install Mechanism
No install spec and only small shell scripts are included. Nothing is downloaded from external URLs and no archives are extracted. Risk from installation is low because there is no automated network install step.
Credentials
The registry metadata lists no required environment variables, but SKILL.md and the scripts require OBSIDIAN_VAULT_DIR and GITHUB_REMOTE_URL (and optionally other env vars). That mismatch is an incoherence: the skill effectively needs filesystem and git/SSH access but the registry does not declare or surface those requirements. The requested env variables themselves are reasonable for the task (they don't include unexpected secret tokens), but GITHUB_REMOTE_URL implies use of SSH keys or credentials which the skill does not manage.
Persistence & Privilege
always:false and the skill is user-invocable; it does not demand forced always-on presence. The scripts suggest adding cron/systemd timers but that is optional and under user control. The skill does modify the vault directory (including initializing a .git repo) which is expected for its purpose but is a privileged filesystem action the user should approve.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install obsidian-github-sync - 安装完成后，直接呼叫该 Skill 的名称或使用
/obsidian-github-sync触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release: Automated GitHub sync for Obsidian vault with conflict detection
元数据
常见问题
Obsidian GitHub Sync 是什么？
Automated GitHub synchronization for Obsidian vault with conflict detection and notification. Use when the user wants to: - Sync their Obsidian vault to a Gi... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 221 次。
如何安装 Obsidian GitHub Sync？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install obsidian-github-sync」即可一键安装，无需额外配置。
Obsidian GitHub Sync 是免费的吗？
是的，Obsidian GitHub Sync 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Obsidian GitHub Sync 支持哪些平台？
Obsidian GitHub Sync 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Obsidian GitHub Sync？
由 Leo-zzl（@leo-zzl）开发并维护，当前版本 v1.0.0。
推荐 Skills