Communitygithub.com

위키 스킬 (Obsidian LLM Wiki)

Karpathy LLM Wiki for Obsidian: LLM이 유지하는 지식 베이스 + Cursor 에이전트 스킬 (wiki, video2wiki)

위키 스킬 (Obsidian LLM Wiki)란 무엇인가요?

이 스킬은 AI 에이전트(예: Claude Code, Cursor)를 사용자가 정의한 개인 지식 베이스의 규율 있는 관리자로 전환합니다. `<VAULT_ROOT>`(저장소 루트)에 위치한 노트 모음을 체계적으로 유지, 보강 및 쿼리할 수 있도록 합니다. 이 스킬은 사용자가 질문을 하거나, 새 파일을 추가하거나, 위키 상태를 검사하거나, 비교 또는 차트와 같은 아티팩트를 생성할 때 이를 감지하는 의도 기반 디스패치 시스템을 중심으로 설계되었습니다. 워크플로우는 `AGENTS.md` 파일에 의해 완전히 정의되며, 이 파일이 권위 있는 출처 역할을 합니다. 주요 기능은 `wiki search`, `wiki log`, `wiki lint`와 같은 최소한의 CLI 명령과 `wiki/index.md` 및 마크다운 파일의 직접 읽기/쓰기를 통한 직접적인 상호작용을 결합합니다. 이 스킬은 Obsidian과 원활하게 통합되도록 설계되어 위키링크(`[[이중 대괄호]]`)와 YAML 머리말을 활용하며, 모든 수집 및 아티팩트 생성 작업 후 로그 항목과 인덱스 업데이트를 의무화합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add liyading1818/obsidian-llm-wiki

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

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

문서

위키 스킬

이 스킬은 에이전트를 <VAULT_ROOT>(저장소 루트)에 있는 사용자 개인 지식 베이스의 규율 있는 관리자로 전환합니다.

0단계 — 먼저 AGENTS.md를 항상 읽으십시오

무엇을 하기 전에, 저장소 루트의 AGENTS.md를 읽으십시오. 여기에는 디렉터리 레이아웃, 페이지 규칙, 머리말 스키마, 로그 형식 및 상세 워크플로우가 정의되어 있습니다. 이 SKILL.md는 단지 디스패처일 뿐이며, AGENTS.md가 진리의 원천입니다.

디스패치: 사용자가 무엇을 요청하고 있나요?

사용자 메시지에서 다음 의도 중 정확히 하나를 선택하십시오:

사용자 의도워크플로우
질문을 하거나, 분석/종합을 원함쿼리 (아래)
새 파일을 드롭했거나 "이것을 수집"이라고 말함수집 (AGENTS.md §4.1 참조)
"lint" / "상태 점검" / "문제 찾기"를 말함린트 (아래)
비교/슬라이드 덱/차트/보고서를 원함아티팩트 생성 (아래)
단지 탐색 중이거나 확실하지 않음wiki stats를 실행한 후 원하는 것을 물어보십시오

명확하지 않으면 진행하기 전에 짧은 확인 질문을 하나 하십시오.

쿼리 워크플로우

  1. 저장소 루트에서 wiki search <키워드>를 실행하여 후보 페이지를 찾으십시오. 필요한 경우 여러 키워드 변형을 사용하십시오.

  2. wiki/index.md를 읽어 카탈로그를 확인하십시오.

  3. 1단계에서 찾은 후보 페이지를 읽으십시오.

  4. 여전히 컨텍스트가 부족하면 raw/ 또는 clippings/의 관련 파일을 읽으십시오.

  5. [[위키링크]] 인용(위키 페이지 대상)과 [文章](../raw/xxx.md) 인용(원본 소스 대상)을 사용하여 답변을 종합하십시오.

  6. 답변에 지속적인 가치가 있는 경우 (비교, 파생된 통찰력, 중요하지 않은 종합), 이를 output/<YYYY-MM-DD>-<짧은-슬러그>.md에 머리말과 함께 마크다운 파일로 작성하십시오:

    ---
    type: artifact
    kind: answer | comparison | analysis | report | slides
    created: <날짜>
    question: "<사용자의 질문, 그대로>"
    sources_used: [wiki/concepts/X.md, wiki/sources/Y.md, ...]
    ---
    

    그런 다음 사용자에게 물어보십시오: "要不要把这份输出归档为 wiki/questions/<slug>.md?" (예인 경우, 복사하고 index.md와 log.md를 업데이트하십시오.)

  7. 답변이 사소한 경우(사실 조회), 채팅으로만 답변하십시오 — 파일이 필요 없습니다.

린트 워크플로우

  1. wiki lint를 실행하십시오 — 이 명령은 자동으로 lint/<today>.md를 작성합니다.
  2. 해당 파일을 읽고 요약하여 사용자에게 알리십시오 (어떤 문제가 실제 문제이고 어떤 것이 문서 내 리터럴 [[예시]]와 같은 오탐인지).
  3. 우선 순위가 지정된 수정 계획을 제안하십시오. 자동 수정하지 마십시오 — 사용자가 선택하도록 하십시오.

아티팩트 생성 워크플로우

쿼리와 동일하지만, 결과물 형태가 명시적입니다 (표 / Marp 슬라이드 / Python 차트 / 캔버스). 항상 output/에 저장하십시오. 슬라이드 덱의 경우 Marp 마크다운 형식을 사용하십시오. 차트의 경우 Python 스크립트를 output/scripts/에 작성하고 실행하여 이미지를 함께 생성하십시오.

출력 디렉터리 규칙

output/
├── 2026-06-26-rag-vs-llm-wiki.md          # 답변 / 비교 아티팩트
├── 2026-06-26-karpathy-summary.slides.md  # Marp 슬라이드 덱
├── scripts/                                # 차트 생성을 위한 도우미 스크립트
└── assets/                                 # 렌더링된 이미지, 내보내기 파일

output/ 디렉터리는 LLM 소유, 추가 전용입니다 (묻지 않고 이전 아티팩트를 삭제하지 마십시오). 각 파일은 위에 표시된 머리말을 가지고 있어야 사용자가 나중에 아티팩트를 위키로 승격할 수 있습니다.

사용 가능한 CLI 명령 (<VAULT_ROOT>에서 실행)

의도적으로 최소화된 네 가지 명령만 있습니다:

wiki stats              # 개요: 유형/상태별 페이지 수
wiki log -n 10          # wiki/log.md의 마지막 N개 항목
wiki search <regex>     # 전체 텍스트 검색 (--scope wiki|raw|clippings|all)
wiki lint               # lint/<today>.md에 고아/깨짐/스텁 기록

그 외 모든 것(페이지 생성, 머리말 편집, index.md 업데이트, log.md에 추가)은 마크다운 파일을 직접 읽고 쓰는 방식으로 수행됩니다. 파일 편집을 위해 CLI를 요청하지 마십시오 — 그것은 당신의 작업입니다.

중요 규칙 (AGENTS.md 출처)

  • raw/ 또는 clippings/의 파일을 절대 수정하지 마십시오.
  • 모든 수집은 wiki/index.md를 업데이트하고 wiki/log.md에 ## [YYYY-MM-DD] ingest | <제목> 형식의 항목을 머리말에 추가해야 합니다.
  • 위키 페이지 간에 [[이중 대괄호]]로 상호 참조하십시오.
  • 페이지에는 YAML 머리말(type, tags, created, updated, sources, status)이 필요합니다.
  • 확실하지 않으면 사용자에게 물어보십시오. 조용히 대규모 리팩터를 수행하지 마십시오.

보고 스타일

워크플로우를 완료한 후 사용자에게 짧은 요약을 제공하십시오:

  • 수행한 작업 (1~3개 불릿)
  • 생성되거나 수정된 아티팩트 (상대 경로)
  • 해결되지 않은 질문이나 발견한 새로운 격차

간결하게 유지하십시오. 사용자는 Obsidian에서 병렬로 탐색 중이며 파일 변경 사항을 볼 수 있습니다.

관련 스킬