스킬 작업
스킬은 Hermes에게 ASCII 아트 생성부터 GitHub PR 관리까지 특정 작업을 처리하는 방법을 알려주는 온디맨드 지식 문서입니다. 이 가이드에서는 일상적으로 스킬을 찾고 사용하는 방법을 안내합니다.
전체 참조는 스킬 시스템을 참고하세요.
스킬 찾기
모든 Hermes 설치에는 번들 스킬이 함께 제공됩니다. 사용 가능한 스킬을 확인하세요.
# 어느 채팅 세션에서든:
/skills
# 또는 CLI에서:
hermes skills list
이름과 설명이 포함된 간략한 목록이 표시됩니다.
ascii-art Generate ASCII art using pyfiglet, cowsay, boxes...
arxiv Search and retrieve academic papers from arXiv...
github-pr-workflow Full PR lifecycle — create branches, commit...
plan Plan mode — inspect context, write a markdown...
excalidraw Create hand-drawn style diagrams using Excalidraw...
스킬 검색
# 키워드로 검색
/skills search docker
/skills search music
스킬 허브
공식 옵션 스킬(기본적으로 활성화되지 않는 고급 스킬 또는 특수 목적 스킬)은 허브를 통해 사용할 수 있습니다.
# 공식 옵션 스킬 둘러보기
/skills browse
# 허브 검색
/skills search blockchain
스킬 사용
설치된 모든 스킬은 자동으로 슬래시 명령으로 등록됩니다. 스킬 이름을 입력하면 됩니다.
# 스킬을 로드하고 작업을 맡깁니다
/ascii-art Make a banner that says "HELLO WORLD"
/plan Design a REST API for a todo app
/github-pr-workflow Create a PR for the auth refactor
# 작업 없이 스킬 이름만 입력하면 스킬이 로드되고, 이후 필요한 내용을 설명할 수 있습니다
/excalidraw
자연스러운 대화로도 스킬을 불러올 수 있습니다. Hermes에게 특정 스킬을 사용하라고 요청하면 skill_view 도구를 통해 해당 스킬이 로드됩니다.
점진적 공개
스킬은 토큰을 아끼는 로딩 패턴을 사용합니다. 에이전트는 모든 내용을 한 번에 로드하지 않습니다.
skills_list()— 모든 스킬의 간략한 목록(~3,000 토큰). 세션 시작 시 로드됩니다.skill_view(name)— 특정 스킬의 전체SKILL.md내용입니다. 에이전트가 해당 스킬이 필요하다고 판단하면 로드됩니다.skill_view(name, file_path)— 스킬 안의 특정 참조 파일입니다. 필요한 경우에만 로드됩니다.
즉, 스킬이 실제로 사용되기 전까지는 토큰 비용이 들지 않습니다.
허브에서 설치
공식 옵션 스킬은 Hermes와 함께 제공되지만 기본적으로 활성화되지 않습니다. 필요한 스킬을 명시적으로 설치하세요.
# 공식 옵션 스킬 설치
hermes skills install official/research/arxiv
# 채팅 세션에서 허브 스킬 설치
/skills install official/creative/songwriting-and-ai-music
# HTTP(S) URL의 단일 파일 SKILL.md를 직접 설치
hermes skills install https://sharethis.chat/SKILL.md
/skills install https://example.com/SKILL.md --name my-skill
설치하면 다음 일이 일어납니다.
- 스킬 디렉터리가
~/.hermes/skills/에 복사됩니다. skills_list출력에 나타납니다.- 슬래시 명령으로 사용할 수 있게 됩니다.
설치된 스킬은 새 세션에 적용됩니다. 현재 세션에서 바로 사용하려면 /reset으로 새로 시작하거나 --now를 추가해 프롬프트 캐시를 즉시 무효화하세요. 이 경우 다음 턴에 더 많은 토큰이 필요합니다.
설치 확인
# 설치 여부 확인
hermes skills list | grep arxiv
# 또는 채팅에서 확인
/skills search arxiv
플러그인 제공 스킬
플러그인은 네임스페이스 이름(plugin:skill)으로 자체 스킬을 함께 제공할 수 있습니다. 이렇게 하면 내장 스킬과 이름이 충돌하지 않습니다.
# 정규화된 이름으로 플러그인 스킬 로드
skill_view("superpowers:writing-plans")
# 같은 기본 이름을 가진 내장 스킬에는 영향이 없습니다
skill_view("writing-plans")
플러그인 스킬은 시스템 프롬프트에 나열되지 않으며 skills_list에도 표시되지 않습니다. 필요한 경우 명시적으로 로드하세요. 로드되면 에이전트는 같은 플러그인에 포함된 형제 스킬 목록을 보여주는 배너를 봅니다.
자신의 플러그인에 스킬을 포함하는 방법은 Hermes 플러그인 빌드 → 스킬 번들을 참고하세요.
스킬 설정 구성
일부 스킬은 프론트매터에 필요한 설정을 선언합니다.
metadata:
hermes:
config:
- key: tenor.api_key
description: "Tenor API key for GIF search"
prompt: "Enter your Tenor API key"
url: "https://developers.google.com/tenor/guides/quickstart"
설정이 포함된 스킬이 처음 로드되면 Hermes는 값을 묻는 메시지를 표시합니다. 값은 config.yaml의 skills.config.* 아래에 저장됩니다.
CLI에서 스킬 구성을 관리합니다.
# 특정 스킬의 대화형 설정
hermes skills config gif-search
# 모든 스킬 설정 보기
hermes config get skills.config
나만의 스킬 만들기
스킬은 YAML 프론트매터가 포함된 마크다운 파일입니다. 간단한 스킬은 5분 안에 만들 수 있습니다.
1. 디렉터리 생성
mkdir -p ~/.hermes/skills/my-category/my-skill
2. SKILL.md 작성
---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
metadata:
hermes:
tags: [my-tag, automation]
category: my-category
---
# My Skill
## When to Use
Use this skill when the user asks about [specific topic] or needs to [specific task].
## Procedure
1. First, check if [prerequisite] is available
2. Run `command --with-flags`
3. Parse the output and present results
## Pitfalls
- Common failure: [description]. Fix: [solution]
- Watch out for [edge case]
## Verification
Run `check-command` to confirm the result is correct.
3. 참조 파일 추가(선택 사항)
스킬에는 에이전트가 필요할 때 로드하는 지원 파일을 포함할 수 있습니다.
my-skill/
├── SKILL.md # 메인 스킬 문서
├── references/
│ ├── api-docs.md # 에이전트가 참고할 API 문서
│ └── examples.md # 입력/출력 예시
├── templates/
│ └── config.yaml # 에이전트가 사용할 수 있는 템플릿 파일
└── scripts/
└── setup.sh # 에이전트가 실행할 수 있는 스크립트
SKILL.md에서 다음처럼 참조하세요.
API 세부사항이 필요하면 참조 문서를 로드하세요: `skill_view("my-skill", "references/api-docs.md")`
4. 테스트해 보세요
새 세션을 시작하고 스킬을 시험해 보세요.
hermes chat -q "/my-skill help me with the thing"
스킬이 자동으로 표시되므로 등록이 필요하지 않습니다. ~/.hermes/skills/에 넣으면 활성화됩니다.
에이전트는 skill_manage를 사용해 스킬 자체를 생성하고 업데이트할 수도 있습니다. 복잡한 문제를 해결한 후 Hermes는 다음에 재사용할 수 있도록 접근 방식을 스킬로 저장하겠다고 제안할 수 있습니다.
플랫폼별 스킬 관리
플랫폼별로 사용할 수 있는 스킬을 제어합니다.
hermes skills
플랫폼(CLI, Telegram, Discord 등)별로 스킬을 활성화하거나 비활성화할 수 있는 대화형 TUI가 열립니다. 어떤 스킬을 특정 환경에만 노출하고 싶을 때 유용합니다. 예를 들어 개발 스킬은 CLI에서만 켜 두고 Telegram에서는 숨길 수 있습니다.
스킬과 메모리
둘 다 세션 전반에 걸쳐 지속되지만 서로 다른 목적으로 사용됩니다.
| 스킬 | 메모리 | |
|---|---|---|
| 무엇인가 | 절차적 지식 - 일을 수행하는 방법 | 사실적 지식 - 사물이 무엇인지 |
| 언제 | 요청 시 로드됨(해당되는 경우에만) | 모든 세션에 자동으로 주입 |
| 크기 | 클 수 있음(수백 줄) | 간결해야 함(핵심 사실만) |
| 비용 | 로드되기 전까지 토큰 비용 없음 | 작지만 지속적인 토큰 비용 |
| 예 | "Kubernetes에 배포하는 방법" | "사용자는 어두운 모드를 선호하며 PST에 거주합니다." |
| 만드는 사람 | 사용자, 에이전트 또는 허브에서 설치됨 | 대화를 기반으로 에이전트가 생성 |
경험 법칙: 참조 문서에 넣을 내용이면 스킬입니다. 사용자의 사실이나 선호를 기억해야 한다면 메모리입니다.
팁
스킬에 집중하세요. "모든 DevOps"를 다루려는 스킬은 너무 길고 너무 모호합니다. "Fly.io에 Python 앱 배포"를 다루는 스킬은 실제로 유용할 만큼 구체적입니다.
에이전트가 스킬을 생성하도록 합니다. 복잡한 다단계 작업 후에 Hermes는 종종 접근 방식을 스킬로 저장하겠다고 제안합니다. 수락하면 에이전트가 도중에 발견한 함정까지 포함해 실제 워크플로를 기록합니다.
카테고리를 사용하세요. 스킬을 하위 디렉터리(~/.hermes/skills/devops/, ~/.hermes/skills/research/ 등)로 구성합니다. 이렇게 하면 목록을 관리하기 쉽고 에이전트가 관련 스킬을 더 빨리 찾을 수 있습니다.
오래된 스킬을 업데이트하세요. 스킬을 사용하다가 스킬에서 다루지 않는 문제가 발생하면 Hermes에게 배운 내용을 스킬에 반영하라고 지시하세요. 유지되지 않는 스킬은 부채가 됩니다.
전체 스킬 참조(프론트매터 필드, 조건부 활성화, 외부 디렉터리 등)는 스킬 시스템을 참고하세요.