Hệ thống kỹ năng
#Hệ thống kỹ năng
Kỹ năng là tài liệu kiến thức theo yêu cầu mà tác nhân có thể tải khi cần. Chúng tuân theo mẫu tiết lộ lũy tiến để giảm thiểu việc sử dụng mã thông báo và tương thích với tiêu chuẩn mở agentskills.io.
Tất cả các kỹ năng đều có trong **
~/.Hermes/skills/
** — thư mục chính và nguồn thông tin chính xác. Khi cài đặt mới, các kỹ năng đi kèm sẽ được sao chép từ repo. Các kỹ năng do trung tâm cài đặt và do tác nhân tạo cũng có ở đây. Tác nhân có thể sửa đổi hoặc xóa bất kỳ kỹ năng nào.
Bạn cũng có thể trỏ Hermes vào thư mục kỹ năng bên ngoài — các thư mục bổ sung được quét cùng với thư mục cục bộ. Xem External Skill Directories bên dưới.
Xem thêm:
Sử dụng kỹ năng
Mọi kỹ năng được cài đặt sẽ tự động có sẵn dưới dạng lệnh gạch chéo:
# In the CLI or any messaging platform:
/gif-search funny cats
/axolotl help me fine-tune Llama 3 on my dataset
/GitHub-pr-workflow create a PR for the auth refactor
/plan design a rollout for migrating our auth provider
# Just the skill name loads it and lets the agent ask what you need:
/excalidraw
`
``Kỹ năng
`plan
` đi kèm là một ví dụ điển hình. Chạy
/plan [request]
` tải hướng dẫn của kỹ năng, yêu cầu Hermes kiểm tra ngữ cảnh nếu cần, viết kế hoạch triển khai đánh dấu thay vì thực hiện nhiệm vụ và lưu kết quả trong
.Hermes/plans/
` liên quan đến thư mục làm việc phụ trợ/không gian làm việc đang hoạt động.
Bạn cũng có thể tương tác với các kỹ năng thông qua cuộc trò chuyện tự nhiên:
``` bash
Hermes chat --toolsets skills -q "What skills do you have?"
Hermes chat --toolsets skills -q "Show me the axolotl skill"
`
## Tiết lộ lũy tiến
Kỹ năng sử dụng mẫu tải mã thông báo hiệu quả:
`
Level 0: skills_list() → [\{name, description, category}, ...] (~3k tokens)
Level 1: skill_view(name) → Full content + metadata (varies)
Level 2: skill_view(name, path) → Specific reference file (varies)
`
``Tác nhân chỉ tải toàn bộ nội dung kỹ năng khi thực sự cần.
## Định dạng SKILL.md
`markdown
---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
platforms: [macOS, Linux] # Optional — restrict to specific OS platforms
metadata:
Hermes:
tags: [Python, automation]
category: devops
fallback_for_toolsets: [web] # Optional — conditional activation (see below)
requires_toolsets: [terminal] # Optional — conditional activation (see below)
config: # Optional — config.yaml settings
- key: my.setting
description: "What this controls"
default: "value"
prompt: "Prompt for setup"
---
# Skill Title
## When to Use
Trigger conditions for this skill.
## Procedure
1. Step one
2. Step two
## Pitfalls
- Known failure modes and fixes
## Verification
How to confirm it worked.
`
### Kỹ năng dành riêng cho nền tảng
Các kỹ năng có thể tự giới hạn ở các hệ điều hành cụ thể bằng cách sử dụng trường
`platforms
:
| Giá trị | Trận đấu |
|-------|----------|
|
`macOS
` | macOS (Darwin) |
|
`Linux
` | Linux |
|
`Windows
` | Windows |
``` yaml
platforms: [macOS] # macOS only (e.g., iMessage, Apple Reminders, FindMy)
platforms: [macOS, Linux] # macOS and Linux
`
``Khi được đặt, kỹ năng này sẽ tự động ẩn khỏi lời nhắc hệ thống,
`skills_list()
` và các lệnh gạch chéo trên các nền tảng không tương thích. Nếu bị bỏ qua, kỹ năng sẽ tải trên tất cả các nền tảng.
## Đầu ra kỹ năng và phân phối phương tiện truyền thông
Khi phản hồi kỹ năng (hoặc bất kỳ phản hồi nào của tác nhân) bao gồm đường dẫn tuyệt đối trống tới tệp phương tiện — ví dụ:
/home/user/screenshots/diagram.png
` — cổng sẽ tự động phát hiện nó, loại bỏ nó khỏi văn bản hiển thị và gửi tệp nguyên bản đến cuộc trò chuyện của người dùng (ảnh Telegram, tệp đính kèm Discord, v.v.) thay vì để lại đường dẫn thô trong tin nhắn.
Cụ thể đối với âm thanh, lệnh
[[audio_as_voice]]
` sẽ quảng bá các tệp âm thanh đến bong bóng tin nhắn thoại gốc trên các nền tảng hỗ trợ chúng (Telegram, WhatsApp).
### Buộc phân phối theo kiểu tài liệu:
[[as_document]]
``Đôi khi bạn muốn **ngược lại** của bản xem trước nội tuyến: bạn muốn tệp được phân phối dưới dạng tệp đính kèm có thể tải xuống chứ không phải bong bóng hình ảnh được nén lại. Ví dụ cổ điển là ảnh chụp màn hình hoặc biểu đồ có độ phân giải cao —
`sendPhoto
` của Telegram nén lại xuống ~200 KB ở 1280 px, làm giảm khả năng đọc. PNG 1-2 MB được gửi qua
`sendDocument
` sẽ giữ nguyên các byte gốc.
Nếu một phản hồi (hoặc bất kỳ văn bản nào bên trong nó - thường là dòng cuối cùng) chứa lệnh
[[as_document]]
, mọi đường dẫn phương tiện được trích xuất từ phản hồi đó sẽ được phân phối dưới dạng tệp đính kèm tài liệu/tệp thay vì bong bóng hình ảnh:
`
Here is your rendered chart:`/home/user/.Hermes/cache/chart-q4-2025.png`[[as_document]]
`
``Lệnh này bị loại bỏ trước khi gửi nên người dùng không bao giờ nhìn thấy nó. Mức độ chi tiết được cố ý làm tất cả hoặc không có gì cho mỗi phản hồi: phát ra
[[as_document]]
` một lần và mọi đường dẫn hình ảnh trong cùng một phản hồi sẽ được phân phối dưới dạng tài liệu. Điều này phản ánh phạm vi của
[[audio_as_voice]]
.
Sử dụng nó từ một kỹ năng khi:
- Bạn tạo ảnh chụp màn hình hoặc biểu đồ mà người dùng cần dưới dạng tệp (để chỉnh sửa trong công cụ khác, lưu trữ, chia sẻ nguyên vẹn).
- Bản xem trước bị mất mặc định sẽ che khuất chi tiết (văn bản nhỏ, sơ đồ chính xác đến từng pixel, kết xuất nhạy cảm với màu sắc).
Các nền tảng không có đường dẫn tài liệu riêng (ví dụ: SMS) sẽ quay trở lại bất kỳ cơ chế đính kèm nào mà chúng có.
### Kích hoạt có điều kiện (Kỹ năng dự phòng)
Các kỹ năng có thể tự động hiển thị hoặc ẩn dựa trên công cụ nào có sẵn trong phiên hiện tại. Điều này hữu ích nhất cho **kỹ năng dự phòng** — các lựa chọn thay thế miễn phí hoặc cục bộ chỉ xuất hiện khi không có công cụ cao cấp.
``` yaml
metadata:
Hermes:
fallback_for_toolsets: [web] # Show ONLY when these toolsets are unavailable
requires_toolsets: [terminal] # Show ONLY when these toolsets are available
fallback_for_tools: [web_search] # Show ONLY when these specific tools are unavailable
requires_tools: [terminal] # Show ONLY when these specific tools are available
`
| Lĩnh vực | Hành vi |
|-------|----------|
|
`fallback_for_toolsets
` | Kỹ năng **ẩn** khi có sẵn bộ công cụ được liệt kê. Hiển thị khi họ bị mất tích. |
|
`fallback_for_tools
` | Tương tự, nhưng kiểm tra từng công cụ thay vì bộ công cụ. |
|
`requires_toolsets
` | Kỹ năng bị **ẩn** khi không có bộ công cụ được liệt kê. Hiển thị khi họ có mặt. |
|
`requires_tools
` | Tương tự, nhưng kiểm tra các công cụ riêng lẻ. |
**Ví dụ:** Kỹ năng
`duckduckgo-search
` tích hợp sử dụng
`fallback_for_toolsets: [web]
. Khi bạn đã đặt
`FIRECRAWL_API_KEY
, bộ công cụ web sẽ khả dụng và tác nhân sử dụng
`web_search
- kỹ năng DuckDuckGo vẫn bị ẩn. Nếu thiếu khóa API, bộ công cụ web không khả dụng và kỹ năng DuckDuckGo tự động xuất hiện dưới dạng dự phòng.
Các kỹ năng không có bất kỳ trường điều kiện nào sẽ hoạt động chính xác như trước — chúng luôn được hiển thị.
## Thiết lập an toàn khi tải
Các kỹ năng có thể khai báo các biến môi trường cần thiết mà không biến mất khỏi quá trình khám phá:
`YAML
required_environment_variables:
- name: TENOR_API_KEY
prompt: Tenor API key
help: Get a key from https://developers.Google.com/tenor
required_for: full functionality
`
``Khi gặp một giá trị bị thiếu, Hermes chỉ yêu cầu nó một cách an toàn khi kỹ năng thực sự được tải trong CLI cục bộ. Bạn có thể bỏ qua quá trình thiết lập và tiếp tục sử dụng kỹ năng. Các bề mặt nhắn tin không bao giờ yêu cầu bí mật trong trò chuyện — thay vào đó, chúng yêu cầu bạn sử dụng
`Hermes setup
` hoặc
~/.Hermes/.env
` cục bộ.
Sau khi được đặt, các biến env đã khai báo sẽ **tự động được chuyển qua** tới các hộp cát
`execute_code
` và
`terminal
` — tập lệnh của kỹ năng có thể sử dụng trực tiếp
$TENOR_API_KEY
. Đối với các vars env không có kỹ năng, hãy sử dụng tùy chọn cấu hình
`terminal.env_passthrough
. Xem [Environment Variable Passthrough](/docs/user-guide/security#environment-variable-passthrough) để biết chi tiết.
### Cài đặt cấu hình kỹ năng
Các kỹ năng cũng có thể khai báo các cài đặt cấu hình không bí mật (đường dẫn, tùy chọn) được lưu trữ trong
`config.yaml
:
``` yaml
metadata:
Hermes:
config:
- key: myplugin.path
description: Path to the plugin data directory
default: "~/myplugin-data"
prompt: Plugin data directory path
`
``Cài đặt được lưu trữ trong
`skills.config
` trong config.yaml của bạn.
`Hermes config migrate
` nhắc nhở các cài đặt chưa được định cấu hình và
`Hermes config show
` sẽ hiển thị chúng. Khi một kỹ năng tải, các giá trị cấu hình đã giải quyết của nó sẽ được đưa vào ngữ cảnh để tổng đài viên tự động biết các giá trị đã định cấu hình.
Xem [Skill Settings](/docs/user-guide/configuration#skill-settings) và [Creating Skills — Config Settings](/docs/developer-guide/creating-skills#config-settings-configYAML) để biết chi tiết.
## Cấu trúc thư mục kỹ năng
``` text
~/.Hermes/skills/ # Single source of truth
├── mlops/ # Category directory
│ ├── axolotl/
│ │ ├── SKILL.md # Main instructions (required)
│ │ ├── references/ # Additional docs
│ │ ├── templates/ # Output formats
│ │ ├── scripts/ # Helper scripts callable from the skill
│ │ └── assets/ # Supplementary files
│ └── vLLM/
│ └── SKILL.md
├── devops/
│ └── deploy-k8s/ # Agent-created skill
│ ├── SKILL.md
│ └── references/
├── .hub/ # Skills Hub state
│ ├── lock.JSON
│ ├── quarantine/
│ └── audit.log
└── .bundled_manifest # Tracks seeded bundled skills
`
## Thư mục kỹ năng bên ngoài
Nếu bạn duy trì các kỹ năng bên ngoài Hermes — ví dụ: thư mục
~/.agents/skills/
` được chia sẻ được sử dụng bởi nhiều công cụ AI — bạn cũng có thể yêu cầu Hermes quét các thư mục đó.
Thêm
`external_dirs
` trong phần
`skills
` trong
~/.Hermes/config.yaml
:
`YAML
skills:
external_dirs:
- ~/.agents/skills
- /home/shared/team-skills
- $\{SKILLS_REPO}/skills
`
``Các đường dẫn hỗ trợ mở rộng
~
` và thay thế biến môi trường
$\{VAR}
.
### Cách thức hoạt động
- **Tạo cục bộ, cập nhật tại chỗ**: Các kỹ năng mới do tác nhân tạo được ghi vào
~/.Hermes/skills/
. Các kỹ năng hiện có được sửa đổi ở nơi chúng được tìm thấy, bao gồm các kỹ năng trong
`external_dirs
, khi tác nhân sử dụng các hành động
`skill_manage
` như
`patch
,
`edit
,
`write_file
,
`remove_file
` hoặc
`delete
.
- **Các thư mục bên ngoài không phải là ranh giới chống ghi**: Nếu một thư mục kỹ năng bên ngoài có thể ghi được bằng quy trình Hermes, thì các bản cập nhật kỹ năng do tác nhân quản lý có thể thay đổi các tệp trong thư mục đó. Sử dụng quyền hệ thống tệp hoặc thiết lập hồ sơ/bộ công cụ riêng biệt nếu các kỹ năng được chia sẻ bên ngoài phải ở chế độ chỉ đọc.
- **Ưu tiên cục bộ**: Nếu cùng một tên kỹ năng tồn tại trong cả thư mục cục bộ và thư mục bên ngoài, phiên bản cục bộ sẽ thắng.
- **Tích hợp đầy đủ**: Các kỹ năng bên ngoài xuất hiện trong chỉ mục nhắc nhở hệ thống,
`skills_list
,
`skill_view
` và dưới dạng lệnh gạch chéo
/skill-name
` — không khác gì các kỹ năng cục bộ.
- **Các đường dẫn không tồn tại bị bỏ qua âm thầm**: Nếu một thư mục được định cấu hình không tồn tại, Hermes sẽ bỏ qua nó mà không có lỗi. Hữu ích cho các thư mục chia sẻ tùy chọn có thể không có trên mọi máy.
### Ví dụ
``` text
~/.Hermes/skills/ # Local (primary, read-write)
├── devops/deploy-k8s/
│ └── SKILL.md
└── mlops/axolotl/
└── SKILL.md`~/.agents/skills/ # External (shared, mutable if writable)
├── my-custom-workflow/
│ └── SKILL.md
└── team-conventions/
└── SKILL.md
`
``Tất cả bốn kỹ năng đều xuất hiện trong chỉ số kỹ năng của bạn. Nếu bạn tạo một kỹ năng mới có tên
`my-custom-workflow
` cục bộ, nó sẽ làm mờ phiên bản bên ngoài.
## Gói kỹ năng
Gói kỹ năng là các tệp YAML nhỏ nhóm một số kỹ năng dưới một lệnh gạch chéo duy nhất. Khi bạn chạy
/<bundle-name
, mọi kỹ năng được liệt kê trong gói sẽ tải cùng lúc — hữu ích khi một nhiệm vụ cụ thể luôn được hưởng lợi từ cùng một bộ kỹ năng.
### Ví dụ nhanh
`bash
# Create a bundle for backend feature work
Hermes bundles create backend-dev \
--skill GitHub-code-review \
--skill test-driven-development \
--skill GitHub-pr-workflow \
-d "Backend feature work — review, test, PR workflow"
`
``Sau đó, trong CLI hoặc bất kỳ nền tảng cổng nào:
`
/backend-dev refactor the auth middleware
`
``Tác nhân nhận được tất cả ba kỹ năng được tải vào một tin nhắn của người dùng, với bất kỳ văn bản nào sau lệnh gạch chéo được đính kèm dưới dạng hướng dẫn người dùng.
### Lược đồ YAMLCác gói có trong **
~/.Hermes/skill-bundles/<slug.YAML
** và trông như thế này:
``` yaml
name: backend-dev
description: Backend feature work — review, test, PR workflow.
skills:
- GitHub-code-review
- test-driven-development
- GitHub-pr-workflow
instruction: |
Always start by writing failing tests, then implement.
Open the PR through the standard workflow with co-author tags.
`
``Lĩnh vực:
-
`name
` (tùy chọn — mặc định ở gốc tên tệp) — tên hiển thị của gói. Được chuẩn hóa thành dấu gạch nối cho lệnh gạch chéo (
`Backend Dev
` →
/backend-dev
).
-
`description
` (tùy chọn) — văn bản ngắn hiển thị trong
/bundles
` và
`Hermes bundles list
.
-
`skills
` (bắt buộc, danh sách không trống) — tên kỹ năng hoặc đường dẫn liên quan đến thư mục kỹ năng của bạn. Sử dụng cùng mã định danh mà bạn chuyển tới
/<skill-name
.
-
`instruction
` (tùy chọn) - hướng dẫn bổ sung được thêm vào nội dung kỹ năng đã tải. Hữu ích cho việc mã hóa "cách chúng ta luôn sử dụng những thứ này cùng nhau."
### Quản lý gói
``` bash
# List all installed bundles
Hermes bundles list
# Inspect one bundle
Hermes bundles show backend-dev
# Create a bundle interactively (omit --skill flags to enter them one per line)
Hermes bundles create research
# Overwrite an existing bundle
Hermes bundles create backend-dev --skill ... --force
# Delete a bundle
Hermes bundles delete backend-dev
# Re-scan ~/.Hermes/skill-bundles/ and report changes
Hermes bundles reload
`
``Từ bên trong phiên trò chuyện,
/bundles
` liệt kê mọi gói đã cài đặt và các kỹ năng của gói đó.
### Hành vi
- **Các nhóm được ưu tiên hơn các kỹ năng riêng lẻ** khi sên va chạm. Nếu bạn đặt tên cho một gói là
`research
` và bạn cũng có một kỹ năng tên là
`research
,
/research
` sẽ gọi gói đó. Điều này là có chủ ý — bạn đã chọn tham gia gói bằng cách đặt tên cho gói đó.
- **Các kỹ năng bị thiếu sẽ bị bỏ qua, không gây tử vong.** Nếu một gói liệt kê
`skill-foo
` và bạn chưa cài đặt nó, gói đó vẫn tải các kỹ năng cần giải quyết và nhân viên sẽ nhận được ghi chú liệt kê những gì đã bị bỏ qua.
- **Các gói hoạt động trên mọi bề mặt** — CLI tương tác, TUI, trò chuyện trên trang tổng quan và mọi nền tảng cổng vào (Telegram, Discord, Slack, …) — vì việc gửi đi được tập trung ở cùng một nơi với các lệnh kỹ năng riêng lẻ.
- **Các gói không làm mất hiệu lực bộ đệm nhắc nhở.** Chúng tạo ra thông báo mới cho người dùng tại thời điểm gọi, giống như cách
/<skill-name
` thực hiện — không có đột biến nhắc nhở hệ thống.
### Khi gói beat cài đặt từng kỹ năng một cách thủ công
Sử dụng gói khi:
- Bạn luôn ghép các kỹ năng giống nhau cho một nhiệm vụ định kỳ (
/backend-dev
,
/release-prep
,
/incident-response
).
- Bạn muốn mô hình tinh thần ngắn hơn một ký tự thay vì gõ nhiều lệnh gọi
/skill
` liên tiếp.
- Bạn muốn gửi "hồ sơ nhiệm vụ" cho toàn nhóm bằng cách kiểm tra gói YAML vào kho lưu trữ dotfiles được chia sẻ và liên kết tượng trưng nó với
~/.Hermes/skill-bundles/
.
Gói chỉ là bí danh YAML — gói này không cài đặt kỹ năng cho bạn. Bản thân các kỹ năng này phải có sẵn (trong
~/.Hermes/skills/
` hoặc thư mục kỹ năng bên ngoài). Nếu không, lệnh gọi gói sẽ bỏ qua những cái còn thiếu.
## Kỹ năng do Agent quản lý (công cụ Skill_manage)
Tác nhân có thể tạo, cập nhật và xóa các kỹ năng của chính mình thông qua công cụ
`skill_manage
. Đây là **bộ nhớ thủ tục** của tác nhân — khi nó tìm ra một quy trình công việc không tầm thường, nó sẽ lưu cách tiếp cận đó như một kỹ năng để sử dụng lại trong tương lai.
### Khi tác nhân tạo kỹ năng
- Sau khi hoàn thành thành công một nhiệm vụ phức tạp (hơn 5 lệnh gọi công cụ)
- Khi gặp lỗi hoặc ngõ cụt và tìm được đường đi làm việc
- Khi người dùng sửa lại cách tiếp cận của mình
- Khi phát hiện ra một quy trình làm việc không tầm thường
### Hành động
| Hành động | Sử dụng cho | Thông số chính |
|--------|----------|-------------|
|
`create
` | Kỹ năng mới từ đầu |
name
,
`content
` (đầy đủ SKILL.md),
`category
` tùy chọn |
|
`patch
` | Các bản sửa lỗi có mục tiêu (ưu tiên) |
name
,
`old_string
,
`new_string
` |
|
`edit
` | Viết lại cấu trúc chính |
name
,
`content
` (thay thế đầy đủ SKILL.md) |
|
`delete
` | Loại bỏ hoàn toàn một kỹ năng |
name
` |
|
`write_file
` | Thêm/cập nhật file hỗ trợ |
name
,
`file_path
,
`file_content
` |
|
`remove_file
` | Xóa tệp hỗ trợ |
name
,
`file_path
` |
:::tip
Hành động
`patch
` được ưu tiên cho các bản cập nhật — nó hiệu quả hơn về mã thông báo so với
`edit
` vì chỉ văn bản đã thay đổi mới xuất hiện trong lệnh gọi công cụ.
:::
## Trung tâm kỹ năng
Duyệt, tìm kiếm, cài đặt và quản lý các kỹ năng từ cơ quan đăng ký trực tuyến,
`skills.sh
, chỉ đạo các điểm cuối kỹ năng nổi tiếng và các kỹ năng tùy chọn chính thức.
### Các lệnh thông dụng
``` bash
Hermes skills browse # Browse all hub skills (official first)
Hermes skills browse --source official # Browse only official optional skills
Hermes skills search Kubernetes # Search all sources
Hermes skills search react --source skills-sh # Search the skills.sh directory
Hermes skills search https://mintlify.com/docs --source well-known
Hermes skills inspect OpenAI/skills/k8s # Preview before installing
Hermes skills install OpenAI/skills/k8s # Install with security scan
Hermes skills install official/security/1password
Hermes skills install skills-sh/vercel-labs/JSON-render/JSON-render-react --force
Hermes skills install well-known:https://mintlify.com/docs/.well-known/skills/mintlify
Hermes skills install https://sharethis.chat/SKILL.md # Direct URL (single-file SKILL.md)
Hermes skills install https://example.com/SKILL.md --name my-skill # Override name when frontmatter has none
Hermes skills list --source hub # List hub-installed skills
Hermes skills check # Check installed hub skills for upstream updates
Hermes skills update # Reinstall hub skills with upstream changes when needed
Hermes skills audit # Re-scan all hub skills for security
Hermes skills uninstall k8s # Remove a hub skill
Hermes skills reset Google-workspace # Un-stick a bundled skill from "user-modified" (see below)
Hermes skills reset Google-workspace --restore # Also restore the bundled version, deleting your local edits
Hermes skills publish skills/my-skill --to GitHub --repo owner/repo
Hermes skills snapshot export setup.JSON # Export skill config
Hermes skills tap add myorg/skills-repo # Add a custom GitHub source
`
### Các nguồn trung tâm được hỗ trợ| Nguồn | Ví dụ | Ghi chú |
|--------|----------|-------|
|
`official
` |
`official/security/1password
` | Các kỹ năng tùy chọn được cung cấp cùng với Hermes. |
|
`skills-sh
` |
`skills-sh/vercel-labs/agent-skills/vercel-react-best-practices
` | Có thể tìm kiếm qua
`Hermes skills search <query --source skills-sh
. Hermes giải quyết các kỹ năng kiểu bí danh khi sên kỹ năng.sh khác với thư mục repo. |
|
`well-known
` |
`well-known:https://mintlify.com/docs/.well-known/skills/mintlify
` | Các kỹ năng được phục vụ trực tiếp từ
/.well-known/skills/index.JSON
` trên một trang web. Tìm kiếm bằng URL trang web hoặc tài liệu. |
|
`url
` |
`https://sharethis.chat/SKILL.md
` | URL HTTP(S) trực tiếp tới một tệp đơn
`SKILL.md
. Độ phân giải tên: frontmatter → URL slug → lời nhắc tương tác → cờ
`
--name
. |
|
`GitHub
` |
`OpenAI/skills/k8s
` | Cài đặt đường dẫn/repo GitHub trực tiếp và các thao tác nhấn tùy chỉnh. |
|
`clawhub
,
`lobehub
,
`browse-sh
,
`Claude-marketplace
` | Mã định danh theo nguồn cụ thể | Tích hợp cộng đồng hoặc thị trường. |
### Trung tâm và đăng ký tích hợp
Hermes hiện tích hợp với các hệ sinh thái kỹ năng và nguồn khám phá này:
#### 1. Kỹ năng tùy chọn chính thức (
`official
)
Chúng được duy trì trong chính kho lưu trữ của Hermes và được cài đặt với sự tin cậy tích hợp.
- Danh mục: [Official Optional Skills Catalog](../../reference/optional-skills-catalog)
- Nguồn trong repo:
`optional-skills/
- Ví dụ:
``` bash
Hermes skills browse --source official
Hermes skills install official/security/1password
`
#### 2. Skills.sh (
`skills-sh
)
Đây là thư mục kỹ năng công cộng của Vercel. Hermes có thể tìm kiếm trực tiếp, kiểm tra các trang chi tiết kỹ năng, giải quyết các sên kiểu bí danh và cài đặt từ kho lưu trữ nguồn cơ bản.
- Thư mục: [skills.sh](https://skills.sh/)
- CLI/repo công cụ: [vercel-labs/skills](https://GitHub.com/vercel-labs/skills)
- Kho kỹ năng Vercel chính thức: [vercel-labs/agent-skills](https://GitHub.com/vercel-labs/agent-skills)
- Ví dụ:
``` bash
Hermes skills search react --source skills-sh
Hermes skills inspect skills-sh/vercel-labs/JSON-render/JSON-render-react
Hermes skills install skills-sh/vercel-labs/JSON-render/JSON-render-react --force
`
#### 3. Điểm cuối kỹ năng nổi tiếng (
`well-known
)
Đây là khám phá dựa trên URL từ các trang web xuất bản
/.well-known/skills/index.JSON
. Nó không phải là một trung tâm tập trung duy nhất - nó là một quy ước khám phá web.
- Ví dụ về điểm cuối trực tiếp: [Mintlify docs skills index](https://mintlify.com/docs/.well-known/skills/index.JSON)
- Tham khảo triển khai máy chủ: [vercel-labs/skills-handler](https://GitHub.com/vercel-labs/skills-handler)
- Ví dụ:
``` bash
Hermes skills search https://mintlify.com/docs --source well-known
Hermes skills inspect well-known:https://mintlify.com/docs/.well-known/skills/mintlify
Hermes skills install well-known:https://mintlify.com/docs/.well-known/skills/mintlify
`
#### 4. Kỹ năng GitHub trực tiếp (
`GitHub
)
Hermes có thể cài đặt trực tiếp từ kho GitHub và các vòi dựa trên GitHub. Điều này hữu ích khi bạn đã biết repo/đường dẫn hoặc muốn thêm repo nguồn tùy chỉnh của riêng mình.
Vòi mặc định (có thể duyệt mà không cần thiết lập):
- [OpenAI/skills](https://GitHub.com/OpenAI/skills)
- [Anthropics/skills](https://GitHub.com/Anthropics/skills)
- [huggingface/skills](https://GitHub.com/huggingface/skills)
- [VoltAgent/awesome-agent-skills](https://GitHub.com/VoltAgent/awesome-agent-skills)
- [garrytan/gstack](https://GitHub.com/garrytan/gstack)
- Ví dụ:
``` bash
Hermes skills install OpenAI/skills/k8s
Hermes skills tap add myorg/skills-repo
`
#### 5. ClawHub (
`clawhub
)
Thị trường kỹ năng của bên thứ ba được tích hợp như một nguồn cộng đồng.
- Trang web: [clawhub.ai](https://clawhub.ai/)
- Id nguồn Hermes:
`clawhub
#### 6. Kho lưu trữ kiểu thị trường Claude (
`Claude-marketplace
)
Hermes hỗ trợ các kho lưu trữ trên thị trường xuất bản các bản kê khai thị trường/plugin tương thích với Claude.
Các nguồn tích hợp được biết đến bao gồm:
- [Anthropics/skills](https://GitHub.com/Anthropics/skills)
- [aiskillstore/marketplace](https://GitHub.com/aiskillstore/marketplace)
Id nguồn Hermes:
`Claude-marketplace
#### 7. LobeHub (
`lobehub
)
Hermes có thể tìm kiếm và chuyển đổi các mục nhập đại lý từ danh mục công khai của LobeHub thành các kỹ năng Hermes có thể cài đặt được.
- Trang web: [LobeHub](https://lobehub.com/)
- Chỉ số đại lý đại chúng: [chat-agents.lobehub.com](https://chat-agents.lobehub.com/)
- Sao lưu repo: [lobehub/lobe-chat-agents](https://GitHub.com/lobehub/lobe-chat-agents)
- Id nguồn Hermes:
`lobehub
#### 8. duyệt.sh (
`browse-sh
)
Hermes tích hợp với [browse.sh](https://browse.sh), danh mục hơn 200 tệp SKILL.md tự động hóa trình duyệt dành riêng cho trang web của Browserbase (Airbnb, Amazon, arXiv, 12306.cn, Etsy, Xero, v.v.). Mỗi kỹ năng mô tả cách điều khiển một trang web từ đầu đến cuối và phù hợp để sử dụng với các công cụ trình duyệt của Hermes cũng như mọi kỹ năng tự động hóa trình duyệt mà bạn đã cài đặt.
- Trang web: [browse.sh](https://browse.sh/)
- API danh mục:
`https://browse.sh/API/skills
- Id nguồn Hermes:
`browse-sh
- Mức độ tin cậy:
`community
`
``` bash
Hermes skills search airbnb --source browse-sh
Hermes skills inspect browse-sh/airbnb.com/search-listings-ddgioa
Hermes skills install browse-sh/airbnb.com/search-listings-ddgioa
`
``Mã định danh sử dụng biểu mẫu
`browse-sh/<hostname>/<task-id>
` và khớp với sên được hiển thị bởi danh mục browser.sh. Nội dung được giải quyết thông qua điểm cuối chi tiết mỗi kỹ năng (
/API/skills/<slug>
` →
`skiLLMdUrl
), chứ không phải thông qua GitHub
`sourceUrl
` của danh mục.
#### 9. URL trực tiếp (
`url
)
Cài đặt trực tiếp một tệp
`SKILL.md
` từ bất kỳ URL HTTP(S) nào — hữu ích khi tác giả lưu trữ một kỹ năng trên trang web của riêng họ (không có danh sách trung tâm, không có đường dẫn GitHub để nhập). Hermes tìm nạp URL, phân tích phần đầu YAML, quét bảo mật và cài đặt.- Id nguồn Hermes:
`url
`
- Mã định danh: chính URL (không cần tiền tố)
- Phạm vi: **chỉ một tệp
`SKILL.md
**. Các kỹ năng nhiều tệp với
`references/
` hoặc
`scripts/
` cần có bảng kê khai và phải được xuất bản thông qua một trong các nguồn khác ở trên.
``` bash
Hermes skills install https://sharethis.chat/SKILL.md
Hermes skills install https://example.com/my-skill/SKILL.md --category productivity
`
``Độ phân giải tên, theo thứ tự:
1. Trường
`name:
` trong bảng điều khiển SKILL.md YAML (được khuyến nghị - mọi kỹ năng được hình thành tốt đều có một).
2. Tên thư mục gốc từ đường dẫn URL (ví dụ:
.../my-skill/SKILL.md
` →
`my-skill
` hoặc
.../my-skill.md
` →
`my-skill
), khi đó là mã định danh hợp lệ (
^[a-z][a-z0-9_-]*$
).
3. Lời nhắc tương tác trên terminal có TTY.
4. Trên các bề mặt không tương tác (lệnh gạch chéo
/skills install
` bên trong TUI, nền tảng cổng, tập lệnh), một lỗi rõ ràng chỉ vào ghi đè
--name
.
``` bash
# Frontmatter has no name and the URL slug is unhelpful — supply one:
Hermes skills install https://example.com/SKILL.md --name sharethis-chat
# Or inside a chat session:
/skills install https://example.com/SKILL.md --name sharethis-chat
`
``Mức độ tin cậy luôn là
`community
` — quá trình quét bảo mật tương tự diễn ra như đối với mọi nguồn khác. URL được lưu trữ dưới dạng mã nhận dạng cài đặt, do đó
`Hermes skills update
` tự động tìm nạp lại từ cùng một URL khi bạn muốn làm mới.
### Quét bảo mật và
--force
``Tất cả các kỹ năng do trung tâm cài đặt đều đi qua **máy quét bảo mật** để kiểm tra việc lọc dữ liệu, đưa vào nhanh chóng, các lệnh phá hoại, tín hiệu chuỗi cung ứng và các mối đe dọa khác.
Hermes skills inspect ...
` hiện cũng hiển thị siêu dữ liệu ngược dòng khi có sẵn:
- URL kho lưu trữ
- URL trang chi tiết Skills.sh
- lệnh cài đặt
- lượt cài đặt hàng tuần
- trạng thái kiểm tra an ninh ngược dòng
- URL chỉ mục/điểm cuối nổi tiếng
Sử dụng
--force
` khi bạn đã xem xét kỹ năng của bên thứ ba và muốn ghi đè khối chính sách không nguy hiểm:
``` bash
Hermes skills install skills-sh/Anthropics/skills/pdf --force
`
``Hành vi quan trọng:
-
--force
` có thể ghi đè các khối chính sách đối với các phát hiện theo kiểu cảnh báo/cảnh báo.
-
--force
` **không** ghi đè kết quả quét
`dangerous
.
- Các kỹ năng tùy chọn chính thức (
`official/...
) được coi là sự tin cậy tích hợp và không hiển thị bảng cảnh báo của bên thứ ba.
### Mức độ tin cậy
| Cấp độ | Nguồn | Chính sách |
|-------|--------|--------|
|
`builtin
` | Tàu với Hermes | Luôn được tin cậy |
|
`official
` |
`optional-skills/
` trong kho | Sự tin cậy tích hợp, không có cảnh báo của bên thứ ba |
|
`tRusted
` | Các cơ quan đăng ký/kho lưu trữ đáng tin cậy như
`OpenAI/skills
,
`Anthropics/skills
,
`huggingface/skills
` | Chính sách dễ dãi hơn các nguồn cộng đồng |
|
`community
` | Mọi thứ khác (
`skills.sh
, điểm cuối nổi tiếng, kho lưu trữ GitHub tùy chỉnh, hầu hết các thị trường) | Những phát hiện không nguy hiểm có thể được ghi đè bằng
--force
; Các phán quyết của
`dangerous
` vẫn bị chặn |
### Vòng đời cập nhật
Giờ đây, trung tâm theo dõi đủ nguồn gốc để kiểm tra lại các bản sao ngược dòng của các kỹ năng đã cài đặt:
``` bash
Hermes skills check # Report which installed hub skills changed upstream
Hermes skills update # Reinstall only the skills with updates available
Hermes skills update react # Update one specific installed hub skill
`
``Điều này sử dụng mã định danh nguồn được lưu trữ cộng với hàm băm nội dung gói ngược dòng hiện tại để phát hiện sự trôi dạt.
:::tip[GitHub rate limits]
Hoạt động của trung tâm kỹ năng sử dụng API GitHub, có giới hạn tốc độ là 60 yêu cầu/giờ đối với người dùng chưa được xác thực. Nếu bạn thấy lỗi giới hạn tốc độ trong quá trình cài đặt hoặc tìm kiếm, hãy đặt
`GitHub_TOKEN
` trong tệp
.env
` của bạn để tăng giới hạn lên 5.000 yêu cầu/giờ. Thông báo lỗi bao gồm gợi ý có thể thực hiện được khi điều này xảy ra.
:::
### Xuất bản một vòi kỹ năng tùy chỉnh
Nếu bạn muốn chia sẻ một bộ kỹ năng được tuyển chọn — cho nhóm của bạn, tổ chức của bạn hoặc công khai — bạn có thể xuất bản chúng dưới dạng **tap**: kho lưu trữ GitHub mà những người dùng Hermes khác thêm bằng
`Hermes skills tap add <owner/repo>
. Không có máy chủ, không đăng ký đăng ký, không có đường dẫn phát hành. Chỉ là một thư mục chứa các tệp
`SKILL.md
.
#### Bố cục kho lưu trữ
Một lần nhấn là bất kỳ kho lưu trữ GitHub nào (công khai hoặc riêng tư - nhu cầu riêng tư
`GitHub_TOKEN
) được trình bày như sau:
`
owner/repo
├── skills/ # default path; configurable per-tap
│ ├── my-workflow/
│ │ ├── SKILL.md # required
│ │ ├── references/ # optional supporting files
│ │ ├── templates/
│ │ └── scripts/
│ ├── another-skill/
│ │ └── SKILL.md
│ └── third-skill/
│ └── SKILL.md
└── README.md # optional but helpful
`
`Quy tắc:
- Mỗi kỹ năng nằm trong thư mục riêng dưới đường dẫn gốc của vòi (
`skills/
` mặc định).
- Tên thư mục trở thành slug cài đặt kỹ năng.
- Mỗi thư mục kỹ năng phải chứa một
`SKILL.md
` với [SKILL.md frontmatter](#skiLLMd-format) tiêu chuẩn (
`name
,
`description
, cùng với
`metadata.Hermes.tags
` tùy chọn,
`version
,
`author
,
`platforms
,
`metadata.Hermes.config
).
- Các thư mục con như
`references/
,
`templates/
,
`scripts/
,
`assets/
` được tải xuống cùng với
`SKILL.md
` khi cài đặt.
- Các kỹ năng có tên thư mục bắt đầu bằng
.
` hoặc
`_
` sẽ bị bỏ qua.
Hermes khám phá các kỹ năng bằng cách liệt kê mọi thư mục con của đường dẫn nhấn và thăm dò từng thư mục để tìm
`SKILL.md
.
#### Ví dụ về thao tác nhấn tối thiểu
`
my-org/Hermes-skills
└── skills/
└── deploy-runbook/
└── SKILL.md
`
```skills/deploy-runbook/SKILL.md
:
`markdown
---
name: deploy-runbook
description: Our deployment runbook — services, rollback, Slack channels
version: 1.0.0
author: My Org Platform Team
metadata:
Hermes:
tags: [deployment, runbook, internal]
---
# Deploy Runbook
Step 1: ...
`
``Sau khi đẩy nó lên GitHub, bất kỳ người dùng Hermes nào cũng có thể đăng ký và cài đặt:
``` bash
Hermes skills tap add my-org/Hermes-skills
Hermes skills search deploy
Hermes skills install my-org/Hermes-skills/deploy-runbook
`
#### Đường dẫn không mặc định
Nếu kỹ năng của bạn không nằm trong
`skills/
` (phổ biến khi bạn thêm cây con
`skills/
` vào dự án hiện có), hãy chỉnh sửa mục nhấn trong
~/.Hermes/.hub/taps.JSON
:
`JSON
{
"taps": [
\{"repo": "my-org/platform-docs", "path": "internal/skills/"}
]
}
`
```Hermes skills tap add
` CLI mặc định các vòi mới thành
`path: "skills/"
; chỉnh sửa tệp trực tiếp nếu bạn cần một đường dẫn khác.
`Hermes skills tap list
` hiển thị đường dẫn hiệu quả trên mỗi lần nhấn.
#### Cài đặt trực tiếp các kỹ năng riêng lẻ (không cần nhấn)
Người dùng cũng có thể cài đặt một kỹ năng duy nhất từ bất kỳ kho lưu trữ GitHub công khai nào mà không cần thêm toàn bộ kho lưu trữ dưới dạng một lần nhấn:
`bash
Hermes skills install owner/repo/skills/my-workflow
`
``Hữu ích khi bạn muốn chia sẻ một kỹ năng mà không yêu cầu người dùng đăng ký toàn bộ sổ đăng ký của bạn.
#### Mức độ tin cậy cho các lần nhấn
Các vòi mới được gán độ tin cậy
`community
` theo mặc định. Các kỹ năng được cài đặt từ chúng sẽ trải qua quá trình quét bảo mật tiêu chuẩn và hiển thị bảng cảnh báo của bên thứ ba trong lần cài đặt đầu tiên. Nếu tổ chức của bạn hoặc một nguồn đáng tin cậy rộng rãi có mức độ tin cậy cao hơn, hãy thêm kho lưu trữ của nó vào
`TRustED_REPOS
` trong
`tools/skills_hub.py
` (yêu cầu PR lõi Hermes).
#### Quản lý nhấn
`bash
Hermes skills tap list # show all configured taps
Hermes skills tap add myorg/skills-repo # add (default path: skills/)
Hermes skills tap remove myorg/skills-repo # remove
`
``Bên trong một phiên chạy:
`
/skills tap list
/skills tap add myorg/skills-repo
/skills tap remove myorg/skills-repo
`
``Vòi được lưu trữ trong
~/.Hermes/.hub/taps.JSON
` (được tạo theo yêu cầu).
## Cập nhật kỹ năng đi kèm (
`Hermes skills reset
)
Hermes cung cấp một bộ kỹ năng đi kèm trong
`skills/
` bên trong kho lưu trữ. Khi cài đặt và trên mọi
`Hermes update
, thẻ đồng bộ hóa sẽ sao chép chúng vào
~/.Hermes/skills/
` và ghi lại bảng kê khai tại
~/.Hermes/skills/.bundled_manifest
` ánh xạ từng tên kỹ năng vào hàm băm nội dung tại thời điểm nó được đồng bộ hóa (**băm gốc**).
Mỗi lần đồng bộ hóa, Hermes tính toán lại hàm băm của bản sao cục bộ của bạn và so sánh nó với hàm băm gốc:
- **Không thay đổi** → an toàn để kéo các thay đổi ngược dòng, sao chép phiên bản đi kèm mới vào, ghi lại hàm băm gốc mới.
- **Đã thay đổi** → được coi là **do người dùng sửa đổi** và bị bỏ qua vĩnh viễn, do đó các chỉnh sửa của bạn không bao giờ bị sửa đổi.
Sự bảo vệ là tốt, nhưng nó có một cạnh sắc nét. Nếu bạn chỉnh sửa một kỹ năng đi kèm và sau đó muốn hủy bỏ các thay đổi của mình và quay lại phiên bản đi kèm bằng cách chỉ sao chép-dán từ
~/.Hermes/Hermes-agent/skills/
, thì tệp kê khai vẫn giữ hàm băm gốc *cũ* bất cứ khi nào lần đồng bộ hóa thành công cuối cùng được chạy. Nội dung sao chép-dán mới của bạn (hàm băm được nhóm hiện tại) sẽ không khớp với hàm băm gốc cũ đó, do đó, quá trình đồng bộ hóa tiếp tục gắn cờ nội dung đó là do người dùng sửa đổi.
Hermes skills reset
` là cửa thoát hiểm:
``` bash
# Safe: clears the manifest entry for this skill. Your current copy is preserved,
# but the next sync re-baselines against it so future updates work normally.
Hermes skills reset Google-workspace
# Full restore: also deletes your local copy and re-copies the current bundled
# version. Use this when you want the pristine upstream skill back.
Hermes skills reset Google-workspace --restore
# Non-interactive (e.g. in scripts or TUI mode) — skip the --restore confirmation.
Hermes skills reset Google-workspace --restore --yes
`
``Lệnh tương tự hoạt động trong trò chuyện dưới dạng lệnh gạch chéo:
``` text
/skills reset Google-workspace
/skills reset Google-workspace --restore
`
:::note[Profiles]
Mỗi cấu hình có
.bundled_manifest
` riêng trong
`Hermes_HOME
` riêng, vì vậy
`Hermes -p coder skills reset <name
` chỉ ảnh hưởng đến cấu hình đó.
:::
### Lệnh gạch chéo (trong trò chuyện)
Tất cả các lệnh tương tự đều hoạt động với
/skills
:
``` text
/skills browse
/skills search react --source skills-sh
/skills search https://mintlify.com/docs --source well-known
/skills inspect skills-sh/vercel-labs/JSON-render/JSON-render-react
/skills install OpenAI/skills/skill-creator --force
/skills check
/skills update
/skills reset Google-workspace
/skills list
`
``Các kỹ năng tùy chọn chính thức vẫn sử dụng các mã định danh như
`official/security/1password
` và
`official/migration/OpenClaw-migration
.