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 tồn tại 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 Thư mục kỹ năng bên ngoài bên dưới.

Xem thêm:

• Danh mục kỹ năng đi kèm
• Danh mục kỹ năng tùy chọn chính thức

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 về lệnh gạch chéo được hỗ trợ kỹ năng với hành vi tùy chỉnh. Việc chạy /plan [request] 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:

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

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

platforms: [macos]            

# macOS only (e.g., iMessage, Apple Reminders, FindMy)
platforms: [macos, linux]     

# macOS and Linux

Khi được đặt, kỹ năng 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.

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.

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à nhân viên sẽ 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á:

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. Giao diện 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 lọ env không có kỹ năng, hãy sử dụng tùy chọn cấu hình terminal.env_passthrough. Xem Truyền biến môi trường để 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 :

metadata:
  hermes:
    config:
      - key: wiki.path
        description: Path to the wiki directory
        default: "~/wiki"
        prompt: Wiki 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ở về cài đặt chưa được định cấu hình và hermes config show 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 Cài đặt kỹ năng và Tạo kỹ năng — Cài đặt cấu hình để biết chi tiết.

Cấu trúc thư mục kỹ năng

~/.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 vào phần skills trong ~/.hermes/config.yaml :

skills:
  external_dirs:
    - ~/.agents/skills
    - /home/shared/team-skills
    - ${SKILLS_REPO}/skills

Đườ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

• Chỉ đọc: Các thư mục bên ngoài chỉ được quét để khám phá kỹ năng. Khi tác nhân tạo hoặc chỉnh sửa một kỹ năng, nó luôn ghi vào ~/.hermes/skills/ .
• Ư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ở của 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ụ

~/.hermes/skills/               

# Local (primary, read-write)
├── devops/deploy-k8s/
│   └── SKILL.md
└── mlops/axolotl/
    └── SKILL.md

~/.agents/skills/               

# External (read-only, shared)
├── 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.

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 riêng 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 (KỸ NĂNG đầy đủ.md), tùy chọn category
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

mẹo

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

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 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 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 cung cấp trực tiếp từ /.well-known/skills/index.json trên trang web. Tìm kiếm bằng URL trang web hoặc tài liệu.
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 , 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: Danh mục kỹ năng tùy chọn chính thức
• Nguồn trong repo: optional-skills/
• Ví dụ:

hermes skills browse --source official
hermes skills install official/security/1password

2. kỹ năng.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
• CLI/repo công cụ: vercel-labs/skills
• Kho kỹ năng Vercel chính thức: vercel-labs/agent-skills
• Ví dụ:

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: Chỉ số kỹ năng tài liệu Mintlify
• Triển khai máy chủ tham khảo: vercel-labs/skills-handler
• Ví dụ:

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 trực tiếp trên GitHub ( 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/kỹ năng

• nhân loại/kỹ năng

• VoltAgent/tác nhân-kỹ năng tuyệt vời

• garrytan/gstack

• Ví dụ:

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
• 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:

• nhân loại/kỹ năng
• 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
• Chỉ số đại lý công cộng: chat-agents.lobehub.com
• Sao lưu repo: lobehub/lobe-chat-agents
• Id nguồn Hermes: lobehub

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:

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 mang tính thận trọng/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	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 ; dangerous phán quyết 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:

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.

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 :

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