기술 작업
스킬은 Hermes에게 ASCII 아트 생성부터 GitHub PR 관리에 이르기까지 특정 작업을 처리하는 방법을 알려주는 주문형 지식 문서입니다. 이 가이드에서는 일상적인 사용 방법을 안내합니다.
전체 기술 참조는 스킬 시스템을 참조하세요.
기술 찾기
모든 Hermes 설치에는 번들 스킬이 함께 제공됩니다. 사용 가능한 항목을 확인하세요.
# In any chat session:
/skills
# Or from the CLI:
hermes skills list
이름과 설명이 포함된 간략한 목록이 표시됩니다.
ascii-art Generate ASCII art using pyfiglet, cowsay, boxes...
arxiv Search and retrieve academic papers from arXiv...
github-pr-workflow Full PR lifecycle — create branches, commit...
plan Plan mode — inspect context, write a markdown...
excalidraw Create hand-drawn style diagrams using Excalidraw...
스킬 검색
# Search by keyword
/skills search docker
/skills search music
스킬 허브
공식 옵션 기술(기본적으로 활성화되지 않은 더 무거운 기술 또는 틈새 기술)은 허브를 통해 사용할 수 있습니다.
# Browse official optional skills
/skills browse
# Search the hub
/skills search blockchain
스킬 사용
설치된 모든 스킬은 자동으로 슬래시 명령입니다. 이름을 입력하세요.
# Load a skill and give it a task
/ascii-art Make a banner that says "HELLO WORLD"
/plan Design a REST API for a todo app
/github-pr-workflow Create a PR for the auth refactor
# Just the skill name (no task) loads it and lets you describe what you need
/excalidraw
자연스러운 대화를 통해 스킬을 발동시킬 수도 있습니다. Hermes에게 특정 스킬을 사용하도록 요청하면 skill_view 도구를 통해 해당 스킬이 로드됩니다.
점진적 공개
스킬은 토큰 효율적인 로딩 패턴을 사용합니다. 에이전트는 모든 것을 한 번에 로드하지 않습니다.
skills_list()— 모든 스킬의 간략한 목록(~3,000개 토큰). 세션 시작 시 로드됩니다.skill_view(name)— 하나의 스킬에 대한 전체 SKILL.md 콘텐츠입니다. 에이전트가 해당 스킬이 필요하다고 판단하면 로드됩니다.skill_view(name, file_path)— 스킬 내의 특정 참조 파일입니다. 필요한 경우에만 로드됩니다.
이는 스킬이 실제로 사용될 때까지 토큰 비용이 들지 않는다는 것을 의미합니다.
허브에서 설치
공식 옵션 스킬은 Hermes와 함께 제공되지만 기본적으로 활성화되지 않습니다. 명시적으로 설치합니다.
# Install an official optional skill
hermes skills install official/research/arxiv
# Install from the hub in a chat session
/skills install official/creative/songwriting-and-ai-music
# Install a single-file SKILL.md directly from any HTTP(S) URL
hermes skills install https://sharethis.chat/SKILL.md
/skills install https://example.com/SKILL.md --name my-skill
무슨 일이 일어나는지:
- 스킬 디렉터리가
~/.hermes/skills/에 복사됩니다. skills_list출력에 나타납니다.- 슬래시 명령으로 사용할 수 있게 됩니다.
설치된 스킬은 새 세션에 적용됩니다. 현재 세션에서 사용하려면 /reset을 사용하여 새로 시작하거나 --now을 추가하여 프롬프트 캐시를 즉시 무효화하세요(다음 차례에 더 많은 토큰이 필요함).
설치 확인 중
# Check it's there
hermes skills list | grep arxiv
# Or in chat
/skills search arxiv
플러그인 제공 스킬
플러그인은 네임스페이스 이름(plugin:skill)을 사용하여 자체 스킬을 묶을 수 있습니다. 이렇게 하면 내장된 스킬과 이름이 충돌하는 것을 방지할 수 있습니다.
# Load a plugin skill by its qualified name
skill_view("superpowers:writing-plans")
# Built-in skill with the same base name is unaffected
skill_view("writing-plans")
플러그인 스킬은 시스템 프롬프트에 나열되지 않으며 skills_list에 표시되지 않습니다. 선택적으로 제공됩니다. 플러그인이 제공하는 것을 알고 있으면 명시적으로 로드하세요. 로드되면 에이전트는 동일한 플러그인의 형제 스킬을 나열하는 배너를 봅니다.
자신의 플러그인으로 스킬을 배송하는 방법은 Hermes 플러그인 빌드 → 스킬 번들을 참조하세요.
스킬 설정 구성
일부 스킬은 머리말에 필요한 구성을 선언합니다.
metadata:
hermes:
config:
- key: tenor.api_key
description: "Tenor API key for GIF search"
prompt: "Enter your Tenor API key"
url: "https://developers.google.com/tenor/guides/quickstart"
구성이 포함된 스킬이 처음 로드되면 Hermes는 값을 묻는 메시지를 표시합니다. skills.config.* 아래의 config.yaml에 저장되어 있습니다.
CLI에서 기술 구성을 관리합니다.
# Interactive config for a specific skill
hermes skills config gif-search
# View all skill config
hermes config get skills.config
나만의 스킬 만들기
스킬은 YAML 머리말이 포함된 마크다운 파일일 뿐입니다. 하나를 만드는 데는 5분도 채 걸리지 않습니다.
1. 디렉토리 생성
mkdir -p ~/.hermes/skills/my-category/my-skill
2. SKILL.md 작성
---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
metadata:
hermes:
tags: [my-tag, automation]
category: my-category
---
# My Skill
## When to Use
Use this skill when the user asks about [specific topic] or needs to [specific task].
## Procedure
1. First, check if [prerequisite] is available
2. Run `command --with-flags`
3. Parse the output and present results
## Pitfalls
- Common failure: [description]. Fix: [solution]
- Watch out for [edge case]
## Verification
Run `check-command` to confirm the result is correct.
3. 참조 파일 추가(선택 사항)
스킬에는 에이전트가 요청 시 로드하는 지원 파일이 포함될 수 있습니다.
my-skill/
├── SKILL.md # Main skill document
├── references/
│ ├── api-docs.md # API reference the agent can consult
│ └── examples.md # Example inputs/outputs
├── templates/
│ └── config.yaml # Template files the agent can use
└── scripts/
└── setup.sh # Scripts the agent can execute
SKILL.md에서 다음을 참조하세요.
For API details, load the reference: `skill_view("my-skill", "references/api-docs.md")``
### 4. 테스트해 보세요 \{#4-test-it}
새 세션을 시작하고 기술을 시험해보세요.
```bash
hermes chat -q "/my-skill help me with the thing"
스킬이 자동으로 표시되므로 등록이 필요하지 않습니다. ~/.hermes/skills/에 넣으면 활성화됩니다.
에이전트는 skill_manage을 사용하여 스킬 자체를 생성하고 업데이트할 수도 있습니다. 복잡한 문제를 해결한 후 Hermes는 다음 번에 기술로 접근 방식을 저장하겠다고 제안할 수 있습니다.
플랫폼별 스킬 관리
어떤 플랫폼에서 어떤 기술을 사용할 수 있는지 제어합니다.
hermes skills
그러면 플랫폼(CLI, Telegram, Discord 등)별로 기술을 활성화하거나 비활성화할 수 있는 대화형 TUI가 열립니다. 특정 상황에서만 사용할 수 있는 특정 기술을 원할 때 유용합니다(예: 텔레그램에서 개발 기술을 유지하는 것).
기술 대 기억력
둘 다 세션 전반에 걸쳐 지속되지만 서로 다른 목적으로 사용됩니다.
| 기술 | 메모리 | |
|---|---|---|
| 뭐야 | 절차적 지식 - 일을 수행하는 방법 | 사실적 지식 - 사물이 무엇인지 |
| 언제 | 요청 시 로드됨(해당되는 경우에만) | 모든 세션에 자동으로 주입 |
| 크기 | 클 수 있음(수백 줄) | 간결해야 합니다(핵심 사실만). |
| 비용 | 로드될 때까지 토큰이 0입니다. | 작지만 일정한 토큰 비용 |
| 예 | "Kubernetes에 배포하는 방법" | "사용자는 어두운 모드를 선호하며 PST에 거주합니다." |
| 만드는 사람 | 귀하, 에이전트 또는 Hub에서 설치됨 | 대화를 기반으로 하는 에이전트 |
경험 법칙: 참조 문서에 넣으면 기술입니다. 메모지에 붙이면 추억이 됩니다.
팁
기술에 집중하세요. "모든 DevOps"를 다루려는 기술은 너무 길고 너무 모호합니다. "Fly.io에 Python 앱 배포"를 다루는 기술은 실제로 유용할 만큼 구체적입니다.
에이전트가 스킬을 생성하도록 합니다. 복잡한 다단계 작업 후에 Hermes는 종종 접근 방식을 스킬로 저장하겠다고 제안합니다. 예라고 대답하세요. 에이전트가 작성한 이러한 기술은 도중에 발견된 함정을 포함하여 정확한 워크플로를 포착합니다.
카테고리를 사용하세요. 스킬을 하위 디렉터리(~/.hermes/skills/devops/, ~/.hermes/skills/research/ 등)로 구성합니다. 이렇게 하면 목록을 관리하기 쉽게 유지하고 상담원이 관련 기술을 더 빨리 찾을 수 있습니다.
오래된 스킬을 업데이트하세요. 스킬을 사용하고 해당 스킬에서 다루지 않는 문제가 발생한 경우 Hermes에 배운 내용으로 스킬을 업데이트하라고 지시하세요. 유지되지 않는 기술은 부채가 됩니다.
전체 기술 참조(머리말 필드, 조건부 활성화, 외부 디렉터리 등)는 기술 시스템을 참조하세요.