Hermes Agent Skills 고급 가이드: SKILL.md, GEPA 자기 진화 및 Skill Bundles 워크플로(2026)
Hermes Agent 입문은 끝났지만 Skill이 늘수록 Token 폭발·중복 절차·진화 사이클 정체가 겹칩니다. agentskills.io 표준 SKILL.md, 조건부 활성화, Skill Bundles, GEPA+DSPy 자기 진화, Tap 공개까지 개념 비교표·5단 Runbook·FAQ와 함께 설명하고, Mac 클라우드 7×24에서 Skill 자산을 운영하는 판단 근거를 제공합니다.
목차
1. Skills만 깊게 파야 하는 이유
2026년 초 Hermes Agent는 GitHub에서 16만 Star를 돌파했습니다. The agent that grows with you의 핵심은 더 큰 모델이 아니라 표준화·진화 가능·세션 간 지속되는 절차적 메모리=Skills입니다. Progressive Disclosure로 Token을 제어하고, Bundle로 워크플로를 일괄 기동하며, GEPA로 Skill 텍스트를 개선하고, 커뮤니티 Tap까지 한 흐름으로 다룹니다.
핵심 과제: Skill이 늘수록 생기는 세 가지 벽
- Token 비용 눈덩이: Level 0만으로도 전 Skill 합계 약 3K Token. description 정밀도 부족 시 불필요한 Level 1 로드가 연쇄됩니다.
- 절차 분산과 중복：Prompt나 Memory에 절차를 흩뿌리면 팀·채널마다 버전이 갈라지고 Cron/IM 동작이 어긋납니다.
- 진화 사이클 정체：노트북·간헐적 VPS에서는 실행 궤적이 쌓이지 않아 GEPA sessiondb 평가가 헛돕니다. Gateway 중단 시 skill_manage 자동 패치도 전달되지 않습니다.
인용 데이터(2026-06): GEPA 1회 최적화 약 $2–10(API만, GPU 불필요); Skill 크기 상한 15KB; 공식 Gateway는 20+ IM 채널·7종 터미널 백엔드 지원.
2. Skills ≠ Memory ≠ Prompts
| 차원 | 일반 Prompt | Memory | Skills |
|---|---|---|---|
| 지속성 | 해당 대화만 | 세션 간·영구 | 세션 간·영구 |
| 로드 시점 | 매번 컨텍스트 | 매 세션 자동 주입 | 온디맨드(핵심 차이) |
| Token 비용 | 매번 소비 | 작고 안정 | 활성화 전 제로 |
| 내용 유형 | 임의 의도 | 사용자 선호·사실 | 절차적 단계 |
| 유지보수 | 사용자 수동 | Agent 자동 | 사용자+Agent |
| 공유 | 어려움 | 비공개 | Tap으로 공개 가능 |
암기법：Prompt=포스트잇, Memory=노트, Skill=SOP 매뉴얼(필요할 때만 펼침).
3. SKILL.md 형식 심화
모든 Skill은 agentskills.io 오픈 표준을 따릅니다. Hermes·Claude Code·Cursor 간 이식이 가능합니다.
---
name: my-skill
description: |
Use when the user needs to [...].
version: 1.0.0
metadata:
hermes:
tags: [devops, automation]
requires_toolsets: [terminal]
---
# My Skill Title
## Procedure
1. 단계一(정확한 명령 포함)
## Common Pitfalls
- 실패 모드와 수정
Progressive Disclosure 3단 로드
| 레벨 | 내용 | 트리거 | Token |
|---|---|---|---|
| Level 0 | name + description | 매 세션 시작(전체 Skill) | 합계 ~3K |
| Level 1 | SKILL.md 전문 | /skill-name 또는 LLM 판단 | 파일 길이 의존 |
| Level 2 | references/ scripts/ | 실행 중 LLM 판단 | 파일 단위 |
description은 「무엇」보다 「언제 쓰는지」를 씁니다. 500행 초과 시 references/로 분리.
4. Skill Bundles: 한 명령으로 전체 워크플로
Bundle은 ~/.hermes/skill-bundles/<slug>.yaml 경량 YAML./bundle-name으로 나열된 Skill을 동시 로드합니다.
name: backend-dev description: Full backend feature workflow. skills: - github-code-review - test-driven-development - github-pr-workflow instruction: | Always write failing tests first. Never push directly to main.
동명 Bundle과 단일 Skill은 Bundle 우선. 미설치 Skill은 건너뛰고 경고. Bundle은 시스템 프롬프트를 바꾸지 않아 Prompt Cache에 유리.
hermes bundles create backend-dev \ --skills github-code-review,test-driven-development,github-pr-workflow \ --instruction "Always write failing tests first"
5. 조건부 활성화
metadata.hermes로 도구 가용성에 따라 Skill을 자동 표시/숨김.
| 필드 | 동작 |
|---|---|
| requires_toolsets | 열거 도구셋 없으면 숨김 |
| requires_tools | 열거 도구 없으면 숨김 |
| fallback_for_toolsets | 열거 도구셋 있으면 숨김(대안) |
| fallback_for_tools | 열거 도구 있으면 숨김 |
예: 유료 web_search가 있을 때 DuckDuckGo Skill을 숨기고, API 장애 시에만 fallback으로 등장 — Token과 비용을 동시에 절약.
6. Skills Hub와 오픈소스 생태
hermes skills install official/research/arxiv hermes skills tap add github:my-org/my-skills hermes skills tap update
| 저장소 | 개요 | 하이라이트 |
|---|---|---|
| ChuckSRQ/awesome-hermes-skills | 프로덕션 큐레이션 | Deep Research·MLOps·Apple 연동 |
| amanning3390/hermeshub | 커뮤니티 레지스트리 | 프롬프트 주입 스캔 |
| kevinnft/ai-agent-skills | 191 Skill·28 카테고리 | Hermes/Claude/Cursor 공통 |
| NousResearch/hermes-agent | 공식 | 내장 Skill과 규범의 정본 |
7. Skill Tap 공개
GitHub 저장소를 Tap으로 등록하면 팀 전체가 hermes skills tap add github:your-org/your-skills-tap로 구독. 비공개 Tap은 --token $GH_TOKEN. 개인 Skill은 ~/.hermes/skills/를 Git으로 관리하고 기기 간 git pull && hermes skills reset.
8. GEPA + DSPy 자기 진화
GEPA(Genetic-Pareto Prompt Evolution)는 ICLR 2026 Oral.hermes-agent-self-evolution은 모델 가중치 없이 SKILL.md 텍스트만 개선합니다.
- SQLite 실행 궤적 수집
- LLM 실패 원인 분석
- 10–20개 SKILL.md 변이 생성
- 성공률×Token 효율×속도 파레토 평가
- 최적 변이를 PR화 후 수동 승인
export HERMES_AGENT_PATH=~/.hermes
python -m evolution.skills.evolve_skill \
--skill github-code-review \
--iterations 10 \
--eval-source sessiondb
| 단계 | 대상 | 엔진 | 상태 |
|---|---|---|---|
| Phase 1 | SKILL.md | DSPy + GEPA | ✅ 구현됨 |
| Phase 2 | 도구 설명 | DSPy + GEPA | 계획 중 |
| Phase 3–5 | 시스템 프롬프트·코드·완전 자동 | 각종 | 로드맵 |
네 가지 가드레일: 전체 pytest 통과·15KB 상한·Prompt Cache 호환·의미 드리프트 검사.
9. Plugin 스킬
플러그인은 plugin:skill 네임스페이스로 Opt-in 로드. 기본 skills_list를 오염시키지 않고 형제 Skill을 가로로 안내합니다.
skill_view("superpowers:writing-plans")
10. 고급 작성 기법
- description：「Helps with code」는 모호. 「PR 리뷰 시 보안·스타일 검사」처럼 조건을 명시.
- Pitfalls：실패 모드·근본 원인·수정 절차 세트가 품질 분수령.
- scripts/：Agent가 직접 실행할 셸/Python을 포함, 실패 시 references/로 폴백.
| Skill 크기 | 권장 |
|---|---|
| < 500행 | SKILL.md에 통합 |
| 500–1000행 | references/로 분리 |
| > 15KB | GEPA 상한 초과 — 반드시 분할 |
skill_manage(action='patch', ...)로 Agent 자기 유지보수. 프로덕션에서는 agent_writes_require_approval: true 권장.
11. 기술 블로그 워크플로 사례
# ~/.hermes/skill-bundles/blog-workflow.yaml name: blog-workflow skills: - seo-keyword-research - outline-generator - code-example-validator instruction: | Always research SEO keywords before writing. Ensure all code examples are tested.
seo-keyword-research Skill에 requires_toolsets: [web]를 붙이고 한국어·영어 롱테일을 각각 조사하는 Procedure를 둡니다. VPSMAC 다국어 블로그 운영과 궁합이 좋은 패턴입니다.
12. 5단 Runbook: Skill 체계를 Mac 클라우드에서 프로덕션화
1단계：VPSMAC에서 M4 16GB/32GB 노드 선택, SSH 연결.curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash와 hermes setup.2단계：hermes skills install official/...와 Tap 구독으로 베이스라인.3단계：~/.hermes/skills/에 SKILL.md 작성 후 skills-ref validate 검증.4단계：Bundle YAML·조건부 활성화 설정, Telegram/CLI 스모크.5단계：hermes gateway install로 launchd 상주, ~/.hermes 암호화 백업, 필요 시 GEPA sessiondb 진화. 해지 전 디스크 삭제.
13. FAQ와 리소스
Skills와 MCP 차이? Skill은 절차서, MCP는 도구 연결 — 상호 보완.수정이 반영 안 됨? /reset 또는 --now.Claude Code 재사용? ~/.claude/skills/ 복사 또는 kevinnft/ai-agent-skills 크로스 설치.
공식：Skills 문서, GEPA 저장소, agentskills.io.
로컬 노트북·간헐적 Linux VPS·WSL2에서도 Skill을 쓸 수 있지만, 실행 궤적 부족·Gateway 중단·비네이티브 macOS가 GEPA 진화와 7×24 IM 응답을 막습니다. Skill 자산을 팀과 공유하며 Cron·Tap 업데이트를 돌리려면 월 구독 Mac 클라우드 전용 노드가 장기 비용·운용 균형에 유리합니다.VPSMAC Apple Silicon Mac 클라우드는 고정 월요금·SSH 베어메탈·launchd 템플릿·해지 전 삭제로 Skill 개선에 집중할 수 있습니다.