Δεξιότητες Hermes Agent: Εγκατάσταση και δημιουργία δικής σας δεξιότητας

Μια δεξιότητα είναι μια αποθηκευμένη οδηγία για έναν πράκτορα: περιγράφετε μία φορά πώς να εκτελέσει μια εργασία και από εκεί και πέρα το Hermes την εφαρμόζει όταν καλείτε το /skill-name, χωρίς να χρειάζονται επαναλαμβανόμενες εξηγήσεις. Μπορείτε να εγκαταστήσετε μια έτοιμη δεξιότητα με μία εντολή και να δημιουργήσετε τη δική σας με δύο τρόπους: γράφοντας το SKILL.md χειροκίνητα ή χρησιμοποιώντας το /learn.

Αν δεν έχετε εγκαταστήσει ακόμα το Hermes, ξεκινήστε με τον οδηγό τι είναι αυτός ο πράκτορας και πώς να τον εγκαταστήσετε και μετά συνεχίστε με τις δεξιότητες.

Τι είναι μια δεξιότητα στο Hermes Agent;#

Γράφετε μια προτροπή σε μήνυμα προς τον πράκτορα. Η δεξιότητα αποθηκεύεται σε ξεχωριστό αρχείο και το Hermes μπορεί να χρησιμοποιήσει αυτή την οδηγία σε μελλοντικές εργασίες. Ο πράκτορας έχει πρόσβαση σε μια λίστα ονομάτων και περιγραφών και φορτώνει ολόκληρο το κείμενο της δεξιότητας όταν είναι σχετική με την εργασία. Έτσι εξοικονομείται χώρος στο πλαίσιο: δεν φορτώνονται όλες οι οδηγίες ταυτόχρονα.

Μια δεξιότητα από μόνη της δεν δίνει στον πράκτορα νέα εργαλεία ή πρόσβαση· περιγράφει πώς να χρησιμοποιήσει τα εργαλεία που ήδη διαθέτει. Μια νέα ενσωμάτωση με εξωτερική υπηρεσία υλοποιείται μέσω MCP, που είναι ξεχωριστό θέμα. Αν μια εργασία απαιτεί ακριβή λογική προγράμματος, ειδική εξουσιοδότηση ή επεξεργασία ροής συμβάντων, χρειάζονται εργαλεία πράκτορα· μια δεξιότητα από μόνη της δεν αρκεί.

Επιλέξτε μια έτοιμη δεξιότητα για μια τυπική εργασία, αν οι οδηγίες της ταιριάζουν και έχετε ελέγξει την πηγή της. Γράψτε τη δική σας όταν χρειάζεται να διατηρήσετε τη συγκεκριμένη ακολουθία ενεργειών, τους περιορισμούς και τη μορφή εξόδου σας. Χρησιμοποιήστε το /learn όταν έχετε ήδη υλικό ή έχετε ολοκληρώσει μια διαδικασία και δεν θέλετε να γράψετε το αρχείο χειροκίνητα.

Η μορφή είναι ανοιχτή και συμβατή με την προδιαγραφή Agent Skills, επομένως οι δεξιότητες από άλλους καταλόγους συνήθως λειτουργούν στο Hermes χωρίς αλλαγές στη μορφή, αν και μια συγκεκριμένη δεξιότητα μπορεί να απαιτεί δικά της εργαλεία ή κλειδιά. Μπορείτε επίσης να μοιραστείτε τη δική σας δεξιότητα, αν θέλετε.

Ποιες δεξιότητες είναι ήδη εγκατεστημένες και πού αποθηκεύονται;#

Ο φάκελος είναι οργανωμένος ως εξής:

~/.hermes/skills/
├── research/
│   └── arxiv/
│       ├── SKILL.md
│       └── scripts/
├── productivity/
│   └── pdf/
│       ├── SKILL.md
│       └── references/
└── .hub/

Το SKILL.md είναι το μόνο υποχρεωτικό αρχείο. Όλα τα υπόλοιπα προστίθενται ανάλογα με τις ανάγκες: references/ για εκτενέστερο υλικό, scripts/ για βοηθητικά προγράμματα και templates/ και assets/ για πρότυπα και αρχεία.

Ο ενσωματωμένος κατάλογος περιλαμβάνει δεξιότητες για καθημερινές εργασίες: εύρεση GIF, εργασία με PDF, υπολογιστικά φύλλα, YouTube, GitHub και σημειώσεις. Η πλήρης λίστα με περιγραφές βρίσκεται στη σελίδα κατάλογος ενσωματωμένων δεξιοτήτων. Με κάθε hermes update, το Hermes ενημερώνει επίσης τις ενσωματωμένες δεξιότητες, διατηρώντας τις αλλαγές σας σε αυτές.

Πώς εγκαθιστάτε μια έτοιμη δεξιότητα από τον κατάλογο;#

1. Αναζητήστε στον κατάλογο

   hermes skills search pdf
   

   Η αναζήτηση γίνεται σε όλες τις συνδεδεμένες πηγές. Για να δείτε ολόκληρο τον κατάλογο χωρίς φίλτρο, εκτελέστε hermes skills browse.

2. Δείτε την καρτέλα της δεξιότητας

   hermes skills inspect skills-sh/anthropics/skills/pdf
   

   Η καρτέλα εμφανίζει την περιγραφή, την πηγή και το επίπεδο εμπιστοσύνης. Μην εγκαθιστάτε δεξιότητα κάποιου άλλου χωρίς να διαβάσετε την καρτέλα της.

3. Εγκαταστήστε την

   hermes skills install skills-sh/anthropics/skills/pdf
   

   Το Hermes κατεβάζει το SKILL.md και τα συνοδευτικά αρχεία του, εκτελεί έλεγχο ασφαλείας και τοποθετεί τα πάντα στο ~/.hermes/skills/. Η δεξιότητα είναι αμέσως διαθέσιμη ως εντολή /pdf. Αν χρειάζεται πρόσθετα εργαλεία ή κλειδιά, αναφέρονται στο SKILL.md και το Hermes θα σας ενημερώσει κατά την εγκατάσταση.

Ο έλεγχος ασφαλείας αναζητά απόπειρες αποστολής δεδομένων εκτός του συστήματος, οδηγίες που έχουν εισαχθεί για τον πράκτορα και εντολές που θα μπορούσαν να διαγράψουν ή να καταστρέψουν αρχεία. Οι πηγές έχουν διαφορετικά επίπεδα εμπιστοσύνης:

Αν ο έλεγχος εμφανίσει προειδοποίηση, μπορείτε να συνεχίσετε την εγκατάσταση με τη σημαία --force, αλλά πρώτα διαβάστε ποιον κίνδυνο εντόπισε. Δεν μπορείτε να παρακάμψετε την κρίση «dangerous». Ο ίδιος ο έλεγχος δεν εγγυάται την ασφάλεια: πριν εκτελέσετε για πρώτη φορά τη δεξιότητα κάποιου άλλου, διαβάστε τις οδηγίες και τις συνοδευτικές εντολές της.

Πώς εγκαθιστάτε μια δεξιότητα από το GitHub ή από σύνδεσμο;#

Τρεις τρόποι εγκατάστασης:

# 1. A specific skill from a GitHub repository (the path inside the repository comes after its name)
hermes skills install anthropics/skills/skills/pdf

# 2. A direct link to a SKILL.md on any site (share this skill in a chat)
hermes skills install '<OFFICIAL_URL>'

# 3. Connect an entire repository as a source (replace with your owner and repository)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

Για απευθείας σύνδεσμο, το Hermes κατεβάζει το SKILL.md και μόνο τα αρχεία που αναφέρονται σε αυτό από τους υποφακέλους της υπηρεσίας· δεν κατεβάζει άσχετα αρχεία από τον ιστότοπο. Ο σύνδεσμος αποθηκεύεται ως πηγή και αργότερα η εντολή hermes skills update θα ενημερώσει τη δεξιότητα από την ίδια διεύθυνση.

Εκτός από το GitHub, μπορούν να συνδεθούν και εξωτερικοί κατάλογοι δεξιοτήτων. Μπορείτε να αναζητήσετε δεξιότητες από αυτούς με την ίδια εντολή hermes skills search, καθορίζοντας την πηγή.

Πώς χρησιμοποιείτε μια δεξιότητα μετά την εγκατάσταση;#

Πληκτρολογήστε εντολές hermes ... στο τερματικό και κλήσεις /skill-name σε συνομιλία με τον πράκτορα (στο ίδιο τερματικό, στη διεπαφή ιστού ή σε πρόγραμμα ανταλλαγής μηνυμάτων):

/gif-search funny cats
/github-pr-workflow create a PR for the authorization rewrite

Αν πληκτρολογήσετε /skill-name χωρίς εργασία, το Hermes θα φορτώσει τις οδηγίες και θα ρωτήσει τι θέλετε να κάνει. Μπορείτε να καλέσετε πολλές δεξιότητες σε μία γραμμή, έως πέντε· το υπόλοιπο κείμενο γίνεται η εργασία:

/github-pr-workflow /test-driven-development close issue 123 and open a PR

Για συνδυασμούς που χρησιμοποιείτε τακτικά, υπάρχουν πακέτα δεξιοτήτων, τα οποία στην ορολογία του Hermes αποκαλούνται bundles: η εντολή hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development ομαδοποιεί αρκετές δεξιότητες σε μία σύντομη εντολή /backend-dev. Ένα τέτοιο bundle λειτουργεί ως ψευδώνυμο· οι δεξιότητες που περιλαμβάνει πρέπει να είναι εγκατεστημένες εκ των προτέρων.

Οι εντολές με κάθετο λειτουργούν επίσης στο Telegram, αν είναι συνδεδεμένη η πύλη· η ρύθμιση καλύπτεται στον οδηγό πώς να συνδέσετε το Hermes Agent στο Telegram. Είναι επίσης ένας βολικός τρόπος να εκτελείτε δεξιότητες από το τηλέφωνό σας.

Πώς δημιουργείτε τη δική σας δεξιότητα: τι περιλαμβάνει το SKILL.md;#

Μπορείτε να αντιγράψετε αυτή τη δεξιότητα και να την προσαρμόσετε για τον εαυτό σας:

---
name: weekly-review
description: Weekly review: what got done, what stalled, plan for next week
version: 1.0.0
metadata:
  hermes:
    tags: [planning, review]
---

# Weekly review

## When to Use
When the user asks to review the week or put together a plan for the next one.

## Procedure
1. Get the week's task list from the file the user provided, or ask them for it.
2. Sort the tasks into three groups: done, stalled, and new.
3. Name three priorities for the coming week.

## Pitfalls
- Don't invent tasks that aren't in the original list.

## Verification
Ask the user to confirm that the tasks are correctly sorted into “done,” “stalled,” and “new.”

Η κεφαλίδα ανάμεσα στις τριπλές παύλες είναι μεταδεδομένα. Τα βασικά πεδία είναι τα name (με λατινικά γράμματα, λέξεις χωρισμένες με παύλες, και χρησιμοποιείται για την κλήση της δεξιότητας ως εντολής) και description. Ο πράκτορας χρησιμοποιεί το πεδίο περιγραφής για να αποφασίσει αν η δεξιότητα ταιριάζει στην τρέχουσα εργασία και πρέπει να φορτωθεί. Αν η περιγραφή είναι ασαφής, η δεξιότητα μπορεί να μη φορτωθεί όταν χρειάζεται.

Μετά την κεφαλίδα ακολουθούν ενότητες οδηγιών. Η ενότητα When to Use αναφέρει πότε πρέπει να φορτώνεται η δεξιότητα. Η Procedure δίνει τα βήματα. Η Pitfalls περιγράφει τα σημεία όπου ο πράκτορας κάνει συχνά λάθη και πώς να τα αποφεύγει. Η Verification εξηγεί πώς να ελέγξετε το αποτέλεσμα. Αν οι οδηγίες είναι εκτενείς, μεταφέρετε το κύριο περιεχόμενο σε αρχεία στο references/· θα φορτώνονται μόνο όταν χρειάζεται, ενώ τα βοηθητικά προγράμματα τοποθετούνται στο scripts/.

Αν μια δεξιότητα χρειάζεται κλειδί API, δηλώστε το στην κεφαλίδα με το required_environment_variables· μην βάλετε το ίδιο το κλειδί στο αρχείο, δηλώστε μόνο το όνομα της μεταβλητής. Το Hermes θα ζητήσει την τιμή μία φορά, κατά την πρώτη κλήση σε τοπικό τερματικό, και έπειτα θα τη δίνει αυτόματα (στα προγράμματα ανταλλαγής μηνυμάτων θα σας ζητήσει να ρυθμίσετε το κλειδί τοπικά). Τα πεδία platforms, config, blueprint και άλλα περιγράφονται στην επίσημη σελίδα τεκμηρίωσης Creating Skills.

Όταν το αρχείο είναι έτοιμο, ακολουθήστε τα εξής βήματα:

1. Δημιουργήστε τον φάκελο της δεξιότητας

   mkdir -p ~/.hermes/skills/weekly-review
   

   Το όνομα του φακέλου αντιστοιχεί στο πεδίο name της κεφαλίδας.

2. Αποθηκεύστε το SKILL.md

   Τοποθετήστε ένα αρχείο με όνομα SKILL.md και τις οδηγίες σας μέσα στον φάκελο· μπορείτε να χρησιμοποιήσετε το παραπάνω παράδειγμα και να το ξαναγράψετε για την εργασία σας.

3. Καλέστε τη δεξιότητα και ελέγξτε την

   Πληκτρολογήστε /weekly-review και ζητήστε από τον πράκτορα να αξιολογήσει την εβδομάδα σας. Αν ακολουθήσει τα βήματα των οδηγιών σας, η δεξιότητα λειτουργεί.

Πώς δημιουργείτε μια δεξιότητα από υπάρχον υλικό με το /learn;#

/learn documentation for the demo API in ~/projects/example-docs, especially the section on authentication
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn how I just published a site to hosting

Αν μόλις ολοκληρώσατε μια περίπλοκη διαδικασία με τον πράκτορα, ζητήστε από το /learn να την αποθηκεύσει ως δεξιότητα όσο όλα τα βήματα είναι ακόμη στη συνομιλία. Την επόμενη φορά, το Hermes θα επαναλάβει τη διαδικασία χρησιμοποιώντας τις έτοιμες οδηγίες.

Μια μεγάλη πηγή, όπως βιβλίο, προδιαγραφή ή αρχείο εγγράφων, δεν χωρά σε ένα αρχείο. Το Hermes θα δημιουργήσει ένα συμπαγές SKILL.md με χάρτη θεμάτων και θα μεταφέρει τις λεπτομέρειες στο references/. Αυτά τα αρχεία δεν καταλαμβάνουν χώρο στο πλαίσιο μέχρι να τα φορτώσει για να απαντήσει σε μια ερώτηση. Αν καλέσετε ξανά το /learn για το ίδιο θέμα, θα προσθέσει υλικό στην υπάρχουσα δεξιότητα αντί να δημιουργήσει αντίγραφο.

Πώς ελέγχετε αν λειτουργεί μια δεξιότητα;#

hermes chat --toolsets skills -q "review my week using the weekly-review skill: done - report and calls, stalled - hosting payment"

Αυτή είναι η δοκιμή που προτείνει η τεκμηρίωση: εκτελέστε τη δεξιότητα και ελέγξτε αν ο πράκτορας ακολουθεί τις οδηγίες σας. Αν δεν το κάνει, ελέγξτε τρεις πιθανές αιτίες. Πρώτον, το όνομα του φακέλου ή το name στην κεφαλίδα μπορεί να μην ταιριάζει με το όνομα που καλείτε. Δεύτερον, η περιγραφή μπορεί να είναι διατυπωμένη με τρόπο που δεν διευκρινίζει πότε πρέπει να χρησιμοποιείται η δεξιότητα· ξαναγράψτε την με τις ίδιες τις λέξεις της εργασίας. Τρίτον, ο φάκελος μπορεί να μην βρίσκεται στο ~/.hermes/skills/, οπότε το Hermes δεν μπορεί να τον εντοπίσει. Σημειώστε ότι η σημαία --toolsets skills περιορίζει το σύνολο εργαλείων της δοκιμής: δείχνει πώς λειτουργεί ο πράκτορας με την οδηγία, αλλά δεν ελέγχει τις εξαρτήσεις της δεξιότητας, όπως εξωτερικά προγράμματα.

Η εντολή hermes skills list στο τερματικό δείχνει ακριβώς τι είναι εγκατεστημένο.

Οι δεξιότητες αποτελούν μέρος ενός κλώνου τεχνητής νοημοσύνης: έναν τρόπο να καταγράψετε μία φορά πώς εκτελείτε μια εργασία, ώστε ο πράκτορας να μπορεί να την επαναλάβει χωρίς υπενθυμίσεις. Ο συνδυασμός περιλαμβάνει κλώνο τεχνητής νοημοσύνης + Δεύτερο Εγκέφαλο + Μηχανική Πλαισίου. Αυτός ο συνδυασμός βοηθά να μεταδώσετε στον πράκτορα τη λογική της δουλειάς σας και το πλαίσιο της εργασίας.

Πώς ενημερώνετε και αφαιρείτε δεξιότητες;#

hermes skills check      # what changed at the sources
hermes skills update     # download new versions
hermes skills uninstall pdf   # remove a skill from the hub

Για να αφαιρέσετε μια δεξιότητα που δημιουργήσατε χειροκίνητα, διαγράψτε τον φάκελό της από το ~/.hermes/skills/. Αν προσαρμόσατε τη δεξιότητα κάποιου άλλου, η update θα την αφήσει ανέπαφη: το Hermes συγκρίνει κατακερματισμούς και παραλείπει τα τροποποιημένα αρχεία για να μην αντικαταστήσει τη δουλειά σας. Για να επαναφέρετε το πρωτότυπο μιας δεξιότητας από το hub, χρησιμοποιήστε hermes skills update name --force· για ενσωματωμένη δεξιότητα, χρησιμοποιήστε hermes skills reset name --restore. Και οι δύο εντολές αντικαθιστούν τις αλλαγές σας, επομένως αποθηκεύστε πρώτα την έκδοσή σας.

Αν δεν χρειάζεστε τις ενσωματωμένες δεξιότητες και γεμίζουν τη λίστα, η hermes skills opt-out απενεργοποιεί την προσθήκη τους κατά τις ενημερώσεις. Η εντολή opt-out --remove αφαιρεί επίσης όσες δεν έχετε τροποποιήσει.

Τι να κάνετε αν μια δεξιότητα δεν εγκαθίσταται ή δεν λειτουργεί;#

Το Hermes εντοπίζει δεξιότητες στους φακέλους .hermes/skills/ και .agents/skills/ μέσα σε αποθετήριο git. Πριν τις φορτώσει, πρέπει να επισημάνετε το αποθετήριο ως έμπιστο: αυτά τα αρχεία περιέχουν οδηγίες που θα ακολουθήσει ο πράκτορας. Έπειτα οι δεξιότητες από το αποθετήριο λειτουργούν μόνο μέσα σε αυτό και περνούν από τον ίδιο έλεγχο ασφαλείας. Χρειάζεται να επισημάνετε το αποθετήριο ως έμπιστο μόνο μία φορά.

Τι να κάνετε πρώτα;#

Στη συνέχεια για αυτό το θέμα: πώς να συνδέσετε το Hermes Agent στο Telegram, ώστε να καλείτε δεξιότητες από το τηλέφωνό σας, και πώς να διατηρείτε έναν πράκτορα σε λειτουργία σε διακομιστή όλο το εικοσιτετράωρο, αν θέλετε προγραμματισμένες δεξιότητες. Αν επιλέγετε πράκτορα, δείτε τη σύγκριση OpenClaw ή Hermes Agent.