개요
Agent Skills 사양을 준수하는 스킬 세트를 제공하여 Claude Code, Codex, OpenCode 등 호환 에이전트가 Obsidian Markdown, Bases, JSON Canvas 파일을 생성 및 편집하고 Obsidian CLI와 상호작용할 수 있도록 합니다. 웹페이지에서 깔끔한 Markdown을 추출하기 위한 Defuddle을 포함합니다.
README 미리보기
Agent Skills for use with Obsidian.\n\nThese skills follow the [Agent Skills specification](https://agentskills.io/specification) so they can be used by any skills-compatible agent, including Claude Code, Codex, and Open Code.\n\n## Installation\n\n### Marketplace\n\n```\n/plugin marketplace add kepano/obsidian-skills\n/plugin install obsidian@obsidian-skills\n```\n\n### npx skills\n\n```\nnpx skills add git@github.com:kepano/obsidian-skills.git\n```\n\nInstead of ssh, if you prefer to use https:\n\n```\nnpx skills add https://github.com/kepano/obsidian-skills\n```\n\n### Manually\n\n#### Claude Code\n\nAdd the contents of this repo to a `/.claude` folder in the root of your Obsidian vault (or whichever folder you're using with Claude Code). See more in the [official Claude Skills documentation](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview).\n\n#### Codex\n\nCopy the `skills/` directory into your Codex skills path (typically `~/.codex/skills`). See the [Agent Skills specification](https://agentskills.io/specification) for the standard skill format.\n\n#### OpenCode\n\nClone the entire repo into the OpenCode skills directory (`~/.opencode/skills/`):\n\n```sh\ngit clone https://github.com/kepano/obsidian-skills.git ~/.opencode/skills/obsidian-skills\n```\n\nDo not copy only the inner `skills/` folder — clone the full repo so the directory structure is `~/.opencode/skills/obsidian-skills/skills//SKILL.md`.\n\nOpenCode auto-discovers all `SKILL.md` files under `~/.opencode/skills/`. No changes to `opencode.json` or any config file are needed. Skills become available after restarting OpenCode.\n\n## Skills\n\n| Skill | Description |\n|-------|-------------|\n| [obsidian-markdown](skills/obsidian-markdown) | Create and edit [Obsidian Flavored Markdown](https://help.obsidian.md/obsidian-flavored-markdown) (`.md`) with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax |\n| [obsidian-bases](skills/obsidian-bases) | Crea
FAQ (3)
문제 해결Obsidian Bases 오류 '"filters"에는 "and", "or" 또는 "not" 키 중 하나만 사용할 수 있습니다'를 수정하려면 어떻게 해야 하나요?
filters 아래에는 최상위 연산자를 하나만 사용하세요. 포함 로직과 제외 로직을 결합하려면 and, or, not을 같은 수준으로 나열하지 말고 다른 연산자를 중첩하세요.
잘못된 YAML:
filters:
and: []
or: []
not: []올바른 YAML:
filters:
and:
- '포함 조건'
- not:
- '제외 조건'예를 들어, 필수 태그 조건과 템플릿 제외 조건을 하나의 최상위 and 아래에 배치하세요. obsidian-bases/SKILL.md에 있던 잘못된 스키마 예시는 PR #68에서 수정되었습니다.
문제 해결왜 `obsidian help`를 `head`로 파이프할 때 멈추거나 두 번째 Obsidian Electron 인스턴스를 생성합니까?
obsidian help는 정적 도움말만 출력하는 대신 Electron 프로세스를 부트스트랩합니다. | head처럼 출력이 파이프로 연결되어 일찍 닫히면, Electron 헬퍼 프로세스가 정상적인 종료 신호를 받지 못해 부모 셸이 차단된 상태로 남을 수 있습니다. 명령을 파이프로 연결하지 마세요. 터미널에서 obsidian help를 직접 실행하거나, obsidian help > obsidian-help.txt처럼 파일로 리디렉션하세요. 실행 시간을 제한해야 한다면 timeout 5 obsidian help > obsidian-help.txt를 사용하세요. 영구적인 해결 방법으로는 obsidian help를 실행하는 대신 정적 도움말 텍스트를 로컬 치트 시트로 보관해 두세요. 이는 Obsidian Skill 문제가 아닌 CLI 동작 문제이며, Obsidian의 CLI 문제 해결 문서를 참조하세요.
문제 해결AI 에이전트 스킬이 Obsidian CLI를 사용할 때 'obsidian: command not found' 오류를 어떻게 해결하나요?
별도의 obsidian-cli 패키지를 설치하는 대신 Obsidian에 내장된 CLI를 활성화하세요:
1. Obsidian 데스크톱 앱을 엽니다.
2. **Settings → General → Command line interface**로 이동합니다.
3. **Enable CLI**를 켭니다.
4. 터미널을 다시 시작합니다(또는 셸 환경을 다시 로드합니다).
5. which obsidian 또는 obsidian --version으로 확인합니다.
활성화하면 Obsidian이 스킬에서 필요로 하는 obsidian 명령을 생성합니다. 설정 중에 터미널이 열려 있었다면 새 명령이 인식되도록 터미널을 다시 시작하세요.