How to Sync AI Coding Agent Skills Across Every Platform: One Repo, Zero Copy-Paste

Context

AI 코딩 에이전트(Claude Code, Codex, Cursor, Perplexity Computer, Claude Desktop)가 각기 다른 위치와 형식으로 스킬을 저장하면서 개발자들이 20개 이상의 스킬을 5개 플랫폼에 걸쳐 수동으로 동기화해야 하는 유지보수 문제가 발생했다. 클라우드 기반 에이전트(Perplexity Computer, Claude Desktop)는 로컬 파일 접근을 지원하지 않아 웹 대시보드를 통한 업로드만 가능했다. 기존 해결책(수동 복사-붙여넣기, 심링크 한정, 프로젝트별 스킬 저장)은 모두 플랫폼 통합이나 장기 유지보수 측면에서 한계를 보였다.

Technical Solution

• 로컬 에이전트 동기화: setup.sh 스크립트가 Claude Code(~/.claude/skills/), Codex(~/.codex/skills/), Cursor(~/.cursor/skills/) 설치 여부를 자동 감지한 후 각 에이전트 스킬 디렉토리에서 공유 저장소로의 심링크를 생성해 단일 수정이 모든 로컬 에이전트에 즉시 반영되도록 구성
• 클라우드 에이전트 동기화: Playwright를 통해 Brave 브라우저 인스턴스를 자동 조작해 Perplexity Computer와 Claude Desktop 웹 대시보드에 스킬을 업로드(zip 파일 생성 → 브라우저 자동화 → 파일 선택자 인터셉트 → 모달 완료 확인)
• 봇 탐지 회피: Headless Chromium 대신 실제 Brave 바이너리를 headed 모드로 실행하고 --disable-blink-features=AutomationControlled 플래그를 사용해 Cloudflare의 navigator.webdriver 플래그 탐지와 브라우저 핑거프린팅을 우회
• 선택적 동기화: git diff를 이용해 마지막 커밋 이후 변경된 스킬만 감지하는 --changed-only 플래그 제공으로 CI/CD 환경에서 불필요한 재업로드 방지
• 세션 쿠키 인증: .env 파일에 저장된 세션 쿠키를 주입해 자격증명을 저장하지 않으면서도 웹 대시보드 인증 수행

Key Takeaway

다중 플랫폼 에이전트 생태계에서 심링크(로컬)와 브라우저 자동화(클라우드)라는 이질적 기술을 계층별로 조합하면 단일 git 저장소를 진실의 원천으로 유지하면서 모든 에이전트를 동기화 상태로 보관할 수 있다. Codex의 자동 스킬 개선 기능과 git 워크플로우를 결합하면 AI 기반 스킬 정제가 자동으로 모든 에이전트로 전파되는 지속적 개선 루프를 구축할 수 있다.