본문으로 건너뛰기

“스킬이 트리거됐다”는 말은 정확히 무슨 뜻일까?

Giacomo

2026.08.12

Hermes에서 한 줄 요청이 상위 스킬에서 자식 스킬 본문 로드로 이어지는 과정을 추적해봤습니다

“발표자료를 지아코모 스튜디오 제작 흐름으로 만들어줘.”

이 요청을 재현하면서 두 대상 스킬 가운데 먼저 skill_view(name='giacomo-studio')로 상위 스킬을 열었습니다. 본문의 라우팅 규칙에는 PPT/덱/발표자료/장표 → ppt-factory가 적혀 있었습니다. 그 규칙을 확인한 뒤 별도의 다음 호출로 skill_view(name='ppt-factory')를 실행해 덱 제작 절차를 열었습니다. 첫 호출 턴에는 관련 설계 스킬 조회와 세션 검색도 함께 있었으므로, 이 기록은 두 대상 스킬 사이의 상대적 호출 순서만 증명합니다.

이번 기록은 상위 본문이 반환된 뒤 자식 스킬을 따로 연 순차 기록입니다. 그래서 giacomo-studio → ppt-factory가 실제 호출 순서로 남았다고 말할 수 있습니다. 다만 이 기록은 모델 내부의 선택 이유까지 직접 계측한 것이 아니며, 런타임이 관계 정보를 읽어 자동 실행했다고도 말할 수 없습니다. 관찰된 사실은 상위 본문 반환 뒤 다음 턴에 자식 skill_view가 호출됐다는 것까지입니다.

처음에는 routes_to나 related_skills 같은 관계 정보가 자식 스킬을 자동 실행해주는 것 아닐까 생각했습니다. 하지만 Hermes 공식 문서와 공식 저장소, 현재 설치된 스킬을 함께 대조하니 실제 구조는 달랐습니다.

목록의 짧은 설명이 첫 문을 찾고, `skill_view`가 실제 문을 열며, 로드된 본문이 다음 행동을 안내합니다. 관계 메타데이터는 지도이지, 자식 스킬을 자동으로 움직이는 엔진은 아니었습니다.

조금 더 정확하게 줄이면 이렇습니다.

발견은 `description` 최대 60자, 모델 주도 A→B 전달의 실행 증거는 명시적인 `skill_view(name='B')` 호출, 관계 메타데이터는 지도일 뿐 엔진이 아니다.


먼저 설계상 전체 흐름부터 그려봤습니다

아래는 상위 스킬 본문의 전달 계약을 따라갈 때의 전체 구조입니다. 이번에 관찰한 giacomo-studio → ppt-factory 순차 호출은 이 구조의 가운데 구간을 실제로 보여줍니다.

사용자의 자연어 요청
        ↓ 의미상 비교
스킬 이름 + 축약된 description
        ↓ skill_view(parent)
상위 SKILL.md 전체 본문
        ↓ 조건 판정과 명시적 지시
skill_view(child)
        ↓ 자식 스킬의 절차와 검증 계약
브라우저·웹·파일·터미널·서브에이전트 실행
        ↓
실제 산출물과 확인 결과

여기에는 서로 다른 네 층이 있습니다.

  1. 최초 발견: 어떤 스킬이 요청과 관련 있는지 찾는 단계
  2. 본문 로드: 선택한 스킬의 전체 지침을 여는 단계
  3. 자식 스킬 전달: 상위 스킬이 작업 유형을 판정해 더 구체적인 스킬을 여는 단계
  4. 실제 실행: 로드된 절차에 따라 도구를 호출하고 결과를 검증하는 단계

이 네 층을 한꺼번에 “자동 트리거”라고 부르면, 어디까지가 코드이고 어디부터가 모델의 판단인지 흐려집니다.


1. 처음부터 모든 스킬 본문을 읽는 것은 아니었습니다

Hermes 공식 문서는 스킬 로딩을 점진적 공개 구조로 설명합니다.[1]

Level 0: skills_list()          → 이름, 설명, 카테고리
Level 1: skill_view(name)       → SKILL.md 전체 본문과 메타데이터
Level 2: skill_view(name, file_path) → 필요한 참고 파일 하나

처음에는 전체 SKILL.md가 아니라 스킬 이름과 짧은 설명만 보입니다. 실제로 필요한 스킬이라고 판단된 뒤에야 skill_view로 전체 본문을 엽니다.

공식 저장소의 skill_utils.py를 확인해보니 시스템 프롬프트에 노출되는 설명의 상한은 60자였습니다. 설명이 더 길면 앞 57자에 `...`를 붙여 총 60자로 만듭니다.[2]

현재 설치본에서 실제 프롬프트 출력을 확인한 결과도 같았습니다.

giacomo-studio
Trigger: The catalog and router for Giacomo's content fac...

ppt-factory
Trigger: designing or building PowerPoint decks: 발표자료, 슬라...

두 설명 모두 정확히 60자로 보였습니다.

이 실측이 중요한 이유가 있습니다. 스킬 설명을 길고 정교하게 써도, 최초 선택 순간에는 뒷부분이 보이지 않을 수 있기 때문입니다. 적용 조건을 설명 끝에 숨겨두면 모델이 첫 문을 찾기 어렵습니다.

그래서 좋은 설명은 앞부분만 읽어도 용도가 드러나야 합니다.

# 약한 예시
 description: 여러 상황에서 활용할 수 있는 통합형 고급 작업 지원 스킬...

# 강한 예시
 description: Trigger: PPT/덱/발표자료 제작이 필요할 때 사용...

여기서 Trigger:는 Hermes가 특별히 해석하는 예약 키워드라기보다, 짧은 설명 안에서 적용 조건을 또렷하게 보여주는 자연어 표지판에 가깝습니다.

최초 선택은 “Trigger:라는 문자열이 있으면 실행한다”는 정규식이 아니라, 시스템 프롬프트에 보이는 이름과 설명을 모델이 요청과 의미상 비교하는 과정입니다. 현재 Hermes 프롬프트에는 관련 스킬을 찾으면 skill_view(name)로 로드하라는 지시가 함께 들어갑니다.[3]

즉, 이 단계는 코드가 설명을 노출하는 부분과 모델이 의미를 판단하는 부분이 결합되어 있습니다.


2. 지아코모 스튜디오에서 PPT Factory로 넘긴 실제 순서

이번에는 두 대상 스킬을 동시에 열지 않았습니다. 두 대상 가운데 giacomo-studio를 먼저 열어 라우팅 규칙을 읽고, 그 안에서 발표자료의 제작 라인이 ppt-factory임을 확인한 뒤 다음 호출을 보냈습니다. 같은 첫 턴의 다른 보조 조회는 이 상대적 순서 주장에 포함하지 않았습니다.

실제 기록: 상위 본문을 읽은 뒤 자식을 별도로 로드했습니다

발표자료 제작 요청
→ skill_view(giacomo-studio)
→ 본문에서 “PPT/덱/발표자료/장표 → ppt-factory” 확인
→ skill_view(ppt-factory)
→ PPT Factory의 제작·검증 계약 확인

이 순서에는 skill_view(A) 다음에 별도의 skill_view(B)가 남았습니다. 그래서 이번 관찰 범위에서는 “상위 본문을 읽은 뒤 자식 스킬을 열었다”는 호출 순서를 확인할 수 있습니다.

다만 인과의 범위는 여기까지입니다. related_skills에 두 이름이 연결돼 있다는 이유만으로 런타임이 B를 자동 실행한 것은 아닙니다. 상위 본문의 자연어 규칙을 모델이 읽고 다음 도구 호출을 선택했습니다.

상위 스킬: 매체와 제작 라인을 고르는 스튜디오

giacomo-studio는 영상·덱·웹 같은 여러 매체를 한곳에서 분류하는 상위 라우터입니다. 본문은 “이 스킬은 지도와 라우터이고, 실제 작업은 구성 스킬에서 일어난다”고 경계를 정합니다.

발표자료 요청에 해당하는 규칙은 다음처럼 좁혀졌습니다.

요청 매체 판정
→ PPT / 덱 / 발표자료 / 장표
→ ppt-factory

즉, 상위 스킬은 모든 슬라이드 제작법을 품는 거대한 매뉴얼이 아니라 어떤 제작 라인이 이 일을 소유하는지 정하는 안내 데스크였습니다.

자식 스킬: 덱을 실제 산출물로 만드는 제작 라인

ppt-factory를 열자 상위 스킬에는 없던 구체적인 제작 계약이 나왔습니다.

  • 원문을 의미 단위로 나누고 한 슬라이드에 한 메시지를 배치하기
  • outline.md로 페이지 분배를 먼저 검토하기
  • build_<deck>.py와 pptx_kit로 재현 가능한 덱 만들기
  • .pptx를 PDF로 렌더해 시각적으로 확인하기
  • 결정론적 린트, 렌더 글리프 검사, 사람의 눈 검토를 서로 다른 판정으로 남기기
  • 기술 검증 통과와 미감 승인·공개 승인을 분리하기

지아코모 스튜디오가 어느 제작 라인으로 갈지 정했다면, PPT Factory는 그 라인에서 어떤 파일을 만들고 무엇으로 검증할지 정했습니다.

세 번째 층: 실제 제작 도구

자식 스킬을 연 것만으로 덱이 생기지는 않습니다. 실제 제작에서는 pptx_kit을 쓰는 빌드 스크립트, PowerPoint 파일, PDF 렌더, 린트 결과와 시각 검토가 뒤따라야 합니다.

이번 재현에서는 라우팅과 본문 로드까지만 실행했습니다. 실제 덱 제작 요청이 아니었으므로 .pptx와 PDF를 새로 만들지는 않았습니다. 따라서 상위→자식 순차 로드는 확인함, 덱 산출물 생성은 이번 재현에서 시험 안 함으로 경계를 나눴습니다.


3. 관계 정보가 자식 스킬을 자동으로 부른 것은 아니었습니다

상위 스킬의 머리말과 본문에는 관계 정보와 라우팅 규칙이 있었습니다.

related_skills:
  - ppt-factory

routing rule in SKILL.md:
  "PPT/덱/발표자료/장표" → ppt-factory

겉으로 보면 related_skills나 화살표로 적힌 라우팅 규칙이 실행 명령처럼 느껴집니다. 하지만 공식 main의 Python 소스를 조사한 범위에서는 frontmatter.triggers나 metadata.hermes.routing을 읽어 자식 스킬을 자동 로드하는 소비 경로를 찾지 못했습니다.

related_skills는 실제로 사용되지만 용도가 달랐습니다. skill_view 결과에 관련 스킬을 표시하거나, 학습 그래프에서 스킬 사이의 연결선을 만드는 데 쓰입니다.[4][5] 관계를 탐색하고 설명하는 데는 유용하지만, 그 필드만으로 skill_view(child)가 실행되지는 않았습니다.

그래서 세 요소를 이렇게 구분하는 편이 정확했습니다.

related_skills

공식 Hermes가 skill_view 결과 표시와 학습 그래프에 사용하는 관계 정보

routes_to, depends_on, chains_with

이번 조사에서 공식 런타임의 자동 소비 경로가 확인되지 않은 로컬 문서·분류 관례

상위 SKILL.md의 조건과 전달 지시

모델이 따라야 할 자연어 교통 규칙

skill_view(name='child') 호출

자식 스킬의 본문을 실제로 여는 행동

가장 기억하기 쉬운 비유는 이것이었습니다.

관계 메타데이터는 지도이고, `skill_view` 호출은 문손잡이를 실제로 돌리는 행동이다.

지도에 A와 B가 연결되어 있다고 표시돼 있어도 문이 저절로 열리지는 않습니다.


4. 그렇다면 A에서 B로 넘길 때 무엇을 써야 할까?

상위 스킬에 “필요하면 B를 참고하세요”라고만 쓰면 모델이 참고 이름으로만 받아들일 수 있습니다. route to B, handoff to B, use B도 의도는 보이지만 실제 로드 행동이 생략될 여지가 있습니다.

현재 구조에서 실행 행동을 가장 명시적으로 적는 방법은 조건과 도구 호출을 함께 쓰는 것입니다.

If <조건>, you MUST call `skill_view(name='<B 스킬>')`
before proceeding, then follow the loaded skill's instructions.

필수 선행 단계라면 실패 처리까지 붙일 수 있습니다.

Do not continue until <B 스킬> has been loaded successfully.
If loading fails, stop and report that the child skill could not be loaded.

다만 이것도 Hermes의 숨은 예약 문법은 아닙니다. 모델이 명확한 본문 지시를 지키도록 만드는 강한 실행 계약입니다. 모델 판단을 거치므로 결정론적 오토로더라고 부르면 안 됩니다.

강도를 비교하면 다음과 같습니다.

related_skills: [B]

  • 기대 효과: 관계 표시와 탐색
  • 한계: 자동 로드 보장 없음

route to B

  • 기대 효과: 전달 의도 표현
  • 한계: 도구 호출이 생략될 수 있음

MUST call skill_view(name='B')

  • 기대 효과: 실제 로드 행동을 가장 명확히 요구
  • 한계: 여전히 모델의 지시 준수 방식

사용자가 /B ... 입력

  • 기대 효과: 런타임이 B 본문을 직접 로드
  • 한계: 어떤 결과를 만들지는 이후 모델·도구 실행에 달림

반복해서 반드시 함께 써야 하는 조합이라면, 자연어 라우팅에만 맡기기보다 직접 호출이나 스킬 번들을 고려하는 편이 낫습니다.


5. /스킬명 직접 호출은 자연어 발견과 다른 길이었습니다

Hermes 공식 문서에 따르면 설치된 스킬은 /스킬명 형태로 직접 호출할 수 있습니다.[1]

/ppt-factory 이 원고를 발표용 덱으로 만들어줘

공식 소스의 build_skill_invocation_message()는 명령에 해당하는 스킬을 찾고 _load_skill_payload()로 전체 본문을 로드한 뒤, 사용자가 그 스킬을 호출했다는 활성화 문구와 함께 모델에게 전달합니다.[6]

이 경로에서는 모델이 여러 설명 중 첫 스킬을 의미상 선택할 필요가 없습니다. 사용자가 시작점을 직접 지정합니다.

여러 스킬을 맨 앞에 연달아 적는 호출도 지원합니다. 공식 main에서는 최대 5개까지 선행 /스킬명을 읽어 모두 로드합니다.[1][6]

/skill-a /skill-b 실제 요청

따라서 세 가지 시작 방식을 분리할 수 있습니다.

  1. 자연어 발견: 모델이 짧은 설명을 보고 관련 스킬을 선택
  2. 직접 호출: 사용자가 /스킬명으로 시작점을 고정
  3. 묶음 호출: 자주 함께 쓰는 스킬을 여러 개 또는 번들로 로드

직접 호출은 “스킬 본문을 로드했는가”를 더 결정론적으로 만들지만, 작업 성공까지 자동 보장하지는 않습니다. 로드 뒤에 실제 도구 실행과 검증이 남아 있기 때문입니다.


6. 브라우저 요청에 적용해보니 경계가 더 선명해졌습니다

예를 들어 사용자가 “브라우저 상태를 확인해줘”라고 말했다고 해보겠습니다.

먼저 짧은 설명을 보고 browser 스킬을 발견합니다. 전체 본문을 열면 요청 유형에 따라 길이 갈립니다.

  • Hermes 기본 브라우저 도구로 가능한 일반 웹 조작 → 현재 스킬에 머무름
  • 전체 탐색형 품질 점검 → dogfood 또는 browser-ui-qa-router
  • DevTools 성능·네트워크 분석 → browser-testing-with-devtools
  • 외부 브라우저 CLI나 영속 프로필 → agent-browser

다만 현재 browser 본문은 전문 경로의 이름과 route to 의도까지는 적어도, 정확한 skill_view(name='...') 호출문까지 쓰지는 않았습니다. 따라서 아래 흐름은 본문이 더 강한 실행 계약을 갖도록 보완했을 때의 기대 경로입니다.

browser 본문에서 작업 유형 판정
→ 필요한 경우 skill_view(전문 자식 스킬)
→ 자식 스킬 지침에 따라 browser_* 또는 다른 도구 실행

라우터 스킬이 해야 할 일은 모든 브라우저 작업을 직접 흡수하는 것이 아니라, 어디까지 자신이 처리하고 언제 더 좁은 전문가에게 넘길지 명확히 적는 것입니다. 실제 자식 로드까지 요구하려면 경로 이름만 적는 데서 멈추지 않고 정확한 skill_view 행동을 붙이는 편이 낫습니다.


7. 직접 재현하려면 이 네 가지만 확인하면 됩니다

준비

  • 상위 스킬 A와 자식 스킬 B를 설치합니다.
  • A의 설명이 60자를 넘는다면, 잘리기 전 첫 57자 안에 적용 조건이 드러나게 합니다.
  • A 본문에 B를 불러야 하는 조건과 정확한 skill_view 호출을 적습니다.

실행

  1. B가 필요한 자연어 요청을 입력합니다.
  2. 도구 기록에서 skill_view(A)가 호출됐는지 확인합니다.
  3. A 본문을 읽은 뒤 skill_view(B)가 추가 호출됐는지 확인합니다.
  4. B의 절차가 실제 파일·웹·브라우저·터미널 도구 실행으로 이어졌는지 확인합니다.

대조군

같은 요청을 /B ...로 직접 호출해봅니다. 자연어 발견 단계를 건너뛰고 B 전체 본문이 바로 로드되는지 비교할 수 있습니다.

기대 결과

자연어 경로: 요청 → A 발견 → A 로드 → B 로드 → 실행
직접 경로:   /B 요청 → B 로드 → 실행

중단 조건

  • B가 설치되어 있지 않음
  • 같은 이름의 스킬이 여러 개라 충돌함
  • 현재 운영체제에서 지원되지 않음
  • B 로드 여부를 도구 기록으로 확인하지 못함

이때는 성공이라고 쓰지 않고 자식 스킬을 열지 못한 이유나 실제 오류를 남기는 편이 안전합니다. 공식 skill_view 구현도 같은 이름의 후보가 여러 개면 임의 선택하지 않고 충돌을 알리도록 되어 있습니다.[4]


8. 이번 조사에서 정리한 스킬 작성 원칙

설명은 소개문이 아니라 첫 번째 라우팅 표지판으로 쓴다

긴 배경 설명보다 “언제 쓰는가”를 앞에 둡니다. 설명이 길다면 최대 60자만 보인다는 전제로 첫 57자를 설계합니다.

상위 스킬은 얇게 유지한다

상위 스킬은 분류표, 경계, 전달 조건을 맡습니다. 자식의 세부 절차를 모두 복사해 넣지 않습니다.

관계 메타데이터와 실행 계약을 둘 다 쓴다

related_skills는 공식 Hermes의 결과 표시와 학습 그래프에 쓰입니다. routes_to, depends_on, chains_with는 이번 조사 범위에서 공식 런타임 소비가 확인되지 않은 로컬 문서·분류 관례입니다. 어느 경우든 실행이 필요하면 본문에 조건과 skill_view 호출을 별도로 씁니다.

로드와 완료를 분리한다

스킬을 불렀다는 사실은 작업이 끝났다는 증거가 아닙니다. 파일이 생성됐는지, 브라우저에서 결과가 보이는지, 예상한 동작이 실제로 확인되는지 같은 도구 결과가 있어야 완료입니다.

강한 보장이 필요하면 직접 호출을 쓴다

최초 선택까지 모델에게 맡길 이유가 없다면 /스킬명이나 번들로 시작점을 고정합니다.


마치며

조사 전에는 스킬 트리를 “관계가 연결된 폴더 묶음”처럼 생각했습니다. 조사 뒤에는 다르게 보였습니다.

  • description은 멀리서 보이는 짧은 간판입니다.
  • skill_view는 안으로 들어가기 위해 문을 여는 행동입니다.
  • 상위 SKILL.md는 다음 방을 고르는 안내판입니다.
  • 자식 스킬은 구체적인 작업 절차입니다.
  • 브라우저·파일·터미널 같은 도구는 실제로 일을 하는 손입니다.

이 구조를 알고 나니 스킬이 잘 안 불릴 때 무엇부터 봐야 하는지도 선명해졌습니다.

“관계가 연결돼 있나?”만 볼 것이 아니라,

  1. 첫 57자 안에 적용 조건이 보이는지,
  2. 상위 본문이 정확한 자식 로드 행동을 요구하는지,
  3. 실제 기록에 skill_view(child)가 남았는지,
  4. 로드 뒤 도구 실행과 검증까지 이어졌는지

순서대로 확인하면 됩니다.

결국 Hermes의 스킬 라우팅은 마법 같은 한 번의 자동 트리거가 아니었습니다. 짧은 발견 정보, 모델의 의미 판단, 명시적 로드, 실제 도구 실행이 이어지는 작은 연쇄였습니다.


확인 범위와 한계

  • 공식 소스 조사일: 2026-08-12
  • 지아코모 스튜디오 → PPT Factory 순차 호출 재현일: 2026-08-13
  • 로컬 설치 소스와 공식 main 양쪽에서 설명 60자 제한, skill_view, 직접 /스킬명 호출 구조를 대조했습니다.
  • frontmatter.triggers와 metadata.hermes.routing 자동 소비 여부는 확인 당시 공식 main의 Python 소스를 대상으로 살펴봤습니다. 향후 버전이나 별도 플러그인에는 다른 구현이 생길 수 있습니다.
  • 자연어 최초 선택은 모델과 시스템 지시의 영향을 받으므로 같은 문장이 모든 모델에서 항상 같은 스킬을 고른다고 보장하지 않습니다.
  • 본문의 핵심 주장은 공식 소스 직접 읽기, giacomo-studio 다음 ppt-factory를 별도로 연 실제 skill_view 순차 호출, 설치 프롬프트 출력 측정 범위에 한정했습니다.
  • 이번 재현에서는 라우팅과 스킬 본문 로드까지만 확인했고, 새 PPTX·PDF 생성과 렌더 QA는 실행하지 않았습니다.

Sources

[1] Hermes Agent 공식 Skills 문서 https://hermes-agent.nousresearch.com/docs/user-guide/features/skills

[2] Hermes Agent agent/skill_utils.py — 설명 60자 제한 https://github.com/NousResearch/hermes-agent/blob/f51aa6a9b5ce514e15f8e337777f522fd5cc6fa2/agent/skill_utils.py

[3] Hermes Agent agent/prompt_builder.py — 스킬 목록과 로드 지시 https://github.com/NousResearch/hermes-agent/blob/f51aa6a9b5ce514e15f8e337777f522fd5cc6fa2/agent/prompt_builder.py

[4] Hermes Agent tools/skills_tool.py — skill_view, 충돌 확인, 전체 본문 로드 https://github.com/NousResearch/hermes-agent/blob/f51aa6a9b5ce514e15f8e337777f522fd5cc6fa2/tools/skills_tool.py

[5] Hermes Agent agent/learning_graph.py — related_skills 관계 그래프 https://github.com/NousResearch/hermes-agent/blob/f51aa6a9b5ce514e15f8e337777f522fd5cc6fa2/agent/learning_graph.py

[6] Hermes Agent agent/skill_commands.py — 직접 호출과 최대 5개 연속 호출 https://github.com/NousResearch/hermes-agent/blob/f51aa6a9b5ce514e15f8e337777f522fd5cc6fa2/agent/skill_commands.py

함께 이야기해요 0

로그인하고 댓글을 남겨 주세요

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기