Sync to Obsidian — Auto-Detect Project Sync

Automatically sync your Claude Code session plans and implementation reports to your Obsidian vault.

Every sync produces two files: a detailed Markdown note + an Obsidian Canvas visual map.

The project name is auto-detected — no per-project configuration needed.

Configuration

Only one path to set — your Obsidian vault root:

OBSIDIAN_VAULT = /Users/you/Documents/Obsidian Vault

Update this to your actual Obsidian vault path before first use.

Auto Project Detection

The skill automatically detects the current project name (in priority order):

1. Git repo name: basename $(git rev-parse --show-toplevel)
2. Current directory name: basename $PWD (fallback if not in a git repo)

Sync targets are derived from the project name:

• Markdown: {OBSIDIAN_VAULT}/[Project] {project_name}/
• Canvas: {OBSIDIAN_VAULT}/[Project] {project_name}/canvas/

Directories are auto-created if they don't exist (mkdir -p).

Usage

/sync-obsidian plan               # Sync the latest plan file
/sync-obsidian report             # Generate and sync an implementation report
/sync-obsidian plan Auth Redesign # Sync plan with custom title
/sync-obsidian report API Layer   # Sync report with custom title

• $ARGUMENTS[0]: Type — plan or report (required)
• $ARGUMENTS[1]: Custom title (optional — auto-inferred from content if omitted)

Execution Flow

Step 0: Detect Project

1. Run basename $(git rev-parse --show-toplevel 2>/dev/null) 2>/dev/null || basename $PWD to get project name
2. Set PROJECT_DIR = [Project] {project_name}
3. Set CANVAS_DIR = [Project] {project_name}/canvas
4. Run mkdir -p to ensure both directories exist

When type = plan

1. Read the latest .md file from .claude/plans/
2. If no plan file found, extract plan content from the current conversation context
3. Convert to Obsidian note format (see templates below)
4. Write Markdown to {OBSIDIAN_VAULT}/{PROJECT_DIR}/
5. Write Canvas to {OBSIDIAN_VAULT}/{CANVAS_DIR}/
6. Filename: [Plan] {title} ({YYYY-MM-DD}).md / .canvas

When type = report

1. Summarize the implementation work completed in the current session
2. Include: what was done, which files changed, key design decisions, follow-up TODOs
3. Convert to Obsidian note format
4. Write Markdown to {OBSIDIAN_VAULT}/{PROJECT_DIR}/
5. Write Canvas to {OBSIDIAN_VAULT}/{CANVAS_DIR}/
6. Filename: [Report] {title} ({YYYY-MM-DD}).md / .canvas

Markdown Templates

Plan Template

# [Plan] {title}

> Date: {YYYY-MM-DD}
> Source: Claude Code Session
> Project: {project_name}
> Status: Pending / Approved

---

{Original plan content, preserved in full markdown}

---

> Synced from `.claude/plans/{filename}`

Report Template

# [Report] {title}

> Completed: {YYYY-MM-DD}
> Source: Claude Code Session
> Project: {project_name}

---

## Summary

{1-3 sentence overview}