Community생산성 & 협업github.com

CzhJing/obsidian-sync-skill

Obsidian 동기화 도우미: Agent와 Obsidian을 연결하여 프로젝트 코드베이스를 자동 분석하고 로컬 LLM 위키를 생성하여 토큰과 컨텍스트를 절약합니다.

obsidian-sync-skill란 무엇인가요?

이 스킬은 AI Agent(예: Claude Code, Cursor, Codex)와 Obsidian 노트 앱을 연결하는 동기화 도우미입니다. Agent가 현재 작업 중인 프로젝트의 코드베이스를 분석하고, 로컬 Obsidian 볼트 내에 LLM 친화적인 위키를 자동 생성하여, 모델이 불필요한 토큰 낭비 없이 프로젝트 컨텍스트를 효율적으로 이해하고 유지할 수 있도록 지원합니다. 주요 기능으로는 프로젝트 초기 동기화(/obsidian-sync), 증분 업데이트(/obsidian-sync:update), 기술 스택 및 설명 업데이트(/obsidian-sync:update-project), 개발 로그 추가(/obsidian-sync:log) 등이 있으며, 모든 작업은 references/obsidian-sync-project.md와 references/obsidian-sync-spec.md에 정의된 규칙을 엄격히 따라 일관된 파일 명명, YAML 템플릿, wikiLink, 태그 및 폴더 구조를 유지합니다. 이 스킬은 특히 코드베이스가 크거나 자주 변경되는 프로젝트에서 Agent의 컨텍스트 효율성과 일관성을 크게 향상시킵니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add CzhJing/obsidian-sync-skill

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

트리거 명령어

명령어설명
/obsidian-sync최초 동기화 / 메인 진입점 (init과 동일)
/obsidian-sync:update-project설명 및 기술 스택 업데이트
/obsidian-sync:log개발 로그 추가
/obsidian-sync:update프로젝트 저장소 업데이트 (증분 동기화)

참조 파일 설명

본 스킬을 실행할 때 다음 참조 파일을 자동으로 로드하여 엄격히 준수합니다:

  • references/obsidian-sync-project.md 주요 실행 흐름: 단계별 절차, 메뉴 로직, 액션 실행, 동기화 프로세스

  • references/obsidian-sync-spec.md 기술 규격: 파일 명명, JD 번호, wikiLink, YAML 템플릿, 태그 규칙, 파일 저장 구조

관련 스킬