Agent Skill 가이드

개요

AI4PKM Skills는 개인 지식관리 워크플로우를 자동화하기 위한 재사용 가능한 AI 에이전트 스킬 모음입니다. Claude Code, Gemini CLI 등 스킬 기반 확장을 지원하는 AI 어시스턴트와 함께 사용할 수 있습니다.

주요 특징:

Obsidian 최적화: 위키 링크, 프론트매터, Mermaid 다이어그램 등 Obsidian 전용 기능 지원
콘텐츠 생성: 마크다운 슬라이드, 비디오, 이미지 자동 생성
PKM 자동화: 온보딩부터 일상 운영까지 전체 PKM 워크플로우 자동화

스킬 카탈로그

PKM 관리

스킬	설명
ai4pkm-helper	PKM 온보딩 가이드, 빠른 도움말을 담당하는 헬퍼 에이전트. Gobi Desktop 및 CLI 워크플로우 통합

Obsidian 스킬

스킬	설명
obsidian-links	위키 링크 포맷/검증/수정. 파일명, 섹션, 폴더 규칙 준수 확인
obsidian-yaml-frontmatter	YAML 프론트매터 속성 표준화. 일관된 포맷 및 네이밍 적용
obsidian-markdown-structure	마크다운 문서 구조 검증. 헤딩 계층, 콘텐츠 조직화 규칙 적용
obsidian-mermaid	Obsidian 호환 Mermaid 다이어그램 생성. 일반적인 오류 방지

Markdown & Writing

스킬	설명
markdown-slides	마크다운에서 Deckset/Marp 호환 프레젠테이션 슬라이드 생성
interactive-writing-assistant	AI 글쓰기 보조. 아웃라인-본문 공동 진화, PKM 연동 지원

Video & Media

스킬	설명
markdown-video	마크다운 슬라이드를 TTS 나레이션이 포함된 MP4 비디오로 변환
video-cleaning	AI 기반 트랜스크립션을 활용하여 비디오에서 무음 구간 제거
image-generation-skill	DALL-E를 활용한 문서/슬라이드용 AI 이미지 생성. 다양한 비주얼 스타일 지원

설치 가이드

Claude Code용 설치

# 1. 리포지토리 클론
git clone https://github.com/jykim/claude-obsidian-skills.git

# 2. 스킬을 Claude Code 디렉토리로 복사
cp -r claude-obsidian-skills/*-* ~/.claude/skills/

Claude Code가 자동으로 스킬을 감지하고 사용합니다.

Git Submodule 연동 (고급)

Vault 관리자가 스킬을 동기화 상태로 유지하려면:

# Submodule 추가
git submodule add https://github.com/jykim/claude-obsidian-skills.git path/to/skills/public-skills

# 업데이트
git submodule update --remote

요구 사항

스킬	요구 사항
markdown-video	FFmpeg, OpenAI API key, Python 3.7+, Pillow
video-cleaning	FFmpeg, OpenAI API key, Python 3.7+
image-generation-skill	OpenAI API key, Python 3.7+
markdown-slides	없음 (마크다운만)
obsidian-*	없음 (파일 작업만)
interactive-writing-assistant	없음

# FFmpeg 설치 (macOS)
brew install ffmpeg

# Python 의존성
pip install Pillow openai

# OpenAI API 키 설정
export OPENAI_API_KEY="sk-..."

스킬 구조

각 스킬은 다음 구조를 따릅니다:

skill-name/
├── SKILL.md              # 메인 스킬 정의
├── reference/            # 참조 자료 (선택)
└── examples/             # 사용 예시 (선택)

SKILL.md 파일에는 다음이 포함됩니다:

메타데이터: 이름, 설명, 허용 도구, 라이선스
사용 가이드라인: 언제, 어떻게 사용할지
단계별 워크플로우: 작업 수행 절차
품질 체크리스트: 결과물 검증 항목

ai4pkm-helper 상세

역할

ai4pkm-helper는 사용자를 적절한 리소스로 안내하는 헬퍼 에이전트입니다:

요청	안내 대상
"AI4PKM 시작"	온보딩 프로세스 시작
"Gobi Desktop"	(2) Gobi Desktop 가이드
"Orchestrator 설정"	(4) Orchestrator 설정
"CLI 명령어"	(5) CLI 명령어 가이드

온보딩 프로세스

완전 초보자를 첫 저널 작성까지 안내하는 5단계 프로세스:

단계	내용	결과물
1. Assessment	사용자 레벨 평가 (3가지 질문)	레벨 판정
2. Setup Vault	6개 필수 폴더 + AGENTS_beginner.md 생성	Vault 구조
3. Plugin Guide	3개 필수 플러그인 설치 안내	플러그인 설정
4. First Journal	오늘의 저널 인터랙티브 작성	첫 저널
5. AI Connection	Claude Code 연동 확인	온보딩 완료

커스텀 스킬 생성

새로운 스킬을 만들려면:

스킬 이름으로 폴더 생성
SKILL.md 파일 작성:
- 프론트매터 (name, description, allowed-tools, license)
- 명확한 사용 가이드라인
- 워크플로우 정의
- 품질 체크리스트
Claude Code 또는 선호하는 어시스턴트로 테스트
Pull Request 제출

빠른 시작 예시

# 위키 링크 검증
"obsidian-links 스킬로 깨진 위키 링크 확인하고 수정해줘"

# 프론트매터 표준화
"obsidian-yaml-frontmatter로 모든 노트의 속성 일관성 있게 맞춰줘"

# 다이어그램 생성
"obsidian-mermaid로 이 프로세스를 플로우차트로 만들어줘"

# 프레젠테이션 생성
"markdown-slides로 이 문서를 Deckset 슬라이드로 변환해줘"

# 비디오 생성
"markdown-video로 이 슬라이드를 나레이션 비디오로 만들어줘"

참조

GitHub: claude-obsidian-skills
(0) Orchestrator 개요 - 아키텍처 개요
(4) Orchestrator 설정 - 설정 파일 상세
용어 사전 - 용어 정의

학습 경로

이전	현재	다음
(2) Gobi Desktop 가이드	Agent Skill 가이드	(4) Orchestrator 설정

관련 문서:

(0) 실전 가이드 개요 - 도구 선택 가이드
(4) Orchestrator 설정 - Orchestrator 설정