Community생산성 & 협업github.com

Brain Linking

모든 새 노트나 수정된 노트를 Obsidian 또는 마크다운 지식 저장소 그래프에 연결하여 고립된 노트가 없도록 합니다. 저장소 노트, 회의 요약, 받은 편지함 항목 또는 관련 페이지를 작성하거나 편집할 때 사용하세요.

Brain Linking란 무엇인가요?

이 스킬은 Obsidian 저장소나 `[[wikilinks]]`를 사용하는 마크다운 기반 지식 베이스에서 작업하는 AI 에이전트를 위한 것입니다. 핵심 목표는 모든 노트가 최소 두 개의 기존 페이지에 연결되고, 적어도 하나의 기존 페이지가 해당 노트를 다시 가리키도록 하여 고립된 노트(orphan)가 발생하지 않도록 하는 것입니다. 이 스킬은 새 노트를 작성하기 전에 저장소 스키마(예: CLAUDE.md)를 읽고, `rg` 명령어로 기존 콘텐츠를 검색한 후, 중복을 피하고 상위 허브(hub)로의 상향 링크와 관련 페이지로의 측면 링크를 포함시키도록 지시합니다. 또한 프론트매터(frontmatter) 스키마를 준수하고, 회의 노트, 원시 소스 파일 처리, 공유 받은 편지함 봇 작성에 대한 규칙을 제공합니다. 개인 식별 정보나 민감한 데이터를 저장소에 추가하지 않도록 주의하며, 최종 확인 목록을 통해 모든 새 노트가 그래프에 올바르게 연결되도록 보장합니다. Claude Code, Cursor, Codex 등 `[[wikilinks]]`를 지원하는 모든 Obsidian 또는 마크다운 환경에서 사용할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/themsquared/agent-skills/tree/HEAD/skills/brain-linking

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

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

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

문서

Brain Linking은(는) 무엇을 하나요?

저장소는 그래프입니다. 링크가 없는 노트는 길을 잃습니다. 작성하는 모든 노트는 최소 두 개의 기존 페이지에 연결되어야 하며, 적어도 하나의 기존 페이지가 다시 그 노트를 가리켜야 합니다.

이 스킬은 [[wikilinks]]를 사용하는 모든 Obsidian 저장소 또는 마크다운 지식 베이스를 위한 것입니다. 특정 개인의 파일에 국한되지 않습니다.

작성 전에

  1. 루트에 있는 저장소 스키마를 읽으세요. 일반적인 파일명: CLAUDE.md, AGENTS.md, README.md. 해당 파일이 있으면 따르세요.
  2. 이미 존재하는 항목을 검색하세요: rg -il '<주제 또는 이름>' --glob '*.md'.
  3. 해당 주제의 페이지가 이미 존재하면 그 페이지에 추가하거나(또는 해당 페이지를 가리키는 받은 편지함 노트를 남기세요). 유사한 중복 페이지를 만들지 마세요.

모든 노트는 다음을 포함해야 합니다

  • 상향 링크: 상위 허브로 가는 하나의 [[link]]. 예: 사람 또는 프로젝트 [[index]] 또는 [[status]], [[concepts/...]] 페이지, 프로젝트 허브, 또는 영역 허브.

  • 측면 링크: 이미 존재하는 관련된 사람, 프로젝트, 제품, 개념 또는 회의로 가는 최소 하나의 [[link]].

  • 사람과 사물은 일반 텍스트가 아닌 링크로: 사람, 제품 또는 프로젝트에 페이지가 있으면 [[Name]]으로 작성하세요. 페이지가 있어야 하지만 아직 없으면 그래도 링크하세요. Obsidian이 끊어진 링크를 표시하고, 관리자가 페이지를 생성합니다.

  • 프론트매터: about, area, source, suggested_home, date, agent. 저장소에서 이미 사용하는 area 값(보통 work vs life 또는 저장소 자체의 영역 목록)을 사용하세요.

  • 하단의 관련 섹션:

    ## Related
    - [[parent-hub]]
    - [[sibling-or-person]]
    

링크 대상

  • 정확한 기존 파일 이름(kebab-case)을 사용하세요. 링크 전에 rg --files | rg <slug>로 확인하세요.
  • 약한 링크 여러 개보다 강한 링크 몇 개를 선호하세요. 독자가 실제로 다음에 클릭할 만한 링크를 거세요.
  • 날짜 페이지만, 데일리 노트 또는 태그에만 링크하지 마세요. 이것들은 주제를 연결하지 않습니다.

회의 및 녹음 노트

회의 또는 녹음 노트는 다음에 연결됩니다:

  • 해당 회의/녹음이 다루는 사람, 팀 또는 프로젝트
  • 페이지가 있는 각 참석자
  • 회의에서 생성된 모든 개념 또는 결정

링크가 하나도 없는 회의록이 가장 흔한 고립 노트입니다.

원시 소스

_raw/(또는 저장소의 해당 캡처 폴더)에 있는 파일은 절대 편집하지 않습니다. 그 안에 링크를 추가하지 마세요. 대신, 해당 파일을 인용하는 요약 또는 회의 페이지가 원시 파일에 링크를 걸어 그래프에 포함시킵니다.

공유 받은 편지함에 쓰기 (봇)

  • 저장소가 _agents/inbox/(또는 다른 받은 편지함 경로)에만 쓰라고 지시하면 그렇게 하세요.
  • 위의 링크 규칙은 받은 편지함 노트에도 적용되며, suggested_home은 반드시 실제 페이지를 지정해야 합니다.

저장소에 절대 넣지 말아야 할 것

  • 자격 증명, 토큰 또는 비밀
  • 공유 그래프에 속하지 않는 개인 연락처 정보
  • 의료 기록 또는 기타 민감한 개인 데이터
  • 저장할 권한이 없는 제3자의 기밀 자료

완료 전 빠른 확인

  • 최소 하나의 상향 링크와 하나의 측면 링크, 모두 실제 파일(또는 의도적인 새 페이지)에 연결됨
  • 사람, 제품, 프로젝트의 이름이 링크로 연결됨
  • 관련 섹션이 존재함
  • 기존 페이지의 중복이 없음

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬