Agent skill

writing-to-obsidian

Uploads documents to Obsidian Vault. Saves project context to workspace/{project}/context/, research/reports to articles/ with YYYY-MM-DD prefix. Use for "obsidian 업로드", "옵시디언 저장", "vault 업로드", "아티클 저장" requests.

View SKILL.md on GitHub Repository
Stars 10
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/jiunbae/agent-skills/tree/main/integrations/obsidian-writer

SKILL.md

Obsidian Writer - 프로젝트 문서 업로드

Overview

현재 작업 중인 프로젝트의 문서를 Obsidian Vault에 업로드하는 스킬입니다.

핵심 기능:

  • 현재 디렉토리(pwd) 기반 프로젝트명 자동 감지
  • workspace/{프로젝트명}/context/ 경로에 문서 저장 (기본값)
  • 경로 매핑 지원: ~/.agents/OBSIDIAN.md의 "프로젝트 경로 매핑" 테이블에서 커스텀 경로 사용
  • 프로젝트별 문서 체계적 관리
  • 프론트매터(YAML) 자동 생성

저장 구조:

Vault/
├── articles/                     # 리서치, 리포트, 아티클 (날짜 prefix)
│   ├── 2026-01-31-devin-ai-overview.md
│   └── 2026-01-30-claude-code-review.md
├── workspace/                    # ~/workspace/* 프로젝트
│   ├── agent-skills/
│   │   └── context/
│   └── other-project/
│       └── context/
├── workspace-vibe/               # ~/workspace-vibe/* 프로젝트
│   ├── colorpal/
│   │   └── context/
│   └── shared_services/
│       └── context/
└── workspace-ext/                # ~/workspace-ext/* 외부 프로젝트
    ├── clawdbot/
    │   └── context/
    └── vision-insight-api/
        └── context/

경로 매핑 (Path Mapping)

~/.agents/OBSIDIAN.md의 "프로젝트 경로 매핑"에 따라 경로가 결정됩니다:

문서 유형 Obsidian 경로 파일명 규칙
articles (리서치/리포트) articles/ YYYY-MM-DD-{slug}.md
프로젝트 문서 workspace/{project}/context/ 자유

프로젝트 경로 매핑

로컬 경로 Obsidian 경로
~/workspace/{project}/ workspace/{project}/context/
~/workspace-vibe/{service}/ workspace-vibe/{service}/context/
~/workspace-ext/{project}/ workspace-ext/{project}/context/

예시:

  • ~/workspace/agent-skills/ → workspace/agent-skills/context/
  • ~/workspace-vibe/colorpal/ → workspace-vibe/colorpal/context/
  • ~/workspace-ext/clawdbot/ → workspace-ext/clawdbot/context/
  • 리서치 리포트 → articles/2026-01-31-devin-ai-overview.md

Prerequisites

Static 파일 설정 (필수)

~/.agents/OBSIDIAN.md 파일에 Vault 경로 설정:

markdown
# Obsidian 설정

## Vault 경로
- **경로**: /Users/username/Documents/ObsidianVault

## 문서 설정
- **프론트매터 생성**: true
- **태그 자동 생성**: true

Workflow

Step 1: 프로젝트 감지

스킬 실행 시 현재 작업 디렉토리에서 프로젝트명을 자동으로 감지합니다:

bash
# 현재 디렉토리: ~/workspace/agent-skills
# 감지된 프로젝트명: agent-skills
# 저장 경로: Vault/workspace/agent-skills/context/

Step 2: 문서 업로드

bash
# 기본 업로드 (프로젝트 자동 감지)
./scripts/obsidian-write.py \
  --title "API 설계 문서" \
  --content "마크다운 내용"

# 프로젝트 명시
./scripts/obsidian-write.py \
  --title "문서 제목" \
  --content "내용" \
  --project "custom-project"

# 하위 폴더 지정
./scripts/obsidian-write.py \
  --title "회의록" \
  --content "내용" \
  --subfolder "meetings"
# 결과: workspace/agent-skills/context/meetings/회의록.md

Examples

예시 1: 문서 업로드

사용자: 이 API 설계 문서 옵시디언에 업로드해줘

Claude: Obsidian에 업로드를 준비합니다.

## 업로드 정보

- **프로젝트**: agent-skills (자동 감지)
- **저장 경로**: workspace/agent-skills/context/api-design.md

### 문서 미리보기
---
created: 2025-01-15T14:30:00
project: agent-skills
tags: [claude, api, design]
---

# API 설계 문서

[문서 내용...]

이대로 업로드할까요? (Y/n)

예시 2: 하위 폴더에 저장

사용자: 오늘 회의 내용 옵시디언 meetings 폴더에 저장해줘

Claude: 업로드합니다.

✅ 업로드 완료
- 경로: workspace/agent-skills/context/meetings/2025-01-15-meeting.md
- Vault: ~/Documents/ObsidianVault

예시 3: 리서치/리포트를 articles에 저장

사용자: Devin AI 리서치 결과 옵시디언에 저장해줘

Claude: 리서치 리포트를 articles/ 폴더에 저장합니다.

✅ 업로드 완료
- 경로: articles/2026-01-31-devin-ai-overview.md
- 유형: article (리서치/리포트)
- 태그: [ai, software-engineer, cognition-labs, devin, article]

예시 4: 설정 없을 때

사용자: 옵시디언 업로드해줘

Claude: ⚠️ Obsidian 설정이 필요합니다.

~/.agents/OBSIDIAN.md 파일을 생성해주세요:

# Obsidian 설정

## Vault 경로
- **경로**: [여기에 Vault 경로 입력]

설정 파일을 자동으로 생성할까요? (Y/n)

Configuration

~/.agents/OBSIDIAN.md 구조

markdown
# Obsidian 설정

## Vault 경로
- **경로**: /Users/username/Documents/ObsidianVault

## 문서 설정
- **프론트매터 생성**: true
- **태그 자동 생성**: true
- **기본 태그**: claude, context

프론트매터 템플릿

yaml
---
created: 2025-01-15T14:30:00
project: agent-skills
tags: [claude, context, documentation]
---

Best Practices

DO:

  • Vault 경로는 절대 경로로 설정
  • 프론트매터로 메타데이터 관리
  • 일관된 폴더 구조 유지
  • 저장 전 내용 미리보기 확인

DON'T:

  • 민감 정보(API 키, 비밀번호) 저장하지 않기
  • 기존 파일 덮어쓰기 주의 (확인 필요)
  • Obsidian 잠금 파일(.obsidian) 수정하지 않기

Troubleshooting

문제 1: Vault 경로 없음

Error: Vault path not found

해결:

  1. ~/.agents/OBSIDIAN.md에 올바른 경로 설정
  2. 폴더가 실제로 존재하는지 확인
  3. 경로에 공백이 있으면 따옴표로 감싸기

문제 2: 권한 오류

Error: Permission denied

해결:

  1. Vault 폴더 쓰기 권한 확인
  2. chmod 755 /path/to/vault 실행

문제 3: 파일명 충돌

Warning: File already exists

해결:

  • 덮어쓰기 확인 프롬프트 표시
  • 또는 --suffix 옵션으로 번호 추가

Resources

파일 설명
scripts/obsidian-write.py 문서 생성 스크립트
~/.agents/OBSIDIAN.md 사용자 설정 (static-index 참조)

Integration with Other Skills

스킬 연동 방식
static-index OBSIDIAN.md 파일 경로 조회
security-auditor 저장 전 민감 정보 검사
mindcontext 프로젝트별 컨텍스트와 연동

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

jiunbae/agent-skills

implementing-in-background

Orchestrates multiple AI agents (Claude, Codex, Gemini) for parallel implementation in the background. Separates independent tasks from planning docs, each agent writes code directly. Context-safe with auto-save. Use for "백그라운드 구현", "bg impl", "병렬 구현", "Codex로 구현", "구현해줘", "코드 작성해줘" requests.

10 1
Explore
jiunbae/agent-skills

review-fix-loop

Autonomous review-fix cycle that continuously reviews code using background-reviewer, fixes issues, and repeats until all findings are resolved. Use for "리뷰 루프", "자동 개선", "review fix loop", "리뷰 반복", "코드 개선 루프", "keep reviewing" requests.

10 1
Explore
jiunbae/agent-skills

planning-in-background

Orchestrates multiple AI agents (Claude, Codex, Gemini) for parallel planning in the background with auto-save. Agents continue running even when session hits context limits. Use for "백그라운드 기획", "bg plan", "병렬 기획", "멀티 AI 기획", "기획해줘", "N명이 기획", "계획", "플래닝", "plan", "설계" requests.

10 1
Explore
jiunbae/agent-skills

background-reviewer

Orchestrates multi-LLM parallel code review using Claude, Codex, and Gemini. Each agent reviews from a different perspective using agent personas (security, architecture, code quality, performance). Supports persona-based review via `agt persona review`. Use for "코드 리뷰", "리뷰해줘", "bg review", "멀티 리뷰", "background review", "페르소나 리뷰" requests.

10 1
Explore
jiunbae/agent-skills

managing-context

Discovers and loads relevant project context from markdown documentation before each task. Matches context documents based on keywords, file paths, and task types. Use at task start to access project plans, architecture, and implementation status.

10 1
Explore
jiunbae/agent-skills

indexing-static-context

Provides an index of global static context files in ~/.agents/. Returns appropriate static file paths for natural language queries like "내 정보", "보안 규칙". Use when other skills or agents need to locate reference information.

10 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results