Hermes Agent가 3월 12일 공개됐을 때, 릴리스 안에는 이미 15개 넘는 카테고리에 걸친 70개 이상의 번들 스킬이 들어 있었다. 4주 뒤에는 agentskills.io에 커뮤니티 스킬 마켓이 올라가 있었고, 거기에 수백 개가 더 얹혀 있었다. 이 글은 그 일이 어떻게 벌어졌는지에 대한 이야기다 — 그리고 당신이 평생 스킬을 한 줄도 직접 쓸 계획이 없더라도, Hermes의 스킬 아키텍처가 왜 들여다볼 만한지에 대한 얘기이기도 하다.
스킬이라는 게 대체 뭔가
대부분의 AI 에이전트 프레임워크에서 "툴"은 개발자가 import 시점에 에이전트에 등록하는 파이썬 함수 하나다. 함수에 데코레이터를 붙이고, docstring을 쓰고, 어디선가 tools 배열에 집어넣는다. 에이전트가 그걸 필요로 하면 프레임워크가 설명을 프롬프트에 끼워 넣고 모델의 툴 호출 출력을 파싱한다.
Hermes의 스킬은 그런 물건이 아니다. 이건 선언적인 번들이다 — 매니페스트(skill.yaml), 실행 스크립트나 파이썬 진입점 한 세트, 전제 조건 기술, 그리고 활성화 정책. Hermes는 시작할 때 스킬 디렉터리를 훑고, 각 매니페스트를 읽고, 전제 조건이 이 머신에서 실제로 갖춰져 있는지를 보고 이번 세션에서 어떤 스킬이 사용 가능한지를 결정한다. 환경 변수, PATH에 걸린 바이너리, 설정 파일 항목, 플랫폼 고유 기능 — 그런 것들을 전부 본다.
ffmpeg이 필요한 스킬은 ffmpeg이 깔려 있지 않은 머신에서는 에이전트 눈앞에 내놓지도 않는다. 텔레그램 봇 토큰이 필요한 스킬은 텔레그램에 연결된 세션에서만 활성화된다. 에이전트의 프롬프트에는 늘, 지금 이 순간에 실제로 쓸 수 있는 스킬만 올라 있다.
작아 보이는 설계다. 그런데 바로 이것이, 공개 첫날에 스킬 70개를 끌고 나와도 에이전트가 프롬프트를 녹여 버리지 않은 이유다.
Skills Hub는 어떤 자리인가
v0.2.0부터 Hermes에는 Skills Hub라는 게 기본으로 따라온다. 이번 설치본에서 쓸 수 있는 모든 스킬의 로컬 인덱스인데, 메타데이터, 출처 정보, 그리고 조건부 활성화 계층이 함께 붙어 있다. hermes skills list로 뭐가 깔려 있는지 볼 수 있고, hermes skills enable <name>이나 hermes skills disable <name>로 켜고 끌 수 있고, hermes skills info <name>로 매니페스트와 출처, 정확한 전제 조건을 확인할 수 있다.
Hub는 동시에 커뮤니티 스킬이 꽂히는 자리이기도 하다. 스킬 저자는 매니페스트와 소스 패키지를 내놓고, Hermes 사용자는 명령 하나로 그걸 설치한다. Hub는 거기에 대해 번들 스킬에 하는 것과 똑같은 방식으로 전제 조건 검증과 활성화 규칙 판정을 돌린다. "공식" 스킬과 "커뮤니티" 스킬 사이에 별도 경로는 없다 — 둘 다 그냥 스킬이다.
런칭 4주 뒤, 이 Hub는 바깥을 향한 얼굴을 갖게 됐다. agentskills.io다. 커뮤니티 기여 스킬들의 웹 디렉터리이고, 검색, 카테고리, 인기도 지표, 표준화된 설치 커맨드까지 갖춰져 있다. 에이전트 기능의 npm이나 pip이라고 보면 된다. 다만 범위가 더 좁다. 스킬 하나는 한 가지 일만 하기로 되어 있고, Hermes가 안전하게 쓸 수 있도록 알려 주는 매니페스트가 반드시 따라붙는다.
생태계는 왜 빠르게 커졌나
제로에서 커뮤니티 스킬 수백 개까지 4주는 짧은 시간이다. 아키텍처상 몇 가지 결정이 그걸 가능하게 했다.
매니페스트가 곧 인터페이스다. 스킬 저자는 매니페스트만 제대로 쓰면 된다. 전제 조건, 설명, 입력 스키마, 활성화 조건 — 전부 skill.yaml에 들어간다. 구현 자체는 파이썬일 수도 있고, 셸 스크립트일 수도 있고, 실행 바이너리일 수도 있고, 매니페스트가 가리킬 수 있는 거라면 뭐든 된다. 기여자는 쓸 만한 스킬을 쓰기 위해 Hermes 전용 SDK를 일부러 배울 필요가 없다. YAML 파일 하나로 "이 도구가 뭘 하는지"를 기술하기만 하면 되는데, 그 YAML 포맷은 이미 번들 스킬들이 쓰고 있던 것 그대로다.
전제 조건은 문서가 아니라 구조에 박혀 있다. 스킬이 ffmpeg을 필요로 한다면 매니페스트에 그렇게 써야 하고, 그러면 Hermes가 대신 확인해 준다. 의존성이 빠진 채로 런타임에 조용히 실패하는 고장 난 스킬을 붙잡을 일이 없다 — Hub가 뭐가 빠졌는지 알려 주고, 활성화 자체를 거부한다. 이 덕분에 저자는 뭔가를 가정할 수 있고, 사용자는 그 가정을 믿을 수 있다.
활성화는 조건부다. 스킬은 자기가 텔레그램에서만, 특정 환경 변수가 설정돼 있을 때만, 특정 파일이 있을 때만, 특정 작업 디렉터리에서만 활성화된다고 선언할 수 있다. 에이전트가 보는 프롬프트는 그 순간의 상황에 맞춰 재단돼 있다. 스킬을 백 개 깔아도 어느 한 세션 동안 에이전트는 그중 아흔 개를 끝내 보지 못할 수도 있다 — 그러니까 프롬프트가 부풀지 않는다.
기본값이 샌드박스 친화적이다. 코드를 실행하는 스킬은 Hermes가 원래부터 가지고 있던 샌드박스 레이어 위에서 돈다 — v0.2.0 런칭 때 들어간 git 워크트리 격리와 파일시스템 체크포인트 시스템이다. 폭주한 커뮤니티 스킬이 네 코드나 파일을 정말로 망가뜨릴 수는 없다. 샌드박스는 개별 스킬이 아니라 에이전트 쪽에 구워 넣어져 있기 때문이다. 덕분에 새로운 물건을 깔 때 드는 신뢰 비용이 확 내려간다.
커뮤니티 스킬은 대체로 어떤 모양인가
첫 4주의 커뮤니티 스킬들은 대체로 몇 가지 쓸모 있는 패턴에 뭉친다.
- •기존 CLI 툴 래퍼. 누군가
ffmpeg,pandoc,imagemagick같은 걸 가져다가 자주 쓰는 동작 — 비디오 자르기, 문서 변환, 이미지 리사이즈 — 을 얇게 노출시키는 스킬을 쓴다. 만드는 비용은 싸고, 바로 쓸모가 있다. - •개인용 서비스와의 연동. 사용자 자신의 Notion, Obsidian vault, Home Assistant, RSS 리더, Pocket 계정, 개인 가계부 앱과 대화하는 스킬들. 대부분 파이썬 200줄 미만에 매니페스트 한 장으로 끝난다.
- •특정 워크플로용 작은 도우미. 연구자용 논문 읽기 스킬, 엔지니어링 리드용 git log 요약 스킬, 집에서 요리하는 사람용 식단 생성기, 테이블탑 RPG 그룹용 던전 마스터 보조 스킬.
- •모델별 심(shim). 프로바이더 고유 기능(프롬프트 캐싱 헤더, 추론 예산, fine-tuning 훅)을 커스텀 클라이언트 코드를 쓰지 않아도 되도록 정식 에이전트 툴로 감싸 주는 스킬.
하나하나만 놓고 보면 어느 것도 킬러 기능이라고 부르기 어렵다. 그런데 전부 합쳐 놓으면, Hermes가 "Nous Research가 만든 어떤 물건"에서 "하나의 커뮤니티"로 넘어간 경계선이 바로 거기에 있었다.
재미있는 부작용
agentskills.io의 커뮤니티 스킬이 100개를 넘긴 날, 이 프로젝트에는 미묘한 변화가 있었다. Hermes Agent가 무엇인지를 기능 목록을 늘어놓는 방식으로는 더 이상 설명할 수 없게 된 거다. 기능 세트에 경계선이 사라졌기 때문이다. 대신 설명할 수 있는 건 형태다 — 유일한 에이전트가, 네가 좋아하는 어느 채팅 플랫폼하고든 말을 섞고, 필요할 때마다 스킬을 끌어 쓰고, 그 모든 걸 하나의 통일된 안전 모델 아래에서 돌린다는 형태.
이건 이미 기능 목록이 아니다. 플랫폼이다. 스킬 생태계가 그 안에 들어 있는 어떤 개별 기능보다도 더 중요한 이유도 여기에 있다.