Hermes Agent 스킬: 나만의 스킬 설치 및 만들기

스킬은 에이전트를 위한 저장된 지침입니다. 작업을 수행하는 방법을 한 번 설명해 두면, 그다음부터 Hermes는 반복 설명 없이 /skill-name을 호출할 때 해당 지침을 적용합니다. 준비된 스킬은 명령 하나로 설치할 수 있으며, SKILL.md를 직접 작성하거나 /learn을 사용하는 두 가지 방법으로 나만의 스킬을 만들 수 있습니다.

Hermes를 아직 설치하지 않았다면 먼저 이 에이전트가 무엇이며 어떻게 설치하는지 안내서를 확인한 다음 스킬로 넘어가세요.

Hermes Agent에서 스킬이란 무엇인가요?#

에이전트에게 보내는 메시지에 프롬프트를 작성합니다. 스킬은 별도의 파일에 저장되므로 Hermes가 이후 작업에서 해당 지침을 사용할 수 있습니다. 에이전트는 이름과 설명의 목록을 참조하며, 작업과 관련 있을 때 전체 스킬 내용을 불러옵니다. 이렇게 하면 모든 지침을 한 번에 불러오지 않아도 되어 컨텍스트 공간을 절약할 수 있습니다.

스킬만으로 에이전트에 새 도구나 접근 권한이 생기지는 않습니다. 스킬은 에이전트가 이미 가진 도구를 사용하는 방법을 설명합니다. 외부 서비스와의 새로운 연동은 별도 주제인 MCP로 처리합니다. 작업에 정밀한 프로그램 로직, 특별한 권한 부여 또는 이벤트 스트림 처리가 필요하다면 에이전트 도구가 필요하며, 스킬만으로는 충분하지 않습니다.

표준 작업이라면 지침이 적합하고 출처를 확인한 준비된 스킬을 선택하세요. 특정 작업 순서, 제약 조건, 출력 형식을 보존해야 한다면 직접 작성하세요. 이미 자료가 있거나 절차를 마쳤고 파일을 직접 작성하고 싶지 않다면 /learn을 사용하세요.

이 형식은 개방되어 있고 Agent Skills 사양과 호환되므로, 다른 카탈로그의 스킬도 대개 형식을 바꾸지 않고 Hermes에서 작동합니다. 다만 특정 스킬은 자체 도구나 키가 필요할 수 있습니다. 원한다면 직접 만든 스킬을 공유할 수도 있습니다.

어떤 스킬이 이미 설치되어 있고 어디에 저장되나요?#

폴더는 다음과 같이 구성됩니다.

~/.hermes/skills/
├── research/
│   └── arxiv/
│       ├── SKILL.md
│       └── scripts/
├── productivity/
│   └── pdf/
│       ├── SKILL.md
│       └── references/
└── .hub/

필수 파일은 SKILL.md뿐입니다. 나머지는 필요에 따라 추가합니다. 긴 자료는 references/, 보조 프로그램은 scripts/, 템플릿과 파일은 templates/ 및 assets/에 둡니다.

기본 카탈로그에는 GIF 찾기, PDF·스프레드시트·YouTube·GitHub·메모 작업 등 일상적인 작업을 위한 스킬이 포함되어 있습니다. 설명이 포함된 전체 목록은 기본 스킬 카탈로그 페이지에서 확인할 수 있습니다. hermes update를 실행할 때마다 Hermes는 기본 스킬도 업데이트하면서 사용자의 수정 사항을 보존합니다.

카탈로그에서 준비된 스킬을 어떻게 설치하나요?#

1. 카탈로그 검색

   hermes skills search pdf
   

   검색은 연결된 모든 출처를 대상으로 실행됩니다. 필터 없이 전체 카탈로그를 보려면 hermes skills browse를 실행하세요.

2. 스킬 정보 확인

   hermes skills inspect skills-sh/anthropics/skills/pdf
   

   스킬 정보에는 설명, 출처, 신뢰 수준이 표시됩니다. 다른 사람이 만든 스킬은 정보를 읽지 않고 설치하지 마세요.

3. 설치

   hermes skills install skills-sh/anthropics/skills/pdf
   

   Hermes는 SKILL.md와 관련 파일을 다운로드하고 보안 검사를 실행한 뒤, 모든 파일을 ~/.hermes/skills/에 둡니다. 해당 스킬은 즉시 /pdf 명령으로 사용할 수 있습니다. 스킬에 추가 도구나 키가 필요하면 SKILL.md에 그 내용이 적혀 있고, Hermes가 설치 중에 알려줍니다.

보안 검사는 데이터를 외부로 보내려는 시도, 에이전트에 주입된 지침, 파일을 삭제하거나 손상시킬 수 있는 명령을 찾습니다. 출처는 신뢰 수준에 따라 구분됩니다.

검사에서 경고가 표시되면 --force 플래그로 설치를 계속할 수 있지만, 먼저 어떤 위험을 발견했는지 읽어보세요. “dangerous” 판정은 우회할 수 없습니다. 검사만으로 안전이 보장되는 것은 아닙니다. 다른 사람이 만든 스킬을 처음 실행하기 전에 지침과 관련 명령을 읽어보세요.

GitHub 또는 링크에서 스킬을 어떻게 설치하나요?#

설치 방법은 세 가지입니다.

# 1. GitHub 저장소에서 특정 스킬 설치 (저장소 내부 경로는 이름 뒤에 붙습니다)
hermes skills install anthropics/skills/skills/pdf

# 2. 어느 사이트에 있는 SKILL.md로 연결되는 직접 링크 (채팅에서 이 스킬을 공유하세요)
hermes skills install '<OFFICIAL_URL>'

# 3. 전체 저장소를 출처로 연결 (소유자와 저장소 이름을 입력하세요)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

직접 링크를 사용하면 Hermes는 SKILL.md와 그 안에 언급된 서비스 하위 폴더의 파일만 다운로드하며, 사이트의 무관한 파일은 다운로드하지 않습니다. 해당 링크는 출처로 기억되므로 나중에 hermes skills update를 실행하면 같은 주소에서 스킬을 업데이트합니다.

GitHub 외에도 외부 스킬 카탈로그를 연결할 수 있습니다. 같은 hermes skills search 명령으로 카탈로그의 스킬을 찾을 수 있으며, 출처를 지정하면 됩니다.

설치한 스킬은 어떻게 사용하나요?#

터미널에는 hermes ... 명령을 입력하고, 에이전트와의 채팅(같은 터미널, 웹 인터페이스 또는 메신저)에는 /skill-name 호출을 입력하세요.

/gif-search funny cats
/github-pr-workflow create a PR for the authorization rewrite

작업 없이 /skill-name만 입력하면 Hermes가 지침을 불러온 뒤 무엇을 할지 묻습니다. 한 줄에서 최대 다섯 개의 스킬을 호출할 수 있으며, 나머지 텍스트가 작업이 됩니다.

/github-pr-workflow /test-driven-development close issue 123 and open a PR

정기적으로 사용하는 조합에는 Hermes 용어로 bundle이라고 부르는 스킬 묶음이 있습니다. hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development 명령은 여러 스킬을 짧은 /backend-dev 명령 하나로 묶습니다. 이 bundle은 별칭처럼 작동하며, 포함할 스킬은 먼저 설치되어 있어야 합니다.

게이트웨이가 연결되어 있으면 Telegram에서도 슬래시 명령을 사용할 수 있습니다. 설정 방법은 Hermes Agent를 Telegram에 연결하는 방법 안내서에 나와 있습니다. 휴대전화에서 스킬을 실행하기에도 편리합니다.

나만의 스킬을 만드는 방법: SKILL.md에는 무엇을 넣나요?#

이 스킬을 복사해 나에게 맞게 수정할 수 있습니다.

---
name: weekly-review
description: Weekly review: what got done, what stalled, plan for next week
version: 1.0.0
metadata:
  hermes:
    tags: [planning, review]
---

# Weekly review

## When to Use
When the user asks to review the week or put together a plan for the next one.

## Procedure
1. Get the week's task list from the file the user provided, or ask them for it.
2. Sort the tasks into three groups: done, stalled, and new.
3. Name three priorities for the coming week.

## Pitfalls
- Don't invent tasks that aren't in the original list.

## Verification
Ask the user to confirm that the tasks are correctly sorted into “done,” “stalled,” and “new.”

세 개의 대시 사이에 있는 머리말은 메타데이터입니다. 주요 필드는 name(라틴 문자로 작성하고 단어는 하이픈으로 구분하며, 명령으로 스킬을 호출할 때 사용)과 description입니다. 에이전트는 description 필드로 현재 작업에 스킬이 적합한지, 불러와야 하는지를 판단합니다. description이 모호하면 필요할 때 스킬이 불러와지지 않을 수 있습니다.

머리말 다음에는 지침 섹션이 이어집니다. When to Use는 스킬을 불러올 시점을 설명합니다. Procedure는 단계를 제공합니다. Pitfalls에는 에이전트가 흔히 저지르는 실수와 이를 피하는 방법을 적습니다. Verification은 결과 확인 방법을 설명합니다. 지침이 길다면 주요 내용을 references/의 파일로 옮기세요. 필요할 때만 불러오게 하고, 보조 프로그램은 scripts/에 넣으세요.

스킬에 API 키가 필요하다면 머리말에서 required_environment_variables를 사용해 선언하세요. 파일에 키 자체를 넣지 말고 변수 이름만 선언해야 합니다. Hermes는 로컬 터미널에서 처음 호출할 때 값을 한 번 물어본 뒤 자동으로 제공합니다(메신저에서는 키를 로컬에서 설정하라고 안내합니다). platforms, config, blueprint 및 기타 필드는 공식 문서의 Creating Skills 페이지에 설명되어 있습니다.

파일을 준비했으면 다음 단계를 따르세요.

1. 스킬 폴더 만들기

   mkdir -p ~/.hermes/skills/weekly-review
   

   폴더 이름은 머리말의 name 필드와 일치합니다.

2. SKILL.md 저장하기

   지침을 담은 SKILL.md 파일을 폴더 안에 저장하세요. 위 예시를 사용해 작업에 맞게 고쳐도 됩니다.

3. 스킬 호출 및 확인하기

   /weekly-review를 입력하고 에이전트에게 이번 주를 검토해 달라고 요청하세요. 지침에 적힌 단계를 따른다면 스킬이 제대로 작동하는 것입니다.

기존 자료로 /learn을 사용해 스킬을 만드는 방법#

/learn 데모 API 문서 ~/projects/example-docs, 특히 인증 섹션
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn 방금 사이트를 호스팅에 게시한 방법

에이전트와 복잡한 절차를 막 마쳤다면, 모든 단계가 아직 대화에 남아 있을 때 /learn에 이를 스킬로 저장하라고 요청하세요. 다음번에는 Hermes가 준비된 지침을 사용해 절차를 반복합니다.

책, 사양 또는 문서 아카이브처럼 큰 자료는 파일 하나에 모두 들어가지 않습니다. Hermes는 주제 지도를 담은 간결한 SKILL.md를 만들고 세부 내용은 references/로 옮깁니다. 에이전트가 질문에 답하려고 불러오기 전까지는 이 파일들이 컨텍스트 공간을 차지하지 않습니다. 같은 주제로 /learn을 다시 호출하면 중복 스킬을 만드는 대신 기존 스킬에 내용을 추가합니다.

스킬이 작동하는지 어떻게 확인하나요?#

hermes chat --toolsets skills -q "review my week using the weekly-review skill: done - report and calls, stalled - hosting payment"

이것이 문서에서 권장하는 테스트입니다. 스킬을 실행하고 에이전트가 지침을 따르는지 확인하세요. 따르지 않는다면 가능한 원인 세 가지를 확인합니다. 첫째, 폴더 이름이나 머리말의 name이 호출한 이름과 일치하지 않을 수 있습니다. 둘째, 설명에 언제 스킬을 사용해야 하는지가 분명하게 드러나지 않을 수 있습니다. 작업 자체에 쓰인 단어를 사용해 설명을 다시 작성하세요. 셋째, 폴더가 ~/.hermes/skills/에 없어서 Hermes가 찾지 못할 수 있습니다. --toolsets skills 플래그는 테스트에 사용할 도구 세트를 제한합니다. 이 테스트는 에이전트가 지침을 따르는지는 보여주지만, 외부 프로그램 같은 스킬 종속성은 확인하지 않습니다.

터미널에서 hermes skills list를 실행하면 설치된 항목을 정확히 볼 수 있습니다.

스킬은 AI 클론의 일부입니다. 작업을 수행하는 방식을 한 번 기록해 두면 에이전트가 알림 없이 반복할 수 있습니다. 여기에 AI 클론 + 세컨드 브레인 + 컨텍스트 엔지니어링이 결합됩니다. 이러한 조합은 작업 방식과 작업 맥락을 에이전트에 전달하는 데 도움이 됩니다.

스킬을 업데이트하고 제거하는 방법#

hermes skills check      # 출처에서 무엇이 바뀌었는지 확인
hermes skills update     # 새 버전 다운로드
hermes skills uninstall pdf   # hub에서 스킬 제거

직접 만든 스킬을 제거하려면 ~/.hermes/skills/에서 해당 폴더를 삭제하세요. 다른 사람이 만든 스킬을 수정했다면 update는 해당 스킬을 건드리지 않습니다. Hermes는 해시를 비교하고 변경된 파일을 건너뛰어 작업 내용을 덮어쓰지 않습니다. hub에서 받은 스킬의 원본을 복원하려면 hermes skills update name --force를 사용하고, 기본 제공 스킬은 hermes skills reset name --restore를 사용하세요. 두 명령 모두 수정 내용을 덮어쓰므로 먼저 자신의 버전을 저장하세요.

기본 제공 스킬이 필요 없고 목록을 복잡하게 만든다면 hermes skills opt-out으로 업데이트 중 기본 제공 스킬이 추가되지 않게 할 수 있습니다. opt-out --remove 명령은 수정하지 않은 기본 제공 스킬도 제거합니다.

스킬이 설치되지 않거나 작동하지 않으면 어떻게 해야 하나요?#

Hermes는 git 저장소 내부의 .hermes/skills/ 및 .agents/skills/ 폴더에서 스킬을 찾습니다. 이 파일에는 에이전트가 따를 지침이 들어 있으므로 로드하기 전에 저장소를 신뢰됨으로 표시해야 합니다. 그 후 저장소의 스킬은 해당 저장소 안에서만 작동하며 동일한 보안 검사를 받습니다. 저장소를 신뢰됨으로 표시하는 작업은 한 번만 하면 됩니다.

무엇부터 하면 좋을까요?#

다음으로는 Hermes Agent를 Telegram에 연결하는 방법을 읽고 휴대전화에서 스킬을 호출해 보세요. 예약된 스킬을 사용하고 싶다면 서버에서 에이전트를 24시간 실행하는 방법을 확인하세요. 에이전트를 고르는 중이라면 OpenClaw와 Hermes Agent 비교를 참조하세요.