メニュー
Initialize and onboard a new project repository as an Obsidian Vault. Covers prerequisite installation, vault configuration, exclusion filters, and validation. Use when setting up Obsidian for the first time in a project.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SOC 職業分類に基づく
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/richfrem/Project_Sanctuary --skill obsidian-initコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
ADR management skill. Auto-invoked for generating architecture decisions, documenting design rationale, and maintaining the decision record log. Uses native read/write tools to scaffold and update ADR markdown files.
(Industry standard: Parallel Agent) Primary Use Case: Work that can be partitioned into independent sub-tasks running concurrently across multiple agents. Parallel multi-agent execution pattern. Use when: work can be partitioned into independent tasks that N agents can execute simultaneously across worktrees. Includes routing (sequential vs parallel), merge verification, and correction loops.
Systematically analyze agent plugins and skills to extract design patterns, architectural decisions, and reusable techniques. Trigger with "analyze this plugin", "mine patterns from", "review plugin structure", "extract learnings from", "what patterns does this plugin use", or when examining any plugin or skill collection to understand its design.
| name | obsidian-init |
| description | Initialize and onboard a new project repository as an Obsidian Vault. Covers prerequisite installation, vault configuration, exclusion filters, and validation. Use when setting up Obsidian for the first time in a project. |
| allowed-tools | Bash, Read, Write |
Status: Active Author: Richard Fremmerlid Domain: Obsidian Integration
This skill is the entry point for any project adopting Obsidian. It handles:
The Obsidian desktop app must be installed on the host machine. It is the visual interface for browsing, editing, and viewing the Graph and Canvas.
macOS (Homebrew):
brew install --cask obsidian
Manual Download:
Verify:
ls /Applications/Obsidian.app
The official CLI communicates with a running Obsidian instance via IPC singleton lock. It enables programmatic vault operations (read, search, backlinks, properties).
npm (global install):
npm install -g obsidian-cli
Verify:
obsidian --version
Note: The CLI requires an active Obsidian Desktop instance to communicate with. It operates in "silent" mode by default. For headless/CI environments where Obsidian is not running, our
vault_ops.py(fromobsidian-vault-crud) handles direct filesystem operations without requiring the CLI.
Lossless YAML frontmatter handling requires ruamel.yaml:
pip install ruamel.yaml
For advanced vault features, install these from within the Obsidian app:
| Plugin | Purpose | Required For |
|---|---|---|
| Dataview | Database-style queries over frontmatter | Structured metadata queries |
| Canvas (built-in) | Visual boards with JSON Canvas spec | obsidian-canvas-architect skill |
| Bases | Table/grid/card views from YAML | obsidian-bases-manager skill |
python ./scripts/init_vault.py --vault-root <path>
python ./scripts/init_vault.py \
--vault-root <path> \
--exclude "custom_dir/" "*.tmp"
python ./scripts/init_vault.py --vault-root <path> --validate-only
.md files.obsidian/ configuration directory (if not present)app.json with sensible exclusion filters for developer repos.gitignore to exclude .obsidian/ (user-specific config)| Pattern | Reason |
|---|---|
node_modules/ | NPM dependencies |
.worktrees/ | Git worktree isolation |
.vector_data/ | ChromaDB binary data |
.git/ | Git internals |
venv/ | Python virtual environments |
__pycache__/ | Python bytecode cache |
*.json | Data/config files (not knowledge) |
*.jsonl | Export payloads |
learning_package_snapshot.md | Machine-generated bundle |
bootstrap_packet.md | Machine-generated bundle |
learning_debrief.md | Machine-generated bundle |
*_packet.md | Audit/review bundles |
*_digest.md | Context digests |
dataset_package/ | Export artifacts |
These are giant concatenated snapshots produced by bundler/distiller scripts. Indexing them in Obsidian would pollute the graph with thousands of false backlinks pointing into machine-generated text, not human-authored knowledge.
01_PROTOCOLS/, ADRs/, etc. appear in sidebar[[link]] to confirm navigation worksexport VAULT_PATH=/path/to/vaultThis skill is project-agnostic. It works on any Git repository with markdown files. The exclusion filters are sensible defaults for developer projects. When reusing this plugin in other projects, simply run the init script with the new project's root path.
# 1. Install prerequisites
brew install --cask obsidian # Desktop app
npm install -g obsidian-cli # CLI tools
pip install ruamel.yaml # Lossless YAML
# 2. Initialize vault
python ./scripts/init_vault.py \
--vault-root /path/to/your/project
# 3. Set environment variable
export VAULT_PATH=/path/to/your/project
# 4. Open in Obsidian app
open /Applications/Obsidian.app