Obsidian Through

Configure, repair, explain, and verify private Obsidian synchronization across Windows, macOS, GitHub, and mobile devices. 配置、修复、解释并验证 Windows、macOS、GitHub 与移动设备之间的 Obsidian 私有同步。Use for private vault repositories, Windows edit-event sync, macOS Obsidian Git sync, mobile setup, GitHub token/key guidance, Pull/Commit/Push workflow explanation, device-setting isolation, duplicate-note diagnosis, accidental deletion recovery, multi-device sync strategy, failed pushes, and end-to-end checks. 用于私有笔记仓库、Windows 编辑事件同步、macOS Obsidian Git 同步、移动端配置、GitHub Token/Key 指导、Pull/Commit/Push 工作流解释、设备设置隔离、重复笔记诊

53 stars 1 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add Wh1tZz/Obsidian-through --skill obsidian-through

Manual install

git clone --depth 1 https://github.com/Wh1tZz/Obsidian-through.git /tmp/Obsidian-through
mkdir -p ~/.claude/skills
cp -r /tmp/Obsidian-through/. ~/.claude/skills/obsidian-through

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 中文版

## 目标

建立数据链路：`Windows/macOS Obsidian 笔记库 <-> GitHub 私有仓库 <-> 移动端 Obsidian 笔记库`。

将用户的私有 GitHub 笔记仓库作为数据中心。Skill 自身可以发布到公开仓库，但公开仓库只能包含通用脚本和文档，绝不能包含用户笔记、Token、账号凭据、本机路径或运行日志。

## 工作流

### 交互式配置协议

当用户说“帮我配置 Obsidian 和 GitHub”或同义请求时，必须按以下顺序执行：

先运行 `npx obsidian-through platform` 或读取运行时平台。`win32` 使用 `scripts/setup-windows.ps1` 和 Windows 事件监听器；`darwin` 使用 `scripts/setup-macos.sh`、原生 Git/GitHub CLI 与 Obsidian Git 自动同步。禁止在 macOS 运行 Windows 计划任务脚本，也禁止把 macOS 当作移动端。默认入口 `npx obsidian-through` 必须自动选择对应电脑端流程，安装缺失工具、打开 GitHub 网页登录、识别 Obsidian vault、创建或连接私有仓库、上传或安全合并笔记、配置平台对应的自动同步并验证。

面向用户输出时，PC 端和移动端都使用简短的“去哪里 → 点什么 → 填什么”步骤和可复制代码块。主流程不解释原理、不重复注意事项、不预先展开错误分支；只有实际报错时才读取故障排查并给对应处理。主流程中只把两个网址作为 Markdown 可点击链接输出：GitHub 登录页 `[https://github.com/login/device](https://github.com/login/device)`，GitHub Token 创建页 `[https://github.com/settings/personal-access-tokens/new](https://github.com/settings/personal-access-tokens/new)`。其他值必须来自脚本或 GitHub API，并放入 fenced code block。每个需要复制或在命令面板运行的值都必须使用独立代码块；`Git: Pull` 与 `Git: Commit-and-sync` 不得放在同一代码块。克隆阶段分别输出仓库 URL 和脚本生成的真实仓库名。真实仓库名可以是用户的任意仓库名，必须从当前远程动态取值，禁止固定写成 `obsidian-vault`。移动端必须克隆到以该真实仓库名命名的新子文件夹，不选择 `Vault Root`。不要向用户输出 `.obsidian` 选择、删除本地配置或 `Custom base path` 说明。GitHub Token 页面按当前界面顺序输出中英文标签。

1. Windows 阅读 [references/desktop.md](references/desktop.md)，macOS 阅读 [references/macos.md](references/macos.md)。若用户要求模拟或复盘完整用户输出，同时阅读 [references/user-facing-output.md](references/user-facing-output.md) 中文版。

Read the full skill on GitHub

Details

Skill name: obsidian-through
Repository: Wh1tZz/Obsidian-through
License: MIT
Repo updated: 11 August 2026

FAQ

What does the Obsidian Through skill do?

How do I install the Obsidian Through skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add Wh1tZz/Obsidian-through --skill obsidian-through. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Obsidian Through popular?

It lives in Wh1tZz/Obsidian-through, which has 53 GitHub stars and 1 forks.

Related skills

Project Wiki

giodra96/project-wiki

Create, scan, update, sync, and maintain .project-wiki/ project knowledge bases, including requirements, document intake, and traceability. Consult and update an existing project wiki during coding tasks.

Productivity & Notes

Spec to Implementation

makenotion/cursor-notion-plugin

Turn product or tech specs into concrete Notion tasks. Breaks down spec pages into detailed implementation plans with clear tasks, acceptance criteria, and progress tracking.

Productivity & NotesIn 1 list20

Zhiwen Wo

Mortis114114/zhiwen-wo

Use only when the user explicitly selects this skill for a single requirements interview about the task currently under discussion. Never infer invocation from ordinary chat, keywords, or the skill name.

Productivity & Notes

Memory Lancedb Pro

win4r/memory-lancedb-pro-skill

Comprehensive guide for maintaining, debugging, and upgrading the memory-lancedb-pro OpenClaw plugin — an enhanced LanceDB-backed long-term memory system with hybrid retrieval (Vector + BM25), cross-encoder reranking, multi-scope isolation, noise filtering, adaptive retrieval, and a management CLI. Use this skill when: (1) developing new features or fixing bugs in memory-lancedb-pro, (2) modifying the retrieval pipeline (vector search, BM25, RRF fusion, reranking, scoring stages), (3) adding or changing embedding providers, (4) updating scope/access control logic, (5) modifying agent tools or

Productivity & Notes

B2b Lead Hunter

xiongQvQ/-b2b-lead-hunter-skill

Use when researching foreign-trade B2B leads, buyer companies, distributors, importers, wholesalers, reachable decision makers, customs/import signals, and outreach-ready contacts from product, region, ICP, website, or document inputs. Use for evidence-backed lead hunting, qualification, exportable lead files, regional/language email templates, company-personalized email drafts, and controlled SMTP sending after approval.

Productivity & Notes10

Meeting Intelligence

makenotion/cursor-notion-plugin

Prepare meeting materials by gathering context from Notion, enriching with research, and creating both an internal pre-read and external agenda saved to Notion.

Productivity & NotesIn 1 list20

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.