Εγκατάσταση και διαχείριση δεξιοτήτων

Αυτός ο οδηγός δείχνει πώς να γεμίσετε έναν χώρο εργασίας με δεξιότητες από το GitHub: προσθέστε ένα αποθετήριο ως πηγή, εγκαταστήστε τις δεξιότητες που θέλετε από αυτό και κρατήστε τις ενημερωμένες στον χρόνο.

Το σημαντικό που πρέπει να ξέρετε πριν ξεκινήσετε: ένα αποθετήριο πηγής δεν είναι αξιόπιστο. Το όνομα, η περιγραφή και ο αριθμός των αστεριών του τα γράφει όποιος το κατέχει. Το μόνο σήμα ασφάλειας που εμπιστεύεται το Control Center είναι η ετυμηγορία της σάρωσης antivirus, από την οποία περνά κάθε εγκατάσταση πριν φτάσει οτιδήποτε στον δίσκο ή σε μια προτροπή πράκτορα. Αν θέλετε το σκεπτικό, διαβάστε την ενότητα για τις δεξιότητες του μοντέλου πρακτόρων; αυτή η σελίδα μένει στην πράξη.

Οι δεξιότητες βρίσκονται στις Ρυθμίσεις → Χώρος εργασίας → Δεξιότητες (/workspaces/<id>/settings/workspace/skills). Έχουν εμβέλεια χώρου εργασίας: οι δεξιότητες που εγκαθιστάτε εδώ ανήκουν μόνο σε αυτόν τον χώρο εργασίας. Η σελίδα έχει δύο καρτέλες: Εγκατεστημένες (τοπικές δεξιότητες, μαζί με έναν επεξεργαστή Νέα δεξιότητα) και Πηγές (κατάλογοι GitHub). Και οι δύο εγγραφές περνούν από την ίδια πύλη σάρωσης.

Προσθήκη αποθετηρίου δεξιοτήτων

Ανοίξτε τις Ρυθμίσεις → Χώρος εργασίας → Δεξιότητες και μεταβείτε στην καρτέλα Πηγές.
Πατήστε Προσθήκη αποθετηρίου.
Επικολλήστε το URL ενός αποθετηρίου GitHub, π.χ. https://github.com/anthropics/skills, και επιβεβαιώστε.

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

Οι δεξιότητες ενός αποθετηρίου είναι οι κατάλογοι που περιέχουν ένα SKILL.md (έως τρία επίπεδα βάθος, συν τη διάταξη plugin-marketplace του Claude plugins/<plugin>/skills/<skill>, με τα δέντρα εξαρτήσεων και προμηθευτών να παραλείπονται). Αν το πλέγμα αργότερα πει ότι το αποθετήριο δεν έχει δεξιότητες, αυτό ακριβώς σημαίνει: κανένας κατάλογος μέσα του δεν ταιριάζει με τη σύμβαση δεξιοτήτων.

Επιθεωρήστε μια δεξιότητα πριν την εγκατάσταση

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

Το README, αποδοσμένο ως markdown — το README.md του καταλόγου της δεξιότητας, ή το σώμα του SKILL.md όταν δεν υπάρχει README.
Η προεπισκόπηση σάρωσης — η ετυμηγορία (pass, warn ή quarantine), οι δυνατότητες που δηλώνει το περιεχόμενο της δεξιότητας (εκτελεί shell, γράφει αρχεία, πρόσβαση δικτύου…) και κάθε εύρημα που κατέγραψε ο σαρωτής.
Ο αριθμός αρχείων — μια εγκατάσταση γράφει ολόκληρο τον κατάλογο της δεξιότητας, όχι μόνο το SKILL.md της.

Η προεπισκόπηση σαρώνει τα ακριβή byte που θα έγραφε μια εγκατάσταση, οπότε η ετυμηγορία που βλέπετε είναι η ετυμηγορία που παίρνει η εγκατάσταση· τίποτα δεν επανακρίνεται πίσω από την πλάτη σας.

Εγκατάσταση μιας δεξιότητας

Ανοίξτε την προβολή λεπτομερειών της δεξιότητας.
Διαβάστε την ετυμηγορία της σάρωσης. Για ετυμηγορία warn ή pass, πατήστε Εγκατάσταση.
Για ετυμηγορία quarantine, η εγκατάσταση μένει ανενεργή μέχρι να τσεκάρετε το Κατανοώ τον κίνδυνο — εγκατάσταση ούτως ή άλλως. Αυτή η παράκαμψη καταγράφεται, δεν τεκμαίρεται.

Η εγκατάσταση γράφει τον κατάλογο της δεξιότητας στον χώρο εργασίας, καταγράφει μια καρφίτσα στο skills-lock.json (αποθετήριο πηγής, διαδρομή, το commit από το οποίο προήλθε και έναν κατακερματισμό περιεχομένου) και η δεξιότητα γίνεται διαθέσιμη στους πράκτορες του χώρου εργασίας. Μια κάρτα με την ένδειξη Το όνομα χρησιμοποιείται σημαίνει ότι μια άλλη δεξιότητα κατέχει ήδη αυτό το όνομα τοπικά — απεγκαταστήστε πρώτα εκείνη.

Ενημέρωση δεξιοτήτων στον χρόνο

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

Απεγκατάσταση μιας δεξιότητας, αφαίρεση ενός αποθετηρίου

Η Απεγκατάσταση (στην προβολή λεπτομερειών μιας εγκατεστημένης δεξιότητας, ή διαγραφή στην καρτέλα Εγκατεστημένες) αφαιρεί μαζί τον κατάλογο της δεξιότητας και την καρφίτσα της στο αρχείο κλειδώματος — μια απεγκατεστημένη δεξιότητα δεν αφήνει τίποτα πίσω.

Η αφαίρεση ενός αποθετηρίου από τη στήλη αφαιρεί μόνο τον κατάλογο: οι δεξιότητες που εγκαταστήσατε από αυτό μένουν εγκατεστημένες και ενημερώνονται ακόμη, επειδή μια καρφίτσα καταγράφει το αποθετήριο κατά όνομα και όχι με αναφορά στην καταχώριση της πηγής. Προσθέστε ξανά το αποθετήριο αν θέλετε να το περιηγηθείτε πάλι.

Κλήση μιας δεξιότητας

Οι δεξιότητες καλούνται κάτω από τον δικό τους χώρο ονομάτων, οπότε δεν συγκρούονται ποτέ με τις ενσωματωμένες εντολές slash (/plan, /goal, /loop, /compact):

/skill:<name> — μια δεξιότητα εγκατεστημένη σε αυτόν τον χώρο εργασίας, ή συνδεδεμένη με τον πράκτορα
/skill:<repo>:<name> — μια δεξιότητα που παρέχει ένα αποθετήριο με checkout σε αυτόν τον χώρο

Ένα γυμνό μη ενσωματωμένο όνομα εξακολουθεί να επιλύεται, για μηνύματα γραμμένα πριν υπάρξει ο χώρος ονομάτων. Το /skill:plan είναι αυτό που φτάνει σε μια δεξιότητα με το όνομα plan· το /plan είναι πάντα η ενσωματωμένη εντολή.

Δεξιότητες ανά αποθετήριο

Ένα αποθετήριο με checkout μπορεί να παρέχει δικές του δεξιότητες, στους .agents/skills/, .agent/skills/, .claude/skills/, .opencode/skills/ ή skills/. Αυτές δεν εγκαθίστανται μέσω αυτής της σελίδας. Ένας πράκτορας φέρει μόνο τις δεξιότητες του αποθετηρίου στο οποίο εργάζεται αυτή τη στιγμή· αλλάζουν όταν μετακινείται. Το πεδίο σύνταξης μηνυμάτων δεν έχει τέτοια εμβέλεια: το /skill:<repo>:<name> φτάνει σε οποιοδήποτε αποθετήριο του χώρου.

Οι δεξιότητες αποθετηρίου περνούν την ίδια σάρωση με αποτυχία-κλεισίματος (pass / warn / quarantine) πριν το frontmatter τους φτάσει σε μια προτροπή. Το warn γίνεται δεκτό· το quarantine κρατείται, χωρίς παράκαμψη χειριστή σε αυτή τη διαδρομή.

Δείτε Δεξιότητες ανά αποθετήριο και Εντολές slash.

Σχετικοί οδηγοί

Σχετικές έννοιες

Το μοντέλο πρακτόρων