SKILL.md 형식 · Skill Bundles · 조건 활성화 · GEPA 자가 진화 · Tap 발행 · agentskills.io
Hermes Agent 설치는 완료했지만 매 세션마다 같은 Prompt를 붙여넣고 계신가요? 2026년 초 Nous Research가 출시한 Hermes는 두 달 만에 GitHub Star 16만을 돌파했습니다. 핵심은 더 큰 모델이 아니라 「the agent that grows with you」입니다. 엔진은 Skills 시스템으로, 표준화·진화 가능·세션 간 지속되는 절차적 메모리를 제공합니다. 본 가이드는 SKILL.md, Progressive Disclosure, Skill Bundles, 조건 활성화, Tap 발행, GEPA + DSPy 자가 진화, 오픈소스 생태를 다루며, 개념 비교표·6단계 Runbook·FAQ를 포함합니다.
일회성 Prompt와 달리 Hermes Skills는 agentskills.io 오픈 표준을 따릅니다. 세션 간 지속되고, 필요 시 로드되며, 커뮤니티 Tap으로 발행할 수 있고, Claude Code·Cursor로 이식 가능합니다. Hermes를 이미 설치하셨다면 설치 가이드와 메모리 아키텍처 글을 참고하세요. 본문은 Skills 계층만 집중합니다.
Prompt를 Skill처럼 사용: 매 세션 전체 주입으로 Token이 선형 증가하며, 절차적 단계를 세션 간 재사용할 수 없습니다.
Memory와 Skill 혼동: Memory는 선호·사실을 저장하고, Skill은 「어떻게 하는지」 SOP를 저장합니다. 로드 시점과 유지 방식이 다릅니다.
description 필드 미흡: Level 0 라우팅은 name + description만 사용합니다. 「무엇인지」만 쓰고 「언제 쓰는지」를 쓰지 않으면 오작동하거나 로드되지 않습니다.
SKILL.md 단일 파일 과적: 500줄 이상 한 파일에 넣으면 GEPA 15KB 상한에 걸리고 Level 1 Token 비용이 커집니다.
불안정한 호스트: Skill 복리는 7×24 가동이 필요합니다. 노트북 슬립은 GEPA용 sessiondb 수집을 끊습니다.
Prompt = 포스트잇. Memory = 공책. Skill = SOP 매뉴얼 — 활성화 전까지 Token 비용은 0입니다.
| 차원 | Prompt | Memory | Skills |
|---|---|---|---|
| 지속성 | 현재 대화 | 세션 간 영구 | 세션 간 영구 |
| 로드 시점 | 항상 컨텍스트에 포함 | 세션마다 자동 주입 | 필요 시 |
| Token 비용 | 매 턴 | 작고 안정적 | 활성화 전 0 |
| 내용 유형 | 임의 의도 | 선호/사실 | 절차적 단계 |
| 유지 주체 | 사용자 수동 | Agent 자동 | 사용자 + Agent |
| 공유 가능 | 어려움 | 비공개 | 커뮤니티 Tap |
frontmatter 필수: name(소문자+하이픈, 최대 64자), description(최대 1024자, 「Use when...」로 시작 권장). 권장: version, license, compatibility, 실험적 allowed-tools. 본문 섹션: Overview, When to Use, Procedure, Common Pitfalls, Verification Checklist.
---
name: my-skill
description: |
Use when the user needs to [...].
Handles [...] and [...].
version: 1.0.0
metadata:
hermes:
requires_toolsets: [terminal]
fallback_for_toolsets: [web]
---
~/.hermes/skills/my-category/my-skill/ 디렉터리: SKILL.md(핵심, 약 500줄 이하), references/(API 문서), templates/, scripts/(Agent 실행 가능).
| Level | 내용 | 트리거 | Token 비용 |
|---|---|---|---|
| Level 0 | name + description | 세션 시작, 모든 Skill | 합계 ~3K |
| Level 1 | SKILL.md 전체 본문 | /skill-name 또는 LLM 매칭 | 파일 길이에 비례 |
| Level 2 | references/ scripts/ | 실행 중 LLM 판단 | 파일당 |
Bundle은 ~/.hermes/skill-bundles/<slug>.yaml의 경량 YAML입니다. /bundle-name 실행 시 나열된 Skill이 한꺼번에 로드됩니다. 동명 Skill보다 Bundle이 우선하며, 없는 Skill은 조용히 건너뜁니다. Bundle은 시스템 Prompt를 바꾸지 않아 Token 친화적입니다.
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.
CLI: hermes bundles create backend-dev --skills github-code-review,test-driven-development,github-pr-workflow. 고급 Bundle 예: research-session(arxiv + deep-research + plan + excalidraw), mlops-deploy(vllm + llama-cpp + github-pr-workflow + systematic-debugging).
metadata.hermes에서 설정합니다. requires_toolsets/tools는 나열된 도구가 없을 때 Skill을 숨깁니다. fallback_for_toolsets/tools는 나열된 도구가 있을 때 숨깁니다(대체 경로). 예: DuckDuckGo 검색 Skill에 fallback_for_tools: [web_search] — FIRECRAWL_KEY 또는 BRAVE_SEARCH_KEY로 paid web_search가 켜지면 DuckDuckGo는 Prompt에서 사라지고, API 장애 시 대체 Skill이 나타납니다.
디렉터리 생성: ~/.hermes/skills/<category>/<skill-name>/에 SKILL.md를 추가하고 「Use when...」 트리거를 명확히 작성합니다.
references 분리: 500줄 초과 시 API 문서를 references/로 이동합니다. GEPA 가드레일을 위해 15KB 이하를 유지해야 합니다.
형식 검증: skills-ref validate ./my-skill로 agentskills.io 준수 여부를 확인합니다.
활성화 테스트: 새 세션에서 /my-skill 또는 description 매칭으로 Level 1 로드와 Procedure 실행을 확인합니다.
Bundle(선택): hermes bundles create <name> --skills a,b,c로 원샷 워크플로를 구성합니다.
Tap 발행: GitHub 저장소 + hermes skills tap add github:your-org/your-skills-tap; 팀은 tap update로 동기화합니다.
hermes skills install official/research/arxiv hermes skills install github:openai/skills/k8s hermes skills tap add github:my-org/my-skills hermes skills tap update hermes skills tap list
| 저장소 | 설명 | 하이라이트 |
|---|---|---|
| ChuckSRQ/awesome-hermes-skills | 엄선 프로덕션 Skill | Deep Research, MLOps, Apple 연동 |
| amanning3390/hermeshub | 커뮤니티 레지스트리 | 보안 스캔, 마켓플레이스, 인젝션 탐지 |
| kevinnft/ai-agent-skills | 191 Skill, 28 카테고리 | Hermes / Claude Code / Cursor 원클릭 설치 |
| NousResearch/hermes-agent | 공식 저장소 | 내장 Skill 및 작성 스펙 |
Tap 저장소는 category 폴더(mlops/, research/)와 선택적 skills.sh.json(Hub 그룹핑)을 사용합니다. 비공개 저장소: hermes skills tap add github:your-org/private-skills --token $GH_TOKEN. ~/.hermes/skills/를 Git으로 버전 관리하고, git pull && hermes skills reset으로 기기 간 동기화합니다.
플러그인은 Skill을 plugin:skill 형식으로 패키징합니다. 기본 skills_list에 숨겨지고, opt-in만 가능하며, 플러그인 내 Skill끼리 상호 참조합니다. skill_view("superpowers:writing-plans")로 로드합니다. plugin.yaml에 경로를 선언합니다.
크로스 플랫폼: 동일 SKILL.md가 Hermes, Claude Code, Cursor, OpenCode에서 동작합니다. ~/.claude/skills/에 복사하거나 kevinnft/ai-agent-skills 설치 스크립트를 사용하세요.
GEPA(Genetic-Pareto Prompt Evolution)는 ICLR 2026 Oral 논문으로 hermes-agent-self-evolution에 통합되었습니다. 파이프라인: 실행 트레이스 수집 → 반성적 실패 분석 → SKILL.md 변체 10–20개 생성 → 다목적 Pareto 평가(성공률 × Token 효율 × 속도) → 최적 변체 PR 생성(사람 검토). 비용은 실행당 약 $2–10, API만 필요하며 GPU는 불필요합니다.
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
python -m evolution.skills.evolve_skill \
--skill github-code-review --iterations 10 --eval-source mixed \
--trace-dirs ~/.claude/traces,~/.hermes/sessions
4가지 가드레일: pytest 전체 통과; Skill ≤15KB, 도구 description ≤500자; Prompt Cache 안전; 의미 보존. 로드맵: Phase 1 Skill 파일(완료) → 도구 description → 시스템 Prompt → 도구 코드 → 완전 자동 루프.
agent_writes_require_approval: true 설정seo-keyword-research, outline-generator, code-example-validator, bilingual-checker, publish-to-platform을 묶습니다. instruction: SEO 조사 우선, 코드 예제 테스트, 이중 언어 제목 생성. seo-keyword-research description은 블로그 기획 대상이며, Procedure는 한·영 롱테일 키워드 매트릭스를 출력합니다.
노트북과 x86 VPS에서 Hermes CLI는 실행 가능하지만 Skill 복리, GEPA sessiondb 수집, macOS 브라우저 Skill에 제약이 있습니다. Skills를 시간이 지날수록 강해지는 프로덕션 자산으로 다루는 팀에게 Mac Mini M4 클라우드 렌탈은 7×24 uptime, UMA, launchd를 예측 가능한 OpEx로 묶어줍니다.
Skills 스택이 준비되었고 프로덕션 호스트가 필요하다면 VpsMesh Mac Mini M4 클라우드 렌탈(SSH 전달, ~/.hermes/ 전체 백업)을 이용하실 수 있습니다. 요금은 Mac Mini M4 대여 가격, 문의는 고객 센터, 주문은 주문 페이지에서 확인하세요.
Skills는 절차적 문서이고 MCP는 도구 인터페이스입니다. 상호 보완적입니다. MCP가 DB 접근을 주면 Skill은 올바른 마이그레이션 절차를 가르칩니다. MCP Server 처음부터 개발 가이드를 참고하세요.
수정은 현재 세션에 적용되지 않습니다. /reset을 실행하거나 --now로 설치하세요(Prompt Cache 무효화, Token 비용 증가).
4가지 가드레일: 전체 테스트 통과, 15KB 상한, Prompt Cache 안전, 의미 검사. 최적 변체는 PR을 열고 병합 전 사람 검토가 필요합니다.
SKILL.md를 ~/.claude/skills/ 또는 Cursor skills 디렉터리에 복사하거나 kevinnft/ai-agent-skills를 사용하세요. agentskills.io가 형식을 통일합니다.
API 전용 CLI는 x86 VPS로 가능합니다. GEPA sessiondb, macOS 브라우저 Skill, Tap Git 동기화가 필요하면 Mac Mini M4 렌탈이 더 안정적입니다. Mac Mini M4 대여 가격을 참고하세요.