---
title: "vault-assistant"
description: "Subagent + slash commands for running a PARA-structured Obsidian vault end-to-end: daily/weekly/monthly ceremony, project status, research-repo patrol, wiki knowledge extraction, archival, and a GitHub Issues ↔ vault Hub"
canonical: https://agentpluginsdirectory.com/plugins/vault-assistant
last-updated: 2026-11-01
---

# vault-assistant
Subagent + slash commands for running a PARA-structured Obsidian vault end-to-end: daily/weekly/monthly ceremony, project status, research-repo patrol, wiki knowledge extraction, archival, and a GitHub Issues ↔ vault Hub issue workflow, all auto-committed to git. Quartz-compatible wikilinks enforced.
- Slug: vault-assistant
- Publisher: Ricky
- Repository: https://github.com/RDCrystalLab/agentic-plugins
- Manifest: plugins/vault-assistant/plugin.json
- Version: 0.3.1
- License: MIT
- Category (editorial): productivity
- Skills: 4 (gh-contribution-report, gh-issues-to-doc, github-query, new-project)
- MCP servers: 0
- Stars: 0
- Repository created: 2026-01-10
- Repository last pushed: 2026-08-15
- Publisher type: Organization
- Listing: https://agentpluginsdirectory.com/plugins/vault-assistant
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What vault-assistant does, in the publisher's words

在任何 PARA 結構的 Obsidian vault 上跑完整 ceremony 的 Claude Code plugin。內建 vault-assistant subagent、14 個 slash command、4 個 skill，涵蓋日 / 週 / 月報、專案狀態、research-repo 巡檢、wiki 知識萃取與歸檔、以及 GitHub Issues ↔ vault 雙向 Hub issue workflow，每次寫入都自動 git add + commit + push（對齊 AGENTS.md 規則）。

用 Obsidian + Quartz 發佈的個人 vault 作者，採用 PARA（Projects / Areas / Resources / Archives）組織、每天寫 daily note、每週 weekly、每月 monthly，想讓 Claude Code 接手儀式性操作。

- vault-assistant: 知道 PARA 放置規則、Quartz-shortest wikilink 格式、每次寫入要 auto commit+push，會把多步 ceremony（morning briefing、end-of-day、weekly retrospective、monthly rollup）串起來跑。任何涉及 vault 的指令都建議改委派給它。
- new-project: 在 vault 新增專案、更新 Projects/index.md
- gh-contribution-report: 從 GitHub org 抓 commits / PRs 生成月報與年報
- gh-issues-to-doc: 把 GitHub Issues 轉成結構化 Obsidian 筆記
- github-query: vault-first 的 GitHub repo / issue / PR 查詢層，優先讀 research-repos note，未命中才 fallback 到本地 clone 與 gh CLI，並在值得追蹤時建議 /watch-repo 沉澱

透過 marketplace：

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/RDCrystalLab/agentic-plugins/HEAD/plugins/vault-assistant/README.md

## Skills

- gh-contribution-report: 從 GitHub 組織抓取 commits 與 PRs，生成詳細月報與年報至 Obsidian vault。觸發關鍵詞：「貢獻報告」、「contribution report」、「年報」、「月報產出」、「GitHub 貢獻」。
- gh-issues-to-doc: 將 GitHub Issues 轉換為 Obsidian 筆記文件。支援取得 issue 內容、留言、sub-issues、附圖下載（含 private repo），並產生結構化的 Obsidian Markdown 文件。觸發關鍵詞：「issue 整理」、「issue 轉文件」、「issue to doc」、「整理 issue」。
- github-query: 回答關於 GitHub repo / issue / PR 的問題，vault-first 查詢。當用戶提到某個 GitHub repo、問某個 repo 做什麼、問 issue / PR、或說「這個 repo」、「那個倉庫」、「query repo」、「查 github」時使用。優先讀 vault 裡已沉澱的 research-repos note，未命中才 fallback 到本地 clone 與 `gh` CLI，並在發現值得追蹤時建議用 `/vault-assistant:watch-repo` 沉澱進 vault。
- new-project: 在 Obsidian vault 新增一個專案並更新 Projects/index.md。當用戶想建立新專案、開始追蹤一個新項目、或說「新增專案」、「建立專案」、「create project」、「add project」時使用。會引導用戶填入基本資訊後自動建立目錄結構與更新 index。

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.