Hermes Agent 스킬
기준일: 2026-07-26
문서 반영 버전: v2026.7.20
난이도: 중급
공식 기준: Skills System, Work with Skills, Curator
스킬은 Hermes가 필요할 때 불러오는 절차형 지식 문서입니다. 메모리가 “무엇을 기억할지”라면, 스킬은 “어떻게 할지”를 담습니다. agentskills.io 스펙과 호환되며, progressive disclosure로 토큰을 절약합니다.
핵심 개념
| 개념 | 설명 |
|---|---|
| 로컬 스킬 | ~/.hermes/skills/ — 단일 소스 오브 트루스 |
| 외부 스킬 디렉터리 | skills.external_dirs로 추가 스캔 (공유 스킬) |
| 스킬 번들 | 여러 스킬을 하나의 slash command로 묶음 (~/.hermes/skill-bundles/) |
| Skills Hub | official, skills.sh, GitHub, well-known, clawhub 등에서 설치 |
| Agent-managed skills | skill_manage로 에이전트가 생성·수정·삭제 |
/learn |
디렉터리·URL·방금 한 절차를 스킬로 증류 |
| write_approval | 스킬 쓰기를 스테이징 후 사람 승인 |
| Curator | agent-created 스킬의 사용량·노후·정리 |
스킬은 slash command로 호출할 수 있고, 자연어 대화에서도 필요한 경우 로드됩니다. 에이전트가 스킬을 만들거나 수정할 수 있으므로, 공유 디렉터리는 쓰기 권한을 신중하게 설정해야 합니다.
Progressive disclosure
Level 0: skills_list() → name, description, category
Level 1: skill_view(name) → 전체 SKILL.md
Level 2: skill_view(name, path) → 특정 reference 파일
에이전트는 필요할 때만 전체 본문을 로드합니다.
선택 기준
스킬로 만들기 좋은 작업:
- 릴리스 노트 작성 절차
- 코드 리뷰 체크리스트
- 회사별 배포 전 검증 순서
- 반복되는 리서치/보고서 포맷
스킬로 만들지 않아도 되는 작업:
- 한 번만 필요한 질문
- API 키나 민감정보 자체
- 프로젝트 사실 한 줄 → 메모리
- 아직 검증되지 않은 임시 절차
실습
설치·검색
hermes skills list
hermes skills browse
hermes skills search react
hermes skills install openai/skills/k8s
hermes skills check
hermes skills update
설치 시 보안 스캐너가 동작합니다. dangerous 판정은 --force로도 우회되지 않습니다.
/learn — 경험에서 스킬 만들기
/learn the REST client in ~/projects/acme-sdk, focus on auth + pagination
/learn https://docs.example.com/api/quickstart
/learn how I just deployed the staging server
에이전트가 도구로 자료를 모은 뒤 house authoring 기준에 맞는 SKILL.md를 작성합니다. Dashboard Skills 페이지의 Learn a skill 버튼도 같은 흐름입니다.
호출과 스택
/github-pr-workflow create a PR for the auth refactor
/github-pr-workflow /test-driven-development fix issue #123 and open a PR
선두 slash skill은 최대 5개까지 스택됩니다. 설치되지 않은 토큰에서 파싱이 멈춥니다.
번들
hermes bundles create backend-dev \
--skill github-code-review \
--skill test-driven-development \
--skill github-pr-workflow \
-d "Backend feature work"
hermes bundles list
번들 스킬 시드 끄기
# 설치 시
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --no-skills
# 기존 프로필
hermes skills opt-out
hermes skills opt-out --remove # 수정되지 않은 번들 스킬만 삭제
hermes skills opt-in --sync
.no-bundled-skills 마커가 있으면 update 후에도 번들 시드를 건너뜁니다.
write_approval 게이트
# ~/.hermes/config.yaml
skills:
write_approval: true # false(기본)=자유 쓰기, true=스테이징 후 승인
/skills pending
/skills diff <id>
/skills approve <id>
/skills reject <id>
/skills approval on
스테이징 파일은 ~/.hermes/pending/skills/에 남습니다.
외부 디렉터리
skills:
external_dirs:
- ~/.agents/skills
- /home/shared/team-skills
로컬 동명 스킬이 외부보다 우선합니다. 외부 경로가 쓰기 가능하면 agent skill_manage도 수정할 수 있습니다.
Hermes에 입력할 프롬프트
이 작업 절차를 Hermes 스킬로 만들 수 있는지 평가해줘.
스킬로 만들 가치가 있다면 SKILL.md 구조, 필요한 입력, 금지할 행동,
검증 명령을 초안으로 작성해줘.
민감정보는 절대 포함하지 마.
체크리스트
- 메모리와 스킬의 역할을 구분했다.
- 반복되는 절차만 스킬 후보로 골랐다.
-
/learn또는 Skills Hub로 스킬을 추가하는 경로를 안다. - 외부 스킬 디렉터리의 쓰기 권한을 확인했다.
- 스킬에 비밀값을 넣지 않았다.
- 필요하면
skills.write_approval로 자동 쓰기를 게이트한다. - 스킬 실행 후 검증 방법을 함께 정의했다.