obsidian-skills
무엇인가
이 스킬 묶음은 Obsidian 보관소를 작업 대상으로 삼는 에이전트에게 보관소 접근 절차와 파일 형식 지식을 주입한다. 규율하는 문제 영역은 노트·Bases·JSON Canvas 같은 개방형 포맷의 읽기·쓰기와 Obsidian CLI 사용법이다.
어떻게 동작하나
각 스킬은 Agent Skills 사양을 따르는 SKILL.md 파일로 존재하며 저장소의 skills/ 디렉터리에 묶여 있다. 에이전트는 skills 경로를 자동 탐색해 SKILL.md를 로드하고, OpenCode 기준으로는 opencode.json 같은 설정 파일을 고치지 않아도 재시작 후 스킬이 활성화된다. 규칙 내용은 Obsidian CLI 명령 사용과 Markdown·Bases·JSON Canvas 포맷 처리 절차다.
무엇과 다른가
CLAUDE.md·AGENTS.md 한 파일에 규칙을 몰아넣는 방식과 달리, 여러 스킬을 디렉터리 단위로 나눠 두고 에이전트가 필요한 SKILL.md를 골라 로드하게 한다. 프롬프트에 매번 Obsidian 사용법을 붙여 넣는 방식과도 다르다. 규칙이 저장소 안에 파일로 남고, Agent Skills 사양을 지원하는 에이전트라면 같은 파일을 그대로 재사용한다.
어떻게 쓰나
설치는 마켓플레이스에서 /plugin marketplace add kepano/obsidian-skills 후 /plugin install obsidian@obsidian-skills를 실행한다. npx skills add [email protected]:kepano/obsidian-skills.git 또는 https URL 형태도 지원한다. 수동 설치는 Claude Code의 경우 보관소 루트의 /.claude 폴더에 저장소 내용을 넣고, Codex는 skills/ 디렉터리를 ~/.codex/skills로 복사하며, OpenCode는 전체 저장소를 ~/.opencode/skills/obsidian-skills로 클론한다. 내부 skills/ 폴더만 복사하면 안 된다.
전제와 한계
Agent Skills 사양을 지원하는 에이전트에서만 동작하며 README가 명시한 대상은 Claude Code, Codex, OpenCode다. Obsidian 보관소 경로가 전제로 필요하고, OpenCode는 재시작 후에 스킬이 노출된다. README의 Skills 절에는 개별 스킬 목록이 채워져 있지 않으므로 어떤 스킬이 포함되는지는 저장소의 skills/ 디렉터리를 직접 확인해야 한다.
관련 논문 1
유사 스킬
- pm-claude-skillsPRD 작성·계약서 해독·사후 분석 등 업무별 절차를 SKILL.md로 주입해 프레임워크·출력 템플릿·품질 검사·안티패턴에 따라 산출물을 내도록 강제하는 Claude Code 플러그인이다.
- skalesSkales 데스크톱 에이전트에 목표 실행·코드워크·워크플로·브라우저 자동화 절차를 SKILL.md로 주입해 다단계 작업을 스스로 수행하게 규율하는 스킬 묶음.
- Agent-Loop-Skills에이전트가 변경 제안·실행·채점·되돌리기를 반복하는 검증 게이트 루프 절차를 SKILL.md로 주입하고, 자율연구·데이터분석·SQL 최적화에 바인딩한다.
- huashu-md-html임의 파일을 markdown으로, markdown을 4종 테마 HTML·출판용 docx로 상호 변환하는 절차와 테마 규칙을 SKILL.md에 담아 주입하는 Claude Code 스킬이다.