Zanat: Git 기반의 AI 에이전트 스킬 버전 관리 및 공유를 위한 오픈소스 CLI와 MCP 서버

실용적 조언

AI 에이전트 스킬을 팀 단위로 공유하려면 Git 저장소를 생성하고 Zanat CLI로 관리할 수 있다.
MCP 서버를 활성화하여 에이전트가 직접 필요한 스킬을 설치하도록 설정하면 작업 효율을 높일 수 있다.

섹션별 상세

AI 코딩 어시스턴트 사용 시 발생하는 스킬 관리의 파편화 문제를 해결하기 위해 Git 기반의 중앙 집중식 허브 시스템을 도입했다. 로컬 폴더에 흩어져 있는 마크다운 파일들을 Git 저장소로 통합하여 팀 단위의 공유와 데이터 소유권을 보장하는 구조이다. 사용자는 자신의 Git 저장소를 '허브'로 설정하여 스킬을 관리하며, 이는 기존의 수동 복사 방식보다 훨씬 안전하고 체계적인 동기화를 가능하게 한다.

bash

zanat init
zanat search react
zanat add company-a.team.react.best-practices
zanat update

Zanat CLI의 주요 명령어 사용 예시

Zanat은 마크다운과 YAML 프론트매터를 결합하여 도구에 종속되지 않는 범용 스킬 포맷을 제공한다. CLI를 통해 설치된 스킬은 특정 로컬 디렉토리에 저장되어 Claude Code나 Cursor 등 다양한 AI 도구에서 즉시 인식되고 활용될 수 있다. 이러한 도구 불가지론적 접근 방식은 사용자가 도구를 변경하더라도 기존에 구축한 스킬 셋을 그대로 유지할 수 있게 돕는다.

Model Context Protocol(MCP) 서버 기능을 내장하여 AI 에이전트가 스스로 필요한 스킬을 검색하고 설치하는 자율적 워크플로우를 구현했다. 에이전트는 MCP를 통해 Zanat 허브에 접근하여 작업 문맥에 맞는 스킬을 찾아 자신의 기능을 실시간으로 확장할 수 있다. 이는 사람이 일일이 스킬을 주입하지 않아도 에이전트가 스스로 능력을 최적화하는 새로운 에이전트 아키텍처 패턴을 형성한다.

별도의 데이터베이스 대신 Git을 백엔드로 활용하여 버전 히스토리, 브랜칭, PR 등 검증된 관리 기능을 그대로 사용한다. 특정 커밋에 스킬 버전을 고정하여 프로덕션 환경의 안정성을 확보하거나, 개발 환경에서 최신 변경 사항을 추적하는 등의 정교한 제어가 가능하다. Git의 분산 관리 특성 덕분에 사용자는 인프라에 구애받지 않고 자신의 데이터를 완전히 통제할 수 있는 이점을 누린다.

용어 해설

모델 컨텍스트 프로토콜(MCP): — AI 모델이 외부 도구나 데이터에 접근하는 방식을 표준화한 프로토콜이다. 에이전트가 외부 환경과 상호작용하는 일관된 방식을 제공하여 확장성을 극대화한다.
YAML 프론트매터(YAML Frontmatter): — 마크다운 파일 상단에 메타데이터를 작성하는 형식이다. 스킬의 이름, 버전, 설명 등을 구조화하여 저장함으로써 프로그램이 스킬 정보를 쉽게 파악하도록 돕는다.
버전 관리(Version Control): — 소프트웨어 변경 이력을 관리하는 체계이다. Git을 통해 스킬의 변경 사항을 추적하고 팀원 간의 협업 및 안정적인 배포를 가능하게 한다.
명령줄 인터페이스(CLI): — 텍스트 명령어로 소프트웨어를 조작하는 인터페이스이다. 자동화 스크립트 작성이 용이하며 개발자 중심의 효율적인 작업 환경을 제공한다.

언급된 도구

Zanat추천

AI 에이전트 스킬 버전 관리 및 배포

Claude Code중립

AI 코딩 어시스턴트

Cursor중립

AI 기반 IDE

언급된 리소스

GitHubZanat GitHub Repository

문서Zanat NPM Package