obsidian-bases
작성자 kepanoobsidian-bases는 필터, 수식, 요약, 그리고 table·cards·list·map 뷰를 갖춘 Obsidian `.base` 파일을 만들고 편집하는 데 도움을 줍니다. 노트 메타데이터를 실제로 활용 가능한 지식 베이스 뷰로 구성할 때 특히 적합하며, 스킬 파일에서 YAML 검증과 함수 레퍼런스 가이드를 함께 제공합니다.
이 스킬은 82/100점을 받아 디렉터리에 올리기 충분한 완성도를 갖췄습니다. 저장소 근거를 보면 필터, 수식, 다양한 뷰 타입을 포함한 Obsidian `.base` 파일을 만들고 편집하는 실제 재사용 가능한 워크플로가 확인되며, 일반적인 프롬프트보다 추측을 줄일 수 있도록 에이전트에 필요한 스키마와 검증 가이드도 제공합니다. 다만 이 스킬은 도구 실행형이 아니라 문서 중심이므로, 디렉터리 사용자는 결과물을 Obsidian 안에서 직접 테스트해야 한다는 점을 감안해야 합니다.
- 트리거 적합성이 높습니다. 설명에서 `.base` 파일, Bases, table/card 뷰, filters, formulas와의 관련성이 Obsidian 맥락에서 명확하게 드러납니다.
- 실무적 내용이 충실합니다. SKILL.md에 구체적인 작업 흐름, YAML 스키마 구조, 검증 체크, 자주 발생하는 오류 패턴이 포함되어 있습니다.
- 에이전트 활용성이 좋습니다. 포함된 functions 레퍼런스가 수식 작성 시 문법을 지어내지 않도록 실질적으로 도와줍니다.
- 설치 명령이나 실행 가능한 helper 파일은 없습니다. 실제 도입은 markdown 가이드를 읽고 수동으로 적용하는 방식에 의존합니다.
- 최종 검증은 결국 Obsidian에서 `.base` 파일을 직접 열어봐야 하므로, 렌더링이나 문법 문제에서는 어느 정도 시행착오가 남습니다.
obsidian-bases 스킬 개요
obsidian-bases가 특히 잘하는 일
obsidian-bases는 데이터베이스처럼 노트를 보여주는 Obsidian .base 파일을 에이전트가 만들고 수정하도록 돕는 스킬입니다. 특히 filters, formulas, summaries, 그리고 table, cards, list, map 같은 view 레이아웃에 맞는, 실제로 동작하는 YAML이 필요할 때 가장 유용합니다.
지식 베이스 워크플로에 가장 잘 맞는 경우
이 obsidian-bases 스킬은 vault를 지식 베이스, 프로젝트 추적기, 읽기 목록, 콘텐츠 대시보드처럼 운영하는 사용자에게 특히 잘 맞습니다. 여기서 진짜 해결하려는 일은 단순히 “YAML 작성”이 아니라, “내 노트와 메타데이터를 Obsidian에서 실제로 렌더링되는 유용한 뷰로 바꾸기”입니다.
일반적인 프롬프트 대신 이것을 써야 하는 이유
obsidian-bases의 차별점은 구조에 있습니다. 이 스킬은 에이전트에게 명확한 작업 순서를 제공합니다. 먼저 filters로 범위를 정하고, 필요하면 formulas를 추가한 뒤, view를 구성하고, 마지막으로 YAML과 속성 참조를 검증합니다. 덕분에 일반 프롬프트에서 흔히 생기는 실패를 줄일 수 있습니다. 예를 들어 잘못된 .base 문법, 깨진 formula 참조, vault 스키마와 맞지 않는 view 같은 문제입니다.
obsidian-bases 스킬 사용 방법
설치 맥락과 가장 먼저 읽어야 할 파일
이 스킬 자체에 별도의 설치 명령은 없습니다. 이것은 kepano/obsidian-skills 내부의 가이드형 스킬입니다. 먼저 skills/obsidian-bases/SKILL.md를 읽고, 이어서 skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md를 확인하세요. 읽는 순서는 workflow 섹션 → schema 예시 → 실제로 필요한 formula에 해당하는 function reference 순서가 가장 효율적입니다.
obsidian-bases 스킬에 필요한 입력
obsidian-bases를 잘 활용하려면 에이전트에게 다음 정보를 주는 것이 좋습니다:
- base의 목표, 예: “진행 중인 프로젝트만 보여주기”
- 샘플 노트 경로 또는 폴더
- 관련 frontmatter 속성, 태그, 날짜 필드
- 원하는 view 유형:
table,cards,list, 또는map - overdue 상태나 reading time처럼 계산된 필드가 필요한지 여부
- 속성 순서나 summary 필드 같은 표시 방식 기대치
약한 입력: “작업용 base 하나 만들어줘.”
좋은 입력: “Projects/ 안의 노트를 위한 .base file을 만들어줘. status != done인 노트만 포함하고, title, status, due, 그리고 formula is_overdue를 보여줘. 기본 view는 table로 하고, 모바일용 cards view도 추가해줘.”
대략적인 목표를 실제로 동작하는 프롬프트로 바꾸기
실전에서 잘 먹히는 obsidian-bases 프롬프트는 완성된 .base file과 함께 검증 항목까지 요청해야 합니다. 예시는 다음과 같습니다.
“Using obsidian-bases, create a valid .base YAML file for notes in Areas/Research/ tagged #paper. Add filters for only unread items from 2024 onward, define formulas for age_days and is_recent, create a table view ordered by title, author, year, and formula.age_days, and explain any quoting needed to avoid YAML errors.”
이 방식이 더 잘 작동하는 이유는 범위, 메타데이터, formula, 표시 순서까지 구체적으로 지정하고, 문법을 고려한 출력을 요구하기 때문입니다.
실무적인 작업 순서와 출력 점검법
다음 순서로 진행하세요:
- 먼저 가장 단순한
.base를 요청합니다. - 복잡도를 올리기 전에 YAML 문법을 검증합니다.
- formula는 한 번에 하나씩 추가합니다.
- 첫 번째 view가 정상 렌더링된 뒤에만 두 번째 view를 추가합니다.
이 스킬이 강조하는 중요한 품질 점검 항목:
- YAML 특수 문자 때문에 파싱이 깨질 수 있으면 문자열을 quote 처리하기
- view에서 사용하는 모든
formula.X가formulas에 정의되어 있는지 확인하기 - 속성명이 실제 노트와 정확히 일치하는지 확인하기
- 텍스트 편집기에서만 보지 말고 반드시 Obsidian에서 테스트하기
obsidian-bases 스킬 FAQ
obsidian-bases는 초보자에게도 괜찮을까?
네. 기본적인 Obsidian 속성과 frontmatter를 이미 이해하고 있다면 충분히 괜찮습니다. obsidian-bases 스킬은 전체 포맷을 처음부터 혼자 익히는 것보다 쉽습니다. 안전한 생성 순서를 제시해주기 때문입니다. 다만 vault 메타데이터가 일관되지 않다면 완전 초보자는 여전히 어려움을 겪을 수 있습니다.
AI에게 그냥 .base file을 요청하는 것과 무엇이 다른가?
일반 프롬프트는 그럴듯해 보이지만 실제로는 렌더링되지 않는 YAML을 내놓을 수 있습니다. obsidian-bases 스킬이 더 나은 이유는 실제 .base 작업 흐름을 중심에 두고 있기 때문입니다. 즉, filters 먼저, formulas 다음, views 세 번째, validation 마지막 순서입니다. 또한 formula가 들어가면 function reference를 어디서 봐야 하는지도 안내해줍니다.
obsidian-bases가 맞지 않는 경우는 언제인가?
실제 문제의 원인이 메타데이터 부족, 일관성 없는 노트 구조, 혹은 base에 무엇을 보여줘야 할지조차 불명확한 상태라면 obsidian-bases를 쓰지 않는 것이 좋습니다. 또한 Bases 포맷 바깥의 플러그인별 문서를 대신해주지는 못합니다. vault 스키마가 어지럽다면 먼저 그 부분부터 정리해야 합니다.
obsidian-bases는 formulas와 functions에도 도움이 되나?
그렇습니다. 특히 설치 여부를 판단하는 관점에서 보면, 포함된 references/FUNCTIONS_REFERENCE.md는 이 스킬의 가장 실용적인 요소 중 하나입니다. 날짜 계산, 조건부 표시, 타입 변환, 링크, 아이콘, 또는 formula 기반 속성 안에서의 HTML 렌더링이 필요할 때 특히 도움이 됩니다.
obsidian-bases 스킬 개선 방법
출력 요청 전에 vault 스키마를 더 깔끔하게 정리하기
가장 큰 개선 포인트는 입력 품질입니다. 전체 base를 요청하기 전에 3~5개의 노트에서 정확한 속성명과 예시 값을 먼저 정리해 주세요. 어떤 노트는 due-date를 쓰고 다른 노트는 due를 쓰는 식이라면, 에이전트는 filters나 formulas를 안정적으로 설계할 수 없습니다.
obsidian-bases에서 가장 흔한 실패를 막는 방법
자주 발생하는 실패 패턴:
- quote되지 않은 문자열 때문에 생기는 잘못된 YAML
- 정의 전에 사용된 formula 참조
- 존재하지 않는 태그나 속성을 대상으로 한 filters
- 첫 초안부터 여러 view와 summaries를 한꺼번에 넣어 지나치게 복잡해진 구성
더 나은 첫 요청은 좁고 명확한 요청입니다: 폴더 하나, filter 하나, view 하나, formula 하나.
동작하는 최소 출력에서부터 단계적으로 확장하기
obsidian-bases를 더 안정적으로 쓰려면 수정 요청도 층위별로 나누는 것이 좋습니다:
- 첫 번째 단계: filter 하나와 view 하나가 들어간 유효한
.base - 두 번째 단계: 계산 필드 추가
- 세 번째 단계: 대체 view와 summaries 추가
- 마지막 단계: 가정한 내용과 스키마 불일치 가능성에 대한 코멘트 요청
이렇게 하면 어떤 추가 요소가 렌더링을 깨뜨렸는지 정확히 확인할 수 있어 신뢰도가 높아집니다.
reference 파일을 전략적으로 활용하기
obsidian-bases 결과를 개선하려면 막연하게 “고급 formula”를 요청하지 마세요. 대신 원하는 연산을 구체적으로 말하고, 에이전트가 그것을 references/FUNCTIONS_REFERENCE.md에 있는 알려진 function으로 매핑하게 하세요. 이렇게 해야 출력이 문서화된 function 집합에 근거하게 되고, 특히 날짜, boolean, 링크, 표시 포맷팅에서 문법 환각을 줄일 수 있습니다.