【제10회】Hermes Agent가 사용할수록 똑똑해지는 Skills 등록 방법

목차

• 개념 정리──Skills로 무엇이 변하는가
• 사전 준비
• 표준 스킬 보기·사용하기
• Skill과 tool의 관계 보기
• Skills Hub에서 외부 Skill 찾기
• 첫 자작 Skill 만들기──기사 및 영상 요약
• Progressive Disclosure(단계적 공개) 이해하기
• Telegram에서 호출하기
• Cron에 Skill 첨부하기──매일 아침 Hermes의 최신 정보 요약시키기
• Skill에 파일 첨부하기 (Level 2)
• 최종 확인 체크리스트
• 요약 및 제11회 예고
• 자주 발생하는 에러와 대처법
• 조작 빠른 참조표
• 공식 문서 인용 출처

제6회에서 systemd 상주가 완성되었고, 제7회에서 Hermes Desktop, 제8회에서 Web Dashboard, 제9회에서 Cron이 갖춰졌다. 에이전트(Agent)는 VPS 위에서 24시간 작동하며, 매일 아침 7시에 뉴스 요약을 Telegram으로 전달하는 단계까지 왔다.

다만, 제9회의 작업(Job)에는 긴 프롬프트(Prompt)를 통째로 직접 작성해 두었다. "몇 항목으로 작성하고", "출처를 붙이고", "맺음말은 이렇게"라고 전부 써 내려간 의뢰문이다. 같은 절차를 다른 작업에서도 사용하고 싶다면, 그 장문을 다시 한번 복사해서 붙여넣어야 한다. "이 부분만 조금 수정하고 싶다"고 생각해도, 매번 프롬프트 전체를 위에서부터 다시 읽으며 해당 줄을 찾아야 한다. 발견한 주의 사항을 한 줄씩 추가하다 보면, 프롬프트 칸은 점점 작업 지시서처럼 비대해진다.

제10회에서는 이 부분을 스킬(Skill, Hermes에게 학습시키는 작업 지시서)로 만든다. 자주 사용하는 절차를 파일 한 장에 적어 두면, 이후에는 짧은 호출 한 번으로 동일한 업무가 시작된다. 스킬은 파일로 남기 때문에 대화 이력(Conversation History)을 삭제해도 사라지지 않는다. VPS에 배치한 에이전트가 사용할수록 자신만의 전용 절차를 쌓아가는 회차다.

그리고 이번에는 그 생성과 관리 모두 전부 Web Dashboard 안에서 완결된다. 제9회까지는 자작 스킬이나 Cron 첨부를 위해 SSH(터미널)를 열었지만, Hermes 실기 v0.16.0(2026년 6월 업데이트)에서는 신규 스킬 생성도, Cron 첨부도 브라우저의 관제실 안에서 이루어진다. SSH로 터미널을 열 필요는 없다. 스마트폰을 사용하는 것은 외출 중 Hermes에게 부탁하여 스킬을 쓰게 하는 장면과, 완성된 스킬을 호출하는 장면뿐이다.

시리즈의 전체 모습은 이쪽.

시리즈 목차 (전 45회·탭하여 열기)

제I부 몸 만들기

• 제1회 Hermes Agent를 VPS에 배포(Deploy)하는 방법
• 제2회 Hermes Agent의 접속을 안전하게 만드는 방법
• 제3회 Hermes Agent의 인증 정보를 안전하게 관리하는 방법
• 제4회 Hermes Agent를 Docker로 격리하여 실행하는 방법
• 제5회 Hermes Agent에 Grok과 Discord를 연동하기
• 제6회 Hermes Agent를 systemd로 상시 기동시키는 방법

제II부 얼굴 붙이기

제III부 키우기

• 제9회 Hermes Agent에 매일 아침의 태스크를 자동 실행시키기

제10회(본 기사) Hermes Agent가 사용할수록 똑똑해지는 Skills 등록 방법 - 제11회 Hermes Agent에 최신 정보를 자동 취득시키기 방법

제IV부 기억을 나누어 키우기

• 제12회 Hermes Agent에 Memory로 취향과 전제를 기억시키기
• 제13회 Hermes Agent와 Obsidian을 연동하여 지식을 공유하기

전 45회의 전체 모습은 Hermes Agent 완전 구축 가이드에 있다.

개념 정리──Skills로 무엇이 변하는가

먼저, 이번 회차에서 일어날 일을 말로 정리해 둔다.

스킬은 공식 용어로 말하면 "on-demand knowledge documents", 즉 필요할 때만 읽어 들이는 지식 문서다. 에이전트가 "지금 이것이 필요하다"고 판단했을 때에만 그 지시서를 열어서 읽는다. VPS 상의 ~/.hermes/skills/ (스킬의 위치)에 있는 SKILL.md라는 파일 한 장이 그 본체가 된다.

생각하는 방식은 간단하다. 동봉된 스킬을 사용한다 → 부족하면 Hub에서 찾는다 → 그래도 없으면 직접 작성한다. 이 3단계로 사용한 절차가 ~/.hermes/skills/에 쌓여간다. 본 기사도 이 순서대로 진행된다.

제9회까지의 도달점과 제10회의 차이점

제9회 완료 시점과 제10회 완료 시점에서 무엇이 어떻게 변하는지 표로 나타낸다.

항목	제9회 완료 시	제10회 완료 후
표준 스킬	존재를 모름	동봉된 52건을 스킬 페인(Skill Pane)에서 목록으로 확인 및 활성화/비활성화 전환
...

한마디로 요약하자면 "자주 사용하는 절차를 파일로 기억시켜서, Telegram에서도 뉴스 배포의 Cron에서도 동일한 절차를 호출할 수 있도록 만드는" 회차다.

이번 회차에서 등장하는 용어

레시피 카드라고 생각하며 정리해 둔다.

용어	의미	비유
스킬 (Skill)	"특정 작업의 방법"을 작성한 SKILL.md 파일	요리 레시피 카드. 한 번 작성하면 몇 번이고 사용할 수 있음
SKILL.md	스킬의 본체. 맨 앞에 메타데이터, 그 아래에 절차 본문	레시피 카드의 "요리명"과 "재료·절차"
frontmatter	SKILL.md 도입부의 ---로 둘러싸인 메타데이터 부분	레시피의 "요리명·난이도" 라벨
스킬 페인 (Skill Pane)	Dashboard의 스킬 관리 화면. 전체/툴셋/BROWSE HUB의 3가지 뷰	레시피 북의 인덱스
builtin・local・hub-installed	스킬의 출처. 동봉/자작/Hub 도입의 구분	부속 레시피/수기 레시피/가져온 레시피
Skills Hub	외부 스킬을 검색하여 설치할 수 있는 메커니즘	레시피 사이트에서 레시피를 가져오는 느낌
Trust Level	스킬의 신뢰도. builtin/official/trusted/community의 4단계	"공식 레시피"와 "사용자 투고 레시피"의 구분

제10회 종료 시점의 구성도

자작 스킬은 제6회에서 상주시킨 Hermes Agent 안의 ~/.hermes/skills/에 놓인다. 이번에는 그 생성과 첨부 모두, 모선(가지고 있는 노트북 PC)의 브라우저에서 Tailscale의 안전한 접속을 통해 Dashboard에 연결하여 화면 안에서 해결한다.

포인트는 SKILL.md를 한 번 배치해 두면, 이후에는 Telegram에서도 Cron에서도 동일한 절차를 호출할 수 있다는 점이다. 절차의 본체는 한 곳에만 있으므로, 수정할 때도 그곳만 수정하면 전부 적용된다.

사전 준비

제10회는 모두 Web Dashboard에서 완결된다. SSH로 터미널을 열 필요는 없다. 스킬을 호출하는 상황과, 외출 중에 Hermes에게 부탁하여 스킬을 작성하게 하는 상황에서만 스마트폰을 사용한다.

Dashboard 열기

제8회에서 북마크한 Dashboard의 URL을 브라우저로 연다.

http://<tailscale-ip>:9119 # 제7-8회에서 상주시킨 dashboard의 URL
# ID/password는 basic 인증(제7회)

열었다면, 왼쪽 사이드바의 "스킬"을 선택하면 스킬 페인이 열린다. 이와 함께 사이드바 하단의 "게이트웨이 상태: 실행 중"을 확인해 둔다. 이것이 작동하고 있다면 스킬 호출과 결과 수신이 가능하다.

이번 회차는 SSH 불필요

기존에는 자작 스킬의 생성이나 Cron에 첨부할 때 터미널(nano)을 사용했다. v0.16.0에서 그것들도 Dashboard에 포함되었으므로, 이번에는 브라우저만으로 완결된다. 외출 중에 Hermes에게 부탁하여 스킬을 만들게 하는 상황(후술 5-3)에서만 스마트폰의 Telegram을 사용한다.

표준 스킬 보기·사용하기

직접 만들기 전에, 처음부터 들어있는 스킬을 살펴본다. "공식은 어떤 방식으로 작성되어 있는가"가 그대로 자작의 견본이 된다.

스킬 페인의 전체 모습

왼쪽 사이드바의 "스킬"을 열면 스킬 페인이 나타난다. 왼쪽에는 3가지 뷰를 전환하는 필터가 나열되어 있다.

• 전체: 모든 스킬의 목록. 각 행에 활성화/비활성화 토글, 왼쪽에 카테고리(Creative·Research·MLOps 등)와 검색창 -
• 툴셋 (Toolset): 스킬이 담긴 도구 목록 (다음 장에서 확인) -
• BROWSE HUB: 외부 스킬을 찾는 화면 (4장에서 확인)

헤더에는 "스킬 ○/○ 활성화"와 같이 이 환경의 스킬 수가 표시된다. 오른쪽 상단에는 + NEW SKILL 버튼이 있고, 각 행에는 편집 연필(연필 아이콘)이 있다.

사용하고 싶은 표준 스킬은 토글로 ON

기본값으로는 "전체" 뷰가 열린다. 각 행의 왼쪽 끝에 있는 토글이 해당 스킬의 활성화/비활성화 상태다. 사용하고 싶은 표준 스킬은 여기를 ON으로 바꾸기만 하면 바로 사용할 수 있게 된다.

카테고리(Creative, Research, Software Development 등)로 필터링하거나, 검색창에 arxiv 등을 입력하여 이름으로 검색할 수 있다. 예를 들어 카테고리 「Research」를 선택하면 논문 검색인 arxiv, 웹 검색의 대안인 duckduckgo-search, 지식 참조용인 llm-wiki 등으로 필터링된다.

Skill과 tool의 관계 보기

"스킬(Skill)은 tool 위에 올라가는 지식 문서"라고 기술했다. 이는 **툴셋 뷰(Toolset View)**에서 실제로 확인할 수 있다. tool이 "할 수 있는 것"이라면, 스킬은 "하는 방법"이다. 예를 들어 "웹 검색을 한다"라는 tool이 있고, 그 위에 "아침 뉴스를 이러한 절차로 수집한다"라는 스킬이 올라가는 식이다.

툴셋 뷰(Toolset View) 열기

왼쪽 필터에서 「툴셋(Toolset)」을 선택하면, Hermes가 사용할 수 있는 도구들이 카드로 나열된다. 각 카드에는 「이름 + 활성/비활성 상태 + 사용 가능한 tool 이름 칩 + Configure(설정) 버튼」이 있다. 설정 내용은 제11회에서 다룰 예정이므로, 여기서는 확인만 한다.

관련된 두 개의 카드

이 목록 중에서 이번 주제와 직결되는 카드가 두 개 있다.

• Skills(활성): skill_manage / skill_view / skills_list라는 tool을 가진다. 즉, 스킬 자체도 하나의 tool로서 관리되고 있다는 증거다.
• Cron Jobs(활성): create / list / update / pause / resume / run에 더해 with optional attached skills(선택적으로 스킬을 첨부할 수 있음)라고 명시되어 있다. 이는 제9회 Cron에서 스킬을 첨부할 수 있다는 점에 대한 실기 근거이며, 8장에서 사용하게 된다.

덧붙여 X (Twitter) Search 카드도 보인다. 이것은 비활성 상태이며, requires xAI OAuth or XAI_API_KEY(xAI의 OAuth 또는 API 키가 필요함)라고 적혀 있다. 8장의 뉴스 모니터링에서 X 검색을 사용하는 복선이지만, 자세한 설정은 제11회에서 다룬다.

Skills Hub에서 외부 Skill 찾기

동봉된 스킬만으로 모든 것을 충당할 수는 없다. Skills Hub는 그 외부의 스킬을 추가하는 메커니즘이다. 검색 → Trust 배지 확인 → 설치까지 모든 과정이 브라우저 내에서 완결된다.

BROWSE HUB에서 검색하기

왼쪽 필터에서 「BROWSE HUB」를 선택한다. 검색 바와 Search / Update all 버튼, 그 아래로 연결된 Hub 목록(Official (Nous), Hermes Index, skills.sh, GitHub, ClawHub, Claude Marketplace, LobeHub 등)이 나열된다. 각 행에는 「이름 + source/trust 배지 + 설명 + 식별자 + Install 버튼」이 있다.

검색 바에 duckduckgo를 입력하면 입력하는 즉시 후보가 필터링된다(Search 버튼이나 Update all은 재검색 및 업데이트에 사용한다).

duckduckgo로 필터링하면 공식(official)인 duckduckgo-search가 나온다. 이미 설치되어 있다면 토글이, 미도입 상태라면 Install 버튼이 표시된다. Hub에는 공식 이외의 스킬도 나열되므로, 설치하기 전에 반드시 source/trust 배지를 확인해야 한다. 다음 4단계가 그 기준이다.

Trust Level의 4단계

Hub에서 설치할 때 반드시 확인해야 하는 것이 Trust(신뢰 수준)이다. 스킬은 외부 코드를 가져오는 것이므로, 누가 만들었느냐에 따라 취급이 달라진다.

Trust Level	소스 예시	판단
builtin	Hermes Agent 본체에 동봉됨	항상 신뢰
official	본체에 동봉되어 있으나 기본적으로 비활성화된 스킬	본체와 동일한 수준. 경고 없음. Install로 활성화됨
trusted	openai/anthropics/huggingface/NVIDIA/garrytan의 공식 배포	비교적 안전. 내용은 확인 필요
community	위 항목 이외의 모든 것	개별적으로 내용을 읽고 판단

official

official은 '외부에서 취득'하는 것이 아니라 '동봉된 예비 스킬을 활성화'하는 작업이므로, 안전한 편이다. community가 진정한 외부 취득이며, 이쪽은 내용을 읽어본 뒤에 넣는다.

Install · 업데이트 · 삭제

넣고 싶은 스킬의 Install을 클릭하면, **보안 스캔 (Security Scan)**이 실행된다. 데이터 유출, 프롬프트 인젝션 (Prompt Injection), 파괴적인 커맨드 (Destructive Command), 공급망 이상 (Supply Chain Anomaly)을 체크하며, 문제가 없으면 ~/.hermes/skills/에 저장된다. dangerous (위험)로 판정된 스킬은 애초에 설치할 수 없도록 설계되어 있다.

설치한 스킬의 내용은 스킬 페인 (Skill Pane)으로 돌아가 각 행의 편집 연필 (Edit Pencil) 아이콘을 누르면 SKILL.md를 열어 읽을 수 있고, 그 자리에서 수정할 수 있다.

업데이트는 Update all 버튼으로 한꺼번에 가져올 수 있다.

첫 자작 Skill 만들기 ── 기사나 영상 요약

여기서부터가 '사용할수록 자신만의 것으로 성장한다'는 핵심이다. v0.16.0에서 + NEW SKILL 버튼과 편집 연필이 추가되어, 브라우저만으로 SKILL.md를 작성할 수 있게 되었다.

만드는 방법은 두 가지가 있다. **직접 SKILL.md를 작성하는 것 (Dashboard)**과, **Hermes에게 대략적으로 부탁해서 작성하게 하는 것 (Telegram)**이다. 같은 '스킬 만들기'라도 입구가 다르다는 것을 알 수 있도록, 서로 다른 스킬로 체험해 본다.

• 5-15-2: 직접 Dashboard에서 summarize-to-japanese를 작성한다. 영어 기사나 YouTube URL을 던져 넣으면, 일본어 35줄로 요점이 돌아온다. 매일 아침 뉴스를 체크하거나 해외 기사를 가볍게 읽을 때 유용한 스킬이다.
• 5-3: 외출 중 Telegram을 통해 Hermes에게 plain-japanese를 작성하게 한다. 관공서 통지나 이용 약관 같은 딱딱한 문장을 던지면, 중학생도 이해할 수 있는 쉬운 말로 답해준다. 스마트폰에서 부탁할 수 있다는 것이 핵심이다.

직접 SKILL.md를 작성하기 (Dashboard)

스킬 페인 우측 상단의 + NEW SKILL을 누르면 신규 생성 모달 (Modal)이 열린다. 입력란은 NAME (스킬 이름) · CATEGORY (optional) (분류 · 선택 사항) · SKILL.MD (본체) 세 가지다. 다음과 같이 채워본다.

• NAME: summarize-to-japanese
• CATEGORY: productivity
• SKILL.MD: 아래의 frontmatter + 본문을 붙여넣기

---
name: summarize-to-japanese
description: 기사나 YouTube URL을 전달하면 내용을 가져와 일본어로 요약한다. 영어 등 외국어 소스는 일본어로 번역하여 요약한다.
...

CREATE SKILL을 누르면 서버 측에서 frontmatter를 체크하고, 문제가 없으면 ~/.hermes/skills/summarize-to-japanese/SKILL.md에 저장된다.

frontmatter 중에서 가장 중요한 것은 description이다. 나중에 살펴볼 점진적 공개 (Progressive Disclosure)에서, 에이전트가 가장 먼저 읽는 것은 바로 이 한 줄이다. '언제 사용하는 스킬인지'를 동사를 사용하여 구체적으로 적는다.

목록에 나타났는지 확인하기

CREATE SKILL을 누르면 스킬 페인의 '전체 (All)' 뷰에 summarize-to-japanese가 추가된다 (토글은 ON 상태). 각 행의 편집 연필을 누르면 SKILL.md 에디터가 열려 그 자리에서 수정할 수 있다.

작성 직후에 목록에 나타나지 않는 경우, 브라우저를 새로고침한다 (또는 7장의 /reload_skills를 사용한다).

Hermes에게 부탁해서 작성하기 (Telegram)

또 다른 방법은 외출 중에 Hermes에게 대략적으로 부탁하는 방법이다. Hermes가 skill_manage라는 도구를 사용하여 직접 SKILL.md를 작성하고 저장해 준다.

여기서 만드는 것은 5-1과는 다른 작은 스킬인 plain-japanese (어려운 문장을 중학생도 알 수 있는 쉬운 일본어로 바꾸기)이다. /skills는 Telegram에서 지원하지 않으므로, 슬래시 커맨드 (Slash Command)가 아니라 자연어로 부탁한다.

쉬운 일본어로 바꿔주는 스킬을 만들어줘.
이름은 plain-japanese, 카테고리는 productivity.
어려운 문장을 전달하면, 중학생도 이해할 수 있는 평이한 일본어로 바꿔서 반환하는 스킬로 만들어줘.

Skill 'plain-japanese' created

와 같이 저장 경로가 반환되면 성공이다.

Progressive Disclosure(단계적 개시)를 이해하기

"필요할 때만 읽어온다"는 것은 구체적으로 무엇을 의미하는가. Hermes Agent는 3단계로 스킬을 읽는다. 이를 Progressive Disclosure(단계적 개시)라고 부른다.

Level	읽어오는 내용
Level 0	name / description / category 등의 메타데이터만
Level 1	SKILL.md의 본문 (When to Use / Procedure / Pitfalls)
Level 2	첨부 파일 (references/ ・ scripts/)

| 언제 읽히는가 |
|---|---|
| 상시 (모든 스킬을 대략적으로 파악) |
| 해당 스킬이 선택되었을 때 |
| 본문이 해당 파일을 참조했을 때 |

평소 에이전트가 보유하고 있는 것은 Level 0의 요약뿐이어서, 모든 스킬을 합쳐도 가볍다. 따라서 수가 많아져도 무거워지지 않는다. "이것이 필요하다"라고 판단했을 때에만 Level 1의 본문을 열고, 더 세부적인 자료가 필요하면 Level 2까지 내려간다. 책의 제목을 훑어보고, 관심이 생기면 목차를 보고, 필요하면 본문을 읽는 방식과 유사하다.

여기서 도출되는 가장 중요한 실천 사항은 description을 정성껏 작성하는 것이다. Level 0에서 읽히는 것은 description뿐이므로, 여기서 "언제 사용하는 스킬인지"가 전달되지 않으면 에이전트가 애초에 선택하지 않는다. 동사로 시작하여 구체적인 계기를 작성하는 것이 요령이다.

• 나쁜 예:
  description: 요약 도구
  (너무 추상적이어서 선택되지 않음)

• 좋은 예:
  description: 기사나 YouTube URL을 전달하면 내용을 가져와 일본어로 요약함

Telegram에서 호출하기

설치된 스킬은 자동으로 슬래시 커맨드(Slash Command)가 된다 (공식: "Every installed skill is automatically available as a slash command"). 여기서는 5-3에서 만든 plain-japanese를 Telegram에서 호출한다 (summarize-to-japanese는 다음 8장에서 Cron을 통해 사용한다).

호출하기 전에, 실제 기기에서 확인한 두 가지 사전 작업을 숙지해 둔다.

봇에게 순서대로 보내본다.

/reload_skills … gateway에 스킬을 다시 불러오게 함 (추가 직후 1회만)
/plain_japanese 본 시책은 단계적으로 도입될 예정입니다

/reload_skills로 목록이 갱신된 후, /plain_japanese에 어려운 문장을 전달하면, 어려운 단어에 쉬운 표현이 덧붙여져 반환된다. "쉽게 해줘"와 같은 자연어 문장으로도 동일하게 동작한다.

Cron에 Skill 첨부하기 ── 매일 아침 Hermes의 최신 정보를 요약하기

여기서 제9회 내용과 연결된다. v0.16.0에서, 제9회의 CRON 페인(Pane) 생성·편집 모달에 SKILLS라는 섹션이 추가되었다. 스킬을 체크하여 선택하면(복수 선택 가능), 해당 Cron 작업에 스킬이 첨부되고 작업 카드에 스킬 배지가 나타난다. 3장에서 툴셋으로 보았던 Cron Jobs … with optional attached skills가 바로 이 기능이다. SSH로 hermes cron edit를 입력하던 것과 동일한 작업을 브라우저만으로 할 수 있다.

주제는 "매일 아침, Hermes 자신의 최신 정보를 요약하여 전달하기"로 한다. Hermes의 신기능은 개발사인 @Teknium이나 @NousResearch가 먼저 X(구 Twitter)를 통해 발표한다. 그것을 매일 아침 수집하여 요약하게 하면, 개발사의 움직임을 일본어로 손쉽게 받아볼 수 있다. 5장에서 만든 summarize-to-japanese를 이 Cron에 첨부한다.

Cron 작업 만들기

왼쪽 사이드바에서 "CRON"을 선택하고, 오른쪽 상단의 "생성"을 누른다 (기존 작업을 사용하려면 편집 연필 아이콘). 각 항목을 다음과 같이 채운다.

항목	입력할 값
이름	hermes-watch
...	0 7 * * * (매일 아침 7시. 제9회의 「매일」 모드에서 시간을 선택하면 자동 생성됨)
전송 대상	Telegram
SKILLS	summarize-to-japanese 체크

summarize-to-japanese에 체크를 하는 것이 이번의 핵심 포인트다.

「作成」(신규) 또는 「SAVE CHANGES」(편집)를 눌러 저장하면, 작업 카드(Job Card)에 summarize-to-japanese 스킬 배지가 붙는다. 프롬프트는 「어떤 스킬의 절차로 수행할지」를 한 줄만 작성하면 되며, 제9회와 같은 장문은 더 이상 필요하지 않다. 절차의 상세 내용은 SKILL.md 측에 있기 때문이다.