여러 도구에서 하나의 AGENTS.md 공유하기

AI 도구는 저마다 자기 파일에서 상시 지침을 읽습니다. Claude Code는 CLAUDE.md를, Gemini CLI는 GEMINI.md를, Codex와 대부분의 다른 도구는 AGENTS.md를 각자의 폴더에서 읽습니다. 웹 대시보드(skillshare ui)는 이 파일들을 보여 주고 편집할 수 있게 하며, 여러 도구가 하나의 공유 AGENTS.md를 쓰도록 설정할 수 있습니다.

이 기능은 대시보드 전용이며 별도의 CLI 명령은 없습니다. 공유 AGENTS.md는 extra로 저장되므로 skillshare sync extras로도 제자리에 유지됩니다.

target이 읽는 파일 확인하기

대상에서 target을 여세요. 페이지에는 그 target이 읽는 파일 이름을 딴 탭이 있습니다. claude는 CLAUDE.md, gemini는 GEMINI.md, codex는 AGENTS.md입니다. 탭에는 다음이 표시됩니다:

• 읽는 순서: 도구가 불러오는 파일을 불러오는 순서대로 번호를 매겨 보여 주며, loaded, skipped, missing으로 표시합니다. claude의 경우 ~/.claude/rules/의 Markdown 파일과, claude가 사용자 레벨 AGENTS.md를 읽지 않는다는 AGENTS.md 행도 포함됩니다.
• 파일 편집기. 저장은 먼저 현재 파일을 백업하며, 파일이 아직 없으면 새로 만듭니다.
• 경고. @로 시작하는 줄은 import이며, 이를 펼치는 도구는 일부뿐입니다. 다른 도구는 일반 텍스트로 읽습니다. Windsurf는 전역 rules 파일의 처음 6,000자만 읽습니다.
• 공유 AGENTS.md(global 모드): 이 target이 사용하는 공유 파일과, 공유 파일을 선택하는 링크.

파일이 공유 AGENTS.md에 대한 링크이면 편집기는 읽기 전용입니다. 여기서 편집하면 그 공유 파일을 쓰는 모든 target이 바뀌므로, 해당 파일의 페이지에서 편집하세요. dotfiles로 연결한 링크처럼 직접 만든 링크는 계속 편집할 수 있으며, 저장하면 링크가 가리키는 파일에 기록됩니다.

skillshare가 알고 있는 지침 파일은 다음과 같습니다:

Target	사용자 레벨 파일	프로젝트 파일	@ import 지원
amp	~/.config/amp/AGENTS.md	AGENTS.md	No
antigravity	~/.gemini/GEMINI.md (gemini와 같은 파일)	AGENTS.md	No
claude	~/.claude/CLAUDE.md, 그리고 ~/.claude/rules/	CLAUDE.md, CLAUDE.md가 없으면 AGENTS.md, 그리고 .claude/rules/	Yes
codex	~/.codex/AGENTS.md	AGENTS.md	No
cursor	없음: 사용자 rules는 Cursor 설정에 있음	AGENTS.md	No
gemini	~/.gemini/GEMINI.md	GEMINI.md	No
goose	~/.config/goose/.goosehints	AGENTS.md	No
kiro	~/.kiro/steering/AGENTS.md	AGENTS.md	No
opencode	~/.config/opencode/AGENTS.md	AGENTS.md	No
roo	~/.roo/rules/AGENTS.md	AGENTS.md	No
windsurf	~/.codeium/windsurf/memories/global_rules.md (처음 6,000자)	AGENTS.md	No

Claude나 Codex의 두 번째 계정은 자기 config 디렉터리 안의 같은 파일을 읽습니다. 예: ~/.claude-work/CLAUDE.md. 그 밖의 target은 어떤 파일을 읽는지 skillshare에 알려 주세요.

CLAUDE.md를 AGENTS.md로 변환하기

target 탭에서 **변환…**을 클릭하면 그 내용을 다른 도구도 읽을 수 있게 만듭니다. 이 버튼은 파일에 옮길 내용이 있고 파일이 이미 AGENTS.md가 아닐 때 나타납니다. 대화상자는 기록하기 전에 모든 변경 사항을 미리 보여 주며, 변경하거나 제거하는 파일은 모두 먼저 백업됩니다.

방법	결과	사용 가능 조건
AGENTS.md로 옮기고 CLAUDE.md에서 가져오기 (권장)	내용이 AGENTS.md로 옮겨집니다. CLAUDE.md에는 @AGENTS.md 한 줄과 claude만 이해하는 줄만 남습니다	@ import를 따르는 도구(claude)
CLAUDE.md 이름을 AGENTS.md로 변경	CLAUDE.md가 제거되고 claude는 대신 AGENTS.md를 읽습니다	프로젝트에서만, 자기 파일이 없을 때 AGENTS.md를 읽는 도구. CLAUDE.local.md가 있거나 CLAUDE.md가 공유 AGENTS.md를 사용 중이면 거부됩니다(다음 sync 때 CLAUDE.md가 다시 생김)
AGENTS.md로 복사	두 파일이 모두 남아 따로 편집되므로 내용이 점점 달라집니다	항상

파일 이름은 target에 따라 바뀝니다. gemini의 경우 대화상자는 AGENTS.md로 복사만 제공합니다. 첫 번째 방법에서는 @import N줄을 CLAUDE.md에 남기기가 기본으로 켜져 있습니다. 다른 도구는 그 줄을 일반 텍스트로 읽기 때문입니다.

사용자 레벨에서는 ~/.claude 안의 AGENTS.md를 읽는 다른 도구가 없습니다. 그래서 global 모드에서는 첫 번째 방법에 다른 대상도 쓸 수 있는 공유 AGENTS.md로 만들기 옵션도 있으며, 기본으로 켜져 있습니다:

• 새로 만들기…: 새 공유 AGENTS.md의 이름을 정합니다. 내용이 그리로 옮겨지고 CLAUDE.md가 그것을 가져옵니다.
• 기존 공유 파일: 내용이 그 파일의 끝에 추가되고, CLAUDE.md가 그것을 가져옵니다.

공유를 끄면 내용은 ~/.claude/AGENTS.md로 가고 CLAUDE.md에 @AGENTS.md 줄이 추가됩니다.

global 모드에서 하나의 AGENTS.md 공유하기

Extras로 가서 AGENTS.md 탭을 여세요. 새 공유 AGENTS.md는 이름(영문자, 숫자, -, _)과 시작 방식을 묻습니다:

• 빈 파일: 대화상자에서 첫 버전을 작성합니다.
• claude 파일 옮겨 오기(또는 파일이 있고 아직 공유 파일을 쓰지 않는 다른 target): target의 현재 파일이 공유 파일로 옮겨지고, 이후 target은 공유 파일을 사용합니다. 원본은 먼저 백업됩니다.

각 공유 파일은 <extras source>/<name>/AGENTS.md에 저장되며, 기본값은 ~/.config/skillshare/extras/<name>/AGENTS.md입니다.

target이 공유 파일을 쓰는 방식은 @ import를 따르는지에 따라 다릅니다:

• Import target(claude, 그리고 @import 지원으로 표시한 도구)은 자기 내용을 유지하며 여러 공유 파일을 동시에 쓸 수 있습니다. skillshare는 파일 맨 위의 관리 블록 안에 공유 파일마다 한 줄씩 추가하며, 블록 밖은 절대 바꾸지 않습니다. Claude에는 사용자 레벨 AGENTS.md가 없으므로, 이 블록이 공유 파일을 읽는 방법입니다:

  ~/.claude/CLAUDE.md

  <!-- skillshare:instructions:begin -->
  @/Users/you/.config/skillshare/extras/personal/AGENTS.md
  <!-- skillshare:instructions:end -->
  
  Your own Claude-only instructions stay here.

• 그 밖의 target(codex, gemini 등)은 공유 파일 하나를 씁니다. 기존 파일은 백업된 뒤 공유 파일에 대한 링크(symlink)로 교체됩니다.

탭 왼쪽에는 공유 파일 목록이 있습니다: 모든 대상, 사용 중인 target 수가 표시된 각 공유 파일, 그리고 자체 파일. 하나를 클릭하면 해당 target만 표시됩니다. 공유 파일 옆의 화살표는 그 파일의 페이지를 엽니다. 공유 파일을 선택하면 헤더에 대상 추가와 AGENTS.md 편집도 나타납니다.

오른쪽의 각 행에는 target, 기록되는 파일, 사용 중 선택 상자가 표시됩니다. import target은 여러 공유 파일을 선택할 수 있고, 다른 target은 하나 또는 자체 파일을 선택합니다. 여러 target을 한 번에 바꾸려면 행을 체크하고 **변경…**을 사용하세요. 자체 파일로 되돌릴 때는 target을 복원하므로 항상 먼저 확인을 요청합니다.

• antigravity는 gemini와 같은 ~/.gemini/GEMINI.md를 읽습니다. 둘 다 target이면 antigravity의 행은 gemini를 따르며 따로 바꿀 수 없습니다.
• cursor는 표시되지 않습니다. 사용자 rules가 파일이 아닌 Cursor 설정에 있기 때문입니다.

공유 파일 하나 관리하기

공유 파일의 페이지에는 그 파일을 사용하는 target이 나열되며, 각 target이 기록하는 파일, mode(import 또는 symlink), 상태가 표시됩니다:

상태	의미
synced (동기화됨)	링크 또는 import 줄이 제자리에 있음
modified (수정됨)	링크가 내용이 다른 일반 파일로 바뀜(아래 참고)
drift (차이 있음)	target 파일은 있지만 공유 파일에 연결되어 있지 않거나, import 줄이 더 이상 없음
not synced (동기화되지 않음)	target 파일이 아직 없음
no source (소스 없음)	공유 파일 자체가 없음

이 페이지에서 할 수 있는 작업:

• 대상 추가: target을 하나 더 연결합니다. 목록에는 아직 이 파일을 쓰지 않는 import target과, 아직 어떤 공유 파일도 쓰지 않는 다른 target이 표시됩니다.
• AGENTS.md 편집: 이 파일을 쓰는 모든 target이 변경 사항을 읽습니다. 이전 버전은 백업됩니다.
• 동기화: 이 파일의 링크와 import 줄을 다시 제자리에 둡니다.
• target 하나를 복원하거나 공유 AGENTS.md 삭제.

복원과 삭제

복원은 확인을 요청한 뒤 target을 공유 파일을 연결하기 전 상태로 되돌립니다. 원래 있던 파일이나 symlink가 돌아오고, 원래 없었다면 파일이 제거됩니다. import target의 경우 skillshare의 import 줄만 제거되며, skillshare가 블록만을 위해 만든 CLAUDE.md는 비게 되면 제거됩니다. 공유 파일 자체는 유지됩니다. target이 여전히 modified이면, 복원은 먼저 편집된 파일을 drift 백업으로 보관합니다.

공유 AGENTS.md 삭제는 config에서 제거하고 그것을 쓰던 모든 target을 복원합니다. 파일은 extras 폴더에 남습니다.

링크된 파일이 편집되었을 때

사용자나 도구가 target 파일을 직접 편집해 링크가 내용이 다른 일반 파일로 바뀌면, 상태가 modified가 됩니다. 공유 파일의 페이지나 AGENTS.md 탭의 행 메뉴에서 어느 쪽을 유지할지 선택하세요:

• 되가져오기: 편집 내용이 공유 파일에 반영되고, 그것을 쓰는 모든 target이 변경 사항을 받습니다. 현재 공유 파일은 먼저 백업됩니다.
• 다시 적용: 편집된 파일은 drift 백업으로 보관되고 링크가 돌아옵니다.

어느 쪽이든, 나중에 복원하면 target은 편집된 버전이 아니라 공유 파일을 쓰기 전 상태로 돌아갑니다.

skillshare sync extras와 동기화도 묻지 않고 modified 파일을 링크로 교체합니다. 편집 내용은 먼저 drift 백업으로 보관되므로, 공유 파일에 반영하려면 sync 전에 되가져오기를 선택하세요.

skillshare가 모르는 도구

custom target처럼 알려진 지침 파일이 없는 target의 탭에는 (도구 이름)이(가) 읽는 파일을 skillshare에 알려 주기가 표시됩니다:

• global 모드에서는 전체 경로나 ~/로 시작하는 경로를 입력합니다.
• 프로젝트에서는 프로젝트 루트 기준 상대 경로를 입력합니다.

도구가 @ 줄을 따른다면 이 도구는 @import를 지원합니다를 체크하세요. 그러면 claude처럼 여러 공유 파일을 동시에 쓸 수 있습니다. 이 설정은 target에 instructions로 저장됩니다. 도구를 추가할 때 대상 추가 → 사용자 지정 대상에서 바로 입력할 수도 있습니다.

나중에 바꾸려면 읽는 순서 아래의 변경 또는 설정 제거를 사용하세요. 설정을 제거해도 파일은 삭제되지 않습니다. target이 공유 파일을 쓰는 동안에는 위치를 변경하거나 제거할 수 없으니, 먼저 자체 파일로 되돌리세요.

프로젝트

프로젝트에서 skillshare ui -p를 실행하세요. 프로젝트에서는 모든 target이 repository와 함께 추적되는 하나의 ./AGENTS.md를 읽으므로, 공유하거나 동기화할 것이 없습니다. Extras 아래의 AGENTS.md 탭은 그 파일을 만들거나 편집하고, 각 target이 그것을 읽을 수 있는지 보여 줍니다:

읽는 방법	의미
직접 읽음	도구의 프로젝트 파일이 AGENTS.md
CLAUDE.md이(가) 없어서 AGENTS.md를 읽음	claude가 AGENTS.md로 대체해서 읽음
CLAUDE.md에서 가져옴	도구의 자체 파일에 @AGENTS.md 줄이 있음
GEMINI.md이(가) 링크함	도구의 자체 파일이 AGENTS.md에 대한 symlink
CLAUDE.md이(가) 있어서 claude은(는) AGENTS.md를 읽지 않습니다	도구의 자체 파일이 AGENTS.md를 가림
기본적으로 GEMINI.md만 읽음	도구가 자체 파일을 읽지만 그 파일이 없음

자체 파일만 읽는 도구에는 클릭 한 번으로 해결하는 방법이 있습니다. @AGENTS.md 추가는 CLAUDE.md 맨 위에 import 줄을 추가하고(먼저 백업), GEMINI.md 추가는 AGENTS.md에 대한 링크로 GEMINI.md를 만듭니다.

프로젝트에는 AGENTS.md가 하나뿐이므로 그룹으로 나눌 수 없습니다. 개인용과 업무용 지침을 분리하려면 global 모드에서 공유 파일을 사용하세요.

target 탭은 프로젝트에서도 동작합니다. 이때 읽는 순서에는 프로젝트 파일이 표시되고, **변환…**은 claude에 대해 CLAUDE.md 이름을 AGENTS.md로 변경도 제공합니다.

백업

skillshare는 파일을 교체하거나 제거하거나 사용자가 작성한 내용을 바꾸기 전에 백업합니다. 자체 import 줄을 추가하거나 제거할 때는 백업하지 않습니다. 각 파일의 최근 10개 버전이 skillshare의 state 디렉터리, 즉 macOS와 Linux에서는 ~/.local/state/skillshare/extras/backups/(XDG_STATE_HOME 변수가 설정되어 있으면 $XDG_STATE_HOME/skillshare/extras/backups/)에 보관됩니다.

복원은 가장 최근 백업이 아니라 공유 파일을 연결할 때 있던 것을 사용합니다. 동기화, 다시 적용, 복원이 교체한 편집 내용은 별도의 drift/ 폴더인 extras/backups/<id>/drift/에 저장되며, <id>는 target 파일 경로에서 만들어집니다. 복원은 이것을 되돌리지 않으므로, 필요하면 직접 복사해 오세요.

공유 파일의 설정과 이를 다루는 CLI 명령은 single-file extras를 참고하세요.