2026 Hermes Agent Skills 고급 가이드: SKILL.md·Bundles·GEPA 자기 진화 결정 가이드

2026년 초 Nous Research가 공개한 Hermes Agent는 두 달 만에 GitHub Star 16만을 돌파했습니다. 핵심은 더 큰 모델이 아니라 "the agent that grows with you"——표준화·진화·세션 간 지속 가능한 Skills(스킬) 시스템입니다. 본문은 입문 설치(→《Hermes Agent 설치 가이드》)를 건너뛰고, 2026년 트렌드의 중심인 SKILL.md 규격, Progressive Disclosure, Skill Bundles, 조건부 활성화, Tap 배포, GEPA + DSPy 자기 진화까지 한 번에 정리합니다.

1. 세 가지 고통: Hermes Skills 시스템을 따로 공부해야 하는 이유

많은 개발자가 Hermes를 「또 하나의 ChatGPT 래퍼」로만 보지만, 장기 ROI 최고 모듈은 Skills입니다:

1. 토큰 비용 폭주: SOP 전체를 System Prompt에 넣으면 매 대화마다 토큰을 태웁니다. Skills의 Progressive Disclosure는 활성화 전제로 소비입니다.
2. 지식이 쌓이지 않음: 일회성 Prompt는 세션과 함께 사라집니다. Skills는 세션을 넘는절차적 기억으로 버전 관리·공유·진화가 가능합니다.
3. 워크플로 반복 트리거: 복잡한 작업마다 /skill-name을 하나씩 호출해야 합니다. Skill Bundles는 여러 스킬을한 슬래시 명령으로 묶습니다.

고급 독자가 집중할 다섯 질문: Progressive Disclosure로 토큰을 어떻게 제어하나? 조건부 활성화는? Bundles로 한 번에 트리거하려면? DSPy + GEPA로 Skills가 자동 개선되려면? 커뮤니티에 어떤 고품질 저장소가 있나? 아래에서 순서대로 풉니다.

2. 핵심 개념: Skills ≠ Prompts, Skills ≠ Memory

셋을 혼동하면 아키텍처 선택이 틀어집니다. 기억 공식: Prompt = 포스트잇(당번만 유효), Memory = 수첩(영구 메모, 항상 손에), Skill = SOP 매뉴얼(단계별 절차, 필요할 때 펼침).

3. SKILL.md 규격 심층 분석과 Progressive Disclosure

3.1 기본 구조(agentskills.io 오픈 표준)

모든 Hermes Skills는 agentskills.io 표준을 따르며 Hermes·Claude Code·Cursor 간 이식이 가능합니다.

---
name: my-skill                    # 필수: 소문자+하이픈, ≤64자
description: |                    # 필수: ≤1024자, "Use when..." 권장
  Use when the user needs to [...].
  Handles [...] and [...].
version: 1.0.0
license: MIT
compatibility: Requires git, docker
allowed-tools: Bash(git:*) Read
metadata:
  hermes:
    tags: [devops, automation]
    category: software-development
    related_skills: [github-pr-workflow, test-driven-development]
    requires_toolsets: [terminal]
    fallback_for_toolsets: [web]
---

# My Skill Title

## Overview
## When to Use
## Procedure
## Common Pitfalls
## Verification Checklist

3.2 스킬 디렉터리 구조(모듈형 설계)

~/.hermes/skills/
└── my-category/
    └── my-skill/
        ├── SKILL.md              # 본문(핵심 단계, ≤500행 권장)
        ├── references/           # API 참조(온디맨드)
        ├── templates/            # 재사용 템플릿
        └── scripts/              # Agent가 직접 실행할 스크립트

3.3 Progressive Disclosure 3단계 로드(토큰 제어 핵심)

작성 팁: description이 Level 0의 전부입니다. LLM은 이 필드로 전체 스킬 로드 여부를 결정하므로 「무엇인지」보다 「언제 쓰는지」를 명확히 쓰세요.

4. Skill Bundles: 한 명령으로 전체 워크플로 트리거

Skill Bundles는 Hermes 2026 신규 기능으로, 아직 가장 과소평가된 영역입니다. 가벼운 YAML로 관련 스킬 여러 개를 한 슬래시 명령에 묶으며, /bundle-name 실행 시 나열된 스킬이동시에 로드됩니다.

파일 위치: ~/.hermes/skill-bundles/<slug>.yaml

name: backend-dev
description: |
  Full backend feature workflow — code review, TDD, and PR management.
skills:
  - github-code-review
  - test-driven-development
  - github-pr-workflow
instruction: |
  Always write failing tests first before implementation.
  Never push directly to main.

고급 시나리오:

• AI 연구 워크플로(research-session): arxiv + deep-research + plan + excalidraw——세션마다 최신 논문 조회 후 아키텍처 다이어그램.
• MLOps 배포 파이프라인(mlops-deploy): vllm + llama-cpp + github-pr-workflow + systematic-debugging——배포 전후 추론 벤치마크·양자화 설정 기록.

Bundle 우선순위 규칙:

• Bundle과 단일 Skill 이름이 같으면Bundle 우선.
• 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. 조건부 활성화(Conditional Activation): 환경 인식 스킬

스킬은 현재 세션의 도구 가용성에 따라자동 표시·숨김됩니다. metadata.hermes에서 설정:

metadata:
  hermes:
    requires_toolsets: [web]
    requires_tools: [web_search]
    fallback_for_toolsets: [browser]
    fallback_for_tools: [browser_navigate]

대표 시나리오: 무료/유료 검색 자동 전환. duckduckgo-search에 fallback_for_tools: [web_search] 설정——FIRECRAWL_KEY / BRAVE_SEARCH_KEY가 있으면 유료 web_search가 활성화되고 DuckDuckGo 스킬은 토큰 절약을 위해 자동 사라집니다. API 불가 시 대안이 다시 나타납니다.

플랫폼 인식 예: telegram-notify는 requires_toolsets: [messaging]와 platforms: [telegram, discord] 설정. hermes skills TUI로 CLI·Telegram·Discord별 스킬을 독립 ON/OFF 가능.

6. Skills Hub와 오픈소스 커뮤니티 생태계

6.1 공식 설치 채널

hermes skills install official/research/arxiv
hermes skills install https://example.com/SKILL.md --name my-skill
hermes skills install github:openai/skills/k8s
hermes skills tap add github:my-org/my-skills

6.2 주목할 오픈소스 스킬 저장소

agentskills.io 오픈 표준 덕분에 Hermes·Claude Code·Cursor·OpenCode 간 교차 사용이 가능합니다. skills-ref validate ./my-skill로 형식 준수를 검증하세요.

7. 자체 Skill Tap 배포: 팀·커뮤니티 공유

GitHub 저장소를 Tap으로 만들어 팀·커뮤니티가 스킬 세트를 구독하게 하는 방법——2026년에도 잘 알려지지 않은 고급 기법입니다.

my-skills-tap/
├── skills.sh.json
├── mlops/vllm-deploy/SKILL.md
├── research/paper-summarizer/SKILL.md
└── README.md

skills.sh.json으로 Hub 분류 표시를 제어합니다. 팀 배포:

hermes skills tap add github:your-org/your-skills-tap
hermes skills tap add github:your-org/private-skills --token $GH_TOKEN
hermes skills tap update
hermes skills tap list

버전 관리 팁: ~/.hermes/skills/를 Git으로 관리하고, 기기 간 git pull && hermes skills reset으로 동기화 후 내장 스킬을 재구성하세요.

8. Self-Evolving Skills: GEPA + DSPy로 스킬 자동 진화

Hermes를 경쟁 도구와 구분하는 최전선 기능입니다. GEPA(Genetic-Pareto Prompt Evolution)는 2026 ICLR Oral 논문이며 hermes-agent-self-evolution에 통합됐습니다. 핵심: 모델 가중치 미세조정 없이 실행 궤적 분석 → 변형 생성 → 다목적 파레토 최적화로 SKILL.md 텍스트만 개선. 1회 최적화 약 $2–10(순수 API 호출, GPU 불필요).

8.1 GEPA 5단계 진화 파이프라인

1. Stage 1 궤적 수집: SQLite에서 전체 추론 궤적(도구 호출·분기·에러) 읽기.
2. Stage 2 반성적 실패 분석: LLM이 「실패했다」가 아니라 「왜 실패했는지」를 actionable insight로 생성.
3. Stage 3 타깃 변이: 실패 원인별 SKILL.md 변형 10–20개 생성.
4. Stage 4 다목적 파레토 평가: 성공률 × 토큰 효율 × 속도 동시 최적화.
5. Stage 5 사람 검토 PR: 최적 변형 → PR 생성 → 승인 후 배포.

8.2 빠른 시작

git clone https://github.com/NousResearch/hermes-agent-self-evolution
cd hermes-agent-self-evolution && pip install -r requirements.txt
export HERMES_AGENT_PATH=~/.hermes

python -m evolution.skills.evolve_skill \
    --skill github-code-review --iterations 10 --eval-source synthetic

python -m evolution.skills.evolve_skill \
    --skill github-code-review --iterations 10 --eval-source sessiondb

8.3 네 가지 안전 가드레일

1. 전체 테스트 스위트: pytest tests/ -q 100% 통과 필수.
2. 크기 제한: Skills ≤ 15KB, 도구 설명 ≤ 500자.
3. Prompt Cache 호환: 세션 중간 수정으로 캐시 무효화 금지.
4. 의미 보존 검사: 스킬 원래 목적에서 벗어나면 안 됨.

8.4 5단계 진화 로드맵(공식 상태)

크로스 플랫폼 궤적 결합: agentskills.io 표준 덕분에 Claude Code·Gemini CLI 궤적도 GEPA에 투입 가능:

python -m evolution.skills.evolve_skill \
    --skill github-code-review --iterations 10 --eval-source mixed \
    --trace-dirs ~/.claude/traces,~/.hermes/sessions

9. Plugin 스킬: Hermes 확장 경계

플러그인은 스킬을 네임스페이스(plugin:skill)로 묶습니다: 기본 skills_list에 안 나와 노이즈 감소, 사용자가 명시 호출할 때만 활성(Opt-in), 플러그인 내 스킬끼리 상호 참조 가능.

skill_view("superpowers:writing-plans")
# 로드 시 같은 플러그인 형제 스킬 자동 표시

플러그인 plugin.yaml 선언:

name: my-hermes-plugin
skills:
  - name: writing-plans
    path: skills/writing-plans/SKILL.md
  - name: editing
    path: skills/editing/SKILL.md

10. 스킬 작성 고급 기법(엔지니어 관점)

10.1 description이 활성화 정확도를 결정

❌ 모호: Helps with code. → ✅ 명확: Use when reviewing a pull request... Do NOT use for writing new code.

10.2 Pitfalls가 품질 분수령점

고품질 Pitfalls에는 구체적 실패 패턴, 근본 원인, 실행 가능한 수정 단계가 포함됩니다——CSS selector 취약성, GitHub API rate limit, 대형 diff 토큰 초과와 chunking 전략 등.

10.3 스크립트화와 skill_manage

Procedure에서 scripts/extract_schema.py를 참조하고, 실패 시 references/manual-extract.md를 로드. Agent는 skill_manage(action='patch'| 'create')로 동적 유지보수 가능. config.yaml에 skills.agent_writes_require_approval: true로 사람 승인 게이트 설정.

10.4 스킬 크기 제어

11. 실전: 기술 블로그 워크플로 Skills 구축

blog-workflow Bundle로 seo-keyword-research, outline-generator, code-example-validator, bilingual-checker, publish-to-platform을 묶습니다:

name: blog-workflow
description: Full tech blog writing workflow.
skills:
  - seo-keyword-research
  - outline-generator
  - code-example-validator
  - bilingual-checker
  - publish-to-platform
instruction: |
  Always research SEO keywords before writing.
  Ensure all code examples are tested and runnable.
  Generate both Chinese and English title options.

커스텀 seo-keyword-research 스킬은 세션 시작 시 한·영 롱테일(「X 사용법」「how to X」「X vs Y」)을 조회해 3–5개 핵심어 + 10–15개 롱테일 매트릭스를 출력하고, 「Agent / 에이전트 / 智能体」 등 플랫폼별 용어 차이를 반영해야 합니다.

12. 자주 묻는 질문 FAQ

Q: Skills와 MCP의 차이는?
Skills는 절차적 지식 문서, MCP는 도구 인터페이스. MCP가 DB 접근을 주면 Skill은 마이그레이션 실행법을 가르칩니다——상호 보완.

Q: Skill을 수정했는데 Agent가 구버전을 쓰나요?
/reset으로 새 세션을 열거나 설치 시 --now(Prompt Cache 무효화 주의).

Q: GEPA로 진화한 스킬은 안전한가요?
네 가지 가드레일 + PR 사람 검토; 의미 드리프트 감지로 원래 목적 이탈 방지. diff는 여전히 review 권장.

Q: Claude Code에서 Hermes Skills를 재사용하려면?
~/.claude/skills/에 복사하거나 kevinnft/ai-agent-skills 멀티 플랫폼 설치 스크립트 사용.

Q: Skill 한국어/중국어 내용이 토큰 효율에 영향을 주나요?
한·중 1자 ≈ 1–1.5 token으로 영어와 비슷. 다만 description은 영어(또는 영·한 병기)를 권장——LLM 매칭 정확도가 더 높습니다.

13. 추가 자료와 원격 Mac 7×24 결정

13.1 공식·커뮤니티 자료

• Hermes Agent 공식 문서 · 중문 문서
• Skills System 전체 참조 · agentskills.io 오픈 표준
• GEPA 자기 진화 도구 · GEPA 알고리즘 · DSPy 프레임워크
• 사이트 상호 링크:《Cursor Agent Skill 완전 가이드》《OpenRouter CLI·Hermes 선정》

13.2 배포 시나리오 결정 매트릭스

13.3 요약: 로컬 실험에서 프로덕션 Agent 노드로

본문은 Hermes Skills 고급 전체 체인을 다뤘습니다: 개념 비교 → SKILL.md·Progressive Disclosure → Skill Bundles → 조건부 활성화 → Hub 생태계 → Tap 배포 → GEPA 자기 진화 → Plugin 확장 → 작성 기법 → 블로그 워크플로 실전. 이 체계를 익히면 Agent가 「일회성 Prompt 소모품」에서버전 관리·공유·자기 개선 가능한 절차 자산으로 승격합니다.

그러나 로컬 Hermes에는 명확한 한계가 있습니다: 노트북 덮개 = 연결 단절, GEPA sessiondb 궤적 수집 불완전, Telegram Gateway 절전 오프라인, 팀 Tap이 개발자마다 버전 드리프트. 7×24 상시 온라인으로 진화 궤적을 모으고 Gateway를 호스팅하거나 ~/.hermes/skills/를 통일 동기화하려면 Apple Silicon 원격 Mac이 더 안정적입니다——네이티브 launchd, macOS 동형 툴체인, SFTP/rsync로 스킬 디렉터리를 안전 동기화.

SFTPMAC 원격 Mac 임대는 Hermes Agent Skills 워크플로에 맞춰 설계됐습니다: 7×24 Gateway, GEPA 궤적 지속 수집, 팀 Tap 디렉터리 동기화——「집 Mac 겸 Agent 호스트」보다 Skills 체계를 프로덕션 진입점으로 두기에 적합합니다. 첫 SKILL.md를 쓰는 오늘부터 Agent를 쓸수록 강해지게 만드세요.