Làm việc bằng kỹ năng

Kỹ năng là tài liệu kiến ​​thức theo yêu cầu dạy Hermes cách xử lý các nhiệm vụ cụ thể — từ tạo tác phẩm nghệ thuật ASCII đến quản lý PR GitHub. Hướng dẫn này sẽ hướng dẫn bạn cách sử dụng chúng hàng ngày.

Để có tài liệu tham khảo kỹ thuật đầy đủ, hãy xem Hệ thống kỹ năng.

---

Tìm kiếm kỹ năng

Mỗi bản cài đặt của Hermes đều đi kèm với các kỹ năng đi kèm. Xem những gì có sẵn:

# In any chat session:
/skills

# Or from the CLI:
hermes skills list

Điều này hiển thị một danh sách nhỏ gọn với tên và mô tả:

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...

Tìm kiếm kỹ năng

# Search by keyword
/skills search docker
/skills search music

Trung tâm kỹ năng

Các kỹ năng tùy chọn chính thức (kỹ năng nặng hơn hoặc thích hợp không được kích hoạt theo mặc định) có sẵn thông qua Hub:

# Browse official optional skills
/skills browse

# Search the hub
/skills search blockchain

---

Sử dụng kỹ năng

Mọi kỹ năng được cài đặt đều tự động là lệnh gạch chéo. Chỉ cần gõ tên của nó:

# 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

Bạn cũng có thể kích hoạt các kỹ năng thông qua cuộc trò chuyện tự nhiên — yêu cầu Hermes sử dụng một kỹ năng cụ thể và nó sẽ tải kỹ năng đó thông qua công cụ skill_view.

Tiết lộ dần dần

Kỹ năng sử dụng kiểu tải mã thông báo hiệu quả. Tác nhân không tải mọi thứ cùng một lúc:

1. skills_list() — danh sách rút gọn tất cả các kỹ năng (~3k token). Được tải khi bắt đầu phiên.
2. skill_view(name) — nội dung SKILL.md đầy đủ cho một kỹ năng. Được tải khi tác nhân quyết định nó cần kỹ năng đó.
3. skill_view(name, file_path) — một tệp tham chiếu cụ thể trong kỹ năng. Chỉ tải nếu cần thiết.

Điều này có nghĩa là các kỹ năng không tốn token cho đến khi chúng thực sự được sử dụng.

---

Cài đặt từ Hub

Các kỹ năng tùy chọn chính thức được cung cấp cùng với Hermes nhưng không hoạt động theo mặc định. Cài đặt chúng một cách rõ ràng:

# 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

Điều gì xảy ra:

1. Thư mục kỹ năng được sao chép vào ~/.hermes/skills/
2. Nó xuất hiện trong đầu ra skills_list của bạn
3. Nó có sẵn dưới dạng lệnh gạch chéo

mẹo

Các kỹ năng đã cài đặt sẽ có hiệu lực trong phiên mới. Nếu bạn muốn nó có sẵn trong phiên hiện tại, hãy sử dụng /reset để bắt đầu làm mới hoặc thêm --now để vô hiệu hóa bộ nhớ đệm nhắc nhở ngay lập tức (tốn nhiều mã thông báo hơn ở lượt tiếp theo).

Đang xác minh cài đặt

# Check it's there
hermes skills list | grep arxiv

# Or in chat
/skills search arxiv

---

Định cấu hình cài đặt kỹ năng

Một số kỹ năng khai báo cấu hình họ cần trong phần trước của họ:

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"

Khi một kỹ năng có cấu hình được tải lần đầu tiên, Hermes sẽ nhắc bạn về các giá trị. Chúng được lưu trữ trong config.yaml bên dưới skills.config.*.

Quản lý cấu hình kỹ năng từ CLI:

# Interactive config for a specific skill
hermes skills config gif-search

# View all skill config
hermes config get skills.config

---

Tạo kỹ năng của riêng bạn

Các kỹ năng chỉ là các tệp đánh dấu với YAML frontmatter. Việc tạo một cái chỉ mất chưa đầy năm phút.

1. Tạo thư mục

mkdir -p ~/.hermes/skills/my-category/my-skill

2. Viết SKILL.md

~/.hermes/skills/my-category/my-skill/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. Thêm file tham khảo (Tùy chọn)

Các kỹ năng có thể bao gồm các tệp hỗ trợ mà tác nhân tải theo yêu cầu:

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

Tham khảo những điều này trong SKILL.md của bạn:

For API details, load the reference: `skill_view("my-skill", "references/api-docs.md")`

4. Kiểm tra nó

Bắt đầu một phiên mới và thử kỹ năng của bạn:

hermes chat -q "/my-skill help me with the thing"

Kỹ năng này tự động xuất hiện - không cần đăng ký. Thả nó vào ~/.hermes/skills/ và nó sẽ hoạt động.

thông tin

Tác nhân cũng có thể tự tạo và cập nhật các kỹ năng bằng cách sử dụng skill_manage. Sau khi giải quyết một vấn đề phức tạp, Hermes có thể đề nghị lưu lại cách tiếp cận này như một kỹ năng cho lần tiếp theo.

---

Quản lý kỹ năng trên mỗi nền tảng

Kiểm soát những kỹ năng có sẵn trên nền tảng nào:

hermes skills

Điều này sẽ mở ra một TUI tương tác nơi bạn có thể bật hoặc tắt các kỹ năng trên mỗi nền tảng (CLI, Telegram, Discord, v.v.). Hữu ích khi bạn muốn một số kỹ năng nhất định chỉ khả dụng trong các ngữ cảnh cụ thể - ví dụ: tắt các kỹ năng phát triển trên Telegram.

---

Kỹ năng vs Trí nhớ

Cả hai đều liên tục trong các phiên, nhưng chúng phục vụ các mục đích khác nhau:

	Kỹ năng	Ký ức
Cái gì	Kiến thức về thủ tục - cách thực hiện	Kiến thức thực tế - sự vật là gì
Khi	Được tải theo yêu cầu, chỉ khi phù hợp	Tự động được đưa vào mỗi phiên
Kích thước	Có thể lớn (hàng trăm dòng)	Nên nhỏ gọn (chỉ những thông tin chính)
Chi phí	Không có mã thông báo nào cho đến khi được tải	Chi phí mã thông báo nhỏ nhưng không đổi
Ví dụ	"Cách triển khai lên Kubernetes"	"Người dùng thích chế độ tối, sống ở PST"
Ai tạo ra	Bạn, đại lý hoặc cài đặt từ Hub	Người đại diện, dựa trên các cuộc trò chuyện

Quy tắc chung: Nếu bạn đưa nó vào tài liệu tham khảo thì đó là một kỹ năng. Nếu bạn ghi nó vào một tờ giấy nhớ thì đó là ký ức.

---

Mẹo

Giữ các kỹ năng tập trung. Một kỹ năng cố gắng bao quát "tất cả DevOps" sẽ quá dài và quá mơ hồ. Kỹ năng bao gồm "triển khai ứng dụng Python lên Fly.io" đủ cụ thể để thực sự hữu ích.

Hãy để đặc vụ tạo ra các kỹ năng. Sau một nhiệm vụ gồm nhiều bước phức tạp, Hermes thường đề nghị lưu cách tiếp cận làm kỹ năng. Nói có - những kỹ năng do tác nhân tạo này nắm bắt chính xác quy trình làm việc, bao gồm cả những cạm bẫy được phát hiện trong quá trình thực hiện.

Sử dụng các danh mục. Sắp xếp các kỹ năng vào các thư mục con (~/.hermes/skills/devops/, ~/.hermes/skills/research/, v.v.). Điều này giúp quản lý danh sách và giúp tổng đài viên tìm thấy các kỹ năng liên quan nhanh hơn.

Cập nhật các kỹ năng khi chúng cũ. Nếu bạn sử dụng một kỹ năng và gặp phải các vấn đề không được đề cập trong kỹ năng đó, hãy yêu cầu Hermes cập nhật kỹ năng đó với những gì bạn đã học được. Những kỹ năng không được duy trì sẽ trở thành trách nhiệm pháp lý.

---

Để có tài liệu tham khảo đầy đủ về kỹ năng — các trường quan trọng trước, kích hoạt có điều kiện, thư mục bên ngoài, v.v. — hãy xem Hệ thống kỹ năng.