Δημιουργία δεξιότητας με το SKILL.md
Σε αυτήν τη σελίδα
Μάθημα ενημερώθηκε στις 2 Νοεμβρίου 2026 βάσει της σελίδας Skills στην τεκμηρίωση του Vibe: μια δεξιότητα είναι ένα σύνολο οδηγιών (δεν προσθέτει εργαλεία), το πεδίο
allowed-toolsδιαβάζεται αλλά δεν επιβάλλεται, και έχουν προστεθεί δύο πεδία (disable-model-invocation,compatibility). Πηγή: Skills.
Δεξιότητες: Επαναχρησιμοποιήσιμα στοιχεία
Οι πράκτορες ορίζουν ποιος εκτελεί μια εργασία. Οι δεξιότητες ορίζουν τι: είναι επαναχρησιμοποιήσιμα σύνολα οδηγιών που προσθέτουν διαδικασίες και εντολές slash στο Mistral Vibe. Η διάκριση γίνεται απτή όταν την εφαρμόζετε στην ομάδα σας: ένας πράκτορας αντανακλά μια προσωπική στάση εργασίας, ενώ μια δεξιότητα ενσωματώνει μια διαδικασία που όλοι πρέπει να εκτελούν με τον ίδιο τρόπο.
Μια δεξιότητα είναι ένας κατάλογος που περιέχει ένα αρχείο SKILL.md με frontmatter YAML. Αυτή η δομή ακολουθεί την ανοιχτή προδιαγραφή Agent Skills, καθιστώντας τις δεξιότητες φορητές και κοινόχρηστες: ο ίδιος φάκελος λειτουργεί στον υπολογιστή του συναδέλφου σας χωρίς προσαρμογές.
Ανατομία ενός SKILL.md
Ακολουθεί η πλήρης δομή μιας δεξιότητας, εικονογραφημένη από ένα παράδειγμα αυτοματοποιημένης αναθεώρησης κώδικα:
---
name: code-review
description: Performs automated code reviews with quality analysis
license: MIT
user-invocable: true
allowed-tools:
- read_file
- grep
- ask_user_question
---
# Code Review Skill
This skill analyzes source code quality by checking:
1. **Naming conventions** — variables, functions, classes
2. **Cyclomatic complexity** — functions that are too long or nested
3. **Duplication** — copy-pasted code to refactor
4. **Security** — dangerous patterns (eval, SQL injection, XSS)
## Usage
Run `/code-review` followed by the path or description of the code to analyze.
## Output format
The report is structured in three levels:
- 🔴 **Critical** — fix immediately
- 🟡 **Warning** — fix before merging
- 🟢 **Suggestion** — optional improvement
Τα πεδία του frontmatter YAML
Το πεδίο name είναι το μοναδικό αναγνωριστικό της δεξιότητας. Χρησιμοποιείται για την ενεργοποίηση, απενεργοποίηση και αναφορά της δεξιότητας στις ρυθμίσεις. Αυτό το όνομα γίνεται επίσης η εντολή slash, οπότε αξίζει να το κρατήσετε σύντομο.
name: code-review
Το description, έως 1.024 χαρακτήρες, είναι η φράση που εμφανίζεται όταν το Vibeαναφέρει τις διαθέσιμες δεξιότητες. Γράψτε το από την οπτική γωνία κάποιου που αναζητά: πρέπει να του επιτρέπει να επιλέξει μεταξύ δύο παρόμοιων δεξιοτήτων χωρίς να ανοίξει τα αρχεία.
description: Performs automated code reviews with quality analysis
Το πεδίο license υποδεικνύει την άδεια χρήσης της δεξιότητας, κάτι που γίνεται σημαντικό μόλις την κοινοποιήσετε πέρα από τον δικό σας σταθμό εργασίας.
license: MIT
Το boolean user-invocable, που είναι true από προεπιλογή, εκθέτει τη δεξιότητα ως εντολή slash. Ορίστε το σε false για να την κρύψετε από το μενού /: ο πράκτορας μπορεί ακόμα να τη φορτώσει αυτόματα όταν η εργασία ταιριάζει.
user-invocable: true # Accessible via /code-review
user-invocable: false # Hidden from / menu, agent can still load it
Το πεδίο disable-model-invocation, όταν οριστεί σε true, εμποδίζει τον πράκτορα να φορτώσει τη δεξιότητα μόνος του: εκτελείται μόνο αν πληκτρολογήσετε εσείς /skill-name. Προορίστε το για διαδικασίες που κανένα μοντέλο δεν πρέπει να ενεργοποιήσει χωρίς τη ρητή συγκατάθεσή σας, όπως μια ανάπτυξη (deployment).
disable-model-invocation: true
Δύο πληροφοριακά πεδία ολοκληρώνουν τη λίστα: το compatibility, το οποίο σημειώνει τις προαπαιτούμενες συνθήκες («Requires git»), και το allowed-tools, το οποίο παραθέτει τα εργαλεία που η δεξιότητα προτίθεται να χρησιμοποιήσει. Προσοχή στο τελευταίο: η τεκμηρίωση διευκρινίζει ότι το Vibe το διαβάζει αλλά δεν το επιβάλλει. Μια δεξιότητα μπορεί να καλέσει οποιοδήποτε εργαλείο που εξουσιοδοτεί ο ενεργός πράκτορας. Για να περιορίσετε τι μπορεί να κάνει μια δεξιότητα, περιορίστε τα εργαλεία και τις άδειες του πράκτορα (Μαθήματα 2 και 3).
allowed-tools:
- read_file
- grep
- ask_user_question
Το σώμα του SKILL.md
Μετά το frontmatter, το σώμα του αρχείου είναι ελεύθερο Markdown. Λειτουργεί ταυτόχρονα ως τεκμηρίωση και prompt: το Vibe το διαβάζει για να κατανοήσει πώς λειτουργεί η δεξιότητα και σε ποιο πλαίσιο να την εφαρμόσει. Εδώ περιγράφετε τι κάνει η δεξιότητα, τα βήματα λειτουργίας της, την αναμενόμενη μορφή εξόδου και παραδείγματα χρήσης. Ένα ασαφές σώμα οδηγεί σε μια απρόβλεπτη δεξιότητα· ένα ακριβές σώμα οδηγεί σε μια δεξιότητα που παράγει το ίδιο αποτέλεσμα εβδομάδα με την εβδομάδα.
Δημιουργήστε την πρώτη σας δεξιότητα
Ας χτίσουμε μια δεξιότητα δημιουργίας δοκιμών. Ξεκινήστε δημιουργώντας τον κατάλογό της:
mkdir -p ~/.vibe/skills/test-generator
Τοποθετήστε το ακόλουθο SKILL.md μέσα σε αυτόν. Παρατηρήστε πώς το σώμα απαντά σε ερωτήσεις που διαφορετικά το Vibe θα έπρεπε να μαντέψει: ποιο framework να επιλέξει, πώς να ονομάσει τα μπλοκ, πού να γράψει το αρχείο εξόδου.
---
name: test-generator
description: Generates unit tests for TypeScript/JavaScript functions
license: MIT
user-invocable: true
allowed-tools:
- read_file
- write_file
- grep
---
# Test Generator
Generates comprehensive unit tests for
TypeScript and JavaScript functions.
## Process
1. Read the target source file
2. Identify all exported functions
3. For each function, generate:
- Happy path test
- Test with empty/null inputs
- Edge case tests
- Expected error tests
4. Write tests to an adjacent `.test.ts` file
## Conventions
- Framework: Vitest (default) or Jest if detected
- Naming: `describe` per function, `it` per test case
- Assertions: `expect` with precise matchers
- No mocks unless necessary (external dependencies)
## Example
For a file `utils/math.ts` containing `add(a, b)`,
the skill generates `utils/math.test.ts` with corresponding tests.
Μόλις δημιουργηθεί το αρχείο, η δεξιότητα είναι άμεσα διαθέσιμη: καμία εντολή εγκατάστασης, καμία επανεκκίνηση. Εκκινήστε το Vibe και καλέστε το σε ένα πραγματικό αρχείο.
vibe
# > /test-generator src/utils/math.ts
Το Vibe φορτώνει τη δεξιότητα, διαβάζει το SKILL.md της για να κατανοήσει την αναμενόμενη συμπεριφορά και εκτελεί την εργασία με τα εξουσιοδοτημένα εργαλεία. Αφιερώστε χρόνο για να διαβάσετε το αποτέλεσμα: συγκρίνοντας την έξοδο με αυτό που φανταστήκατε, θα βελτιώσετε το σώμα του αρχείου.
Βέλτιστες πρακτικές
Τηρήστε τον κανόνα «μία δεξιότητα ανά λειτουργία». Η ανάμειξη αναθεώρησης κώδικα και δημιουργίας δοκιμών σε ένα ενιαίο αρχείο παράγει ένα prompt που αμφιταλαντεύεται και σας εμποδίζει να απενεργοποιήσετε το ένα χωρίς να χάσετε το άλλο. Ομοίως, περιορίστε τα εξουσιοδοτημένα εργαλεία σε αυτά που η δεξιότητα χρειάζεται πραγματικά.
Το υπόλοιπο εξαρτάται από την ποιότητα της συγγραφής. Το σώμα του SKILL.md είναι το prompt σας: να είστε ακριβείς και να συμπεριλαμβάνετε συγκεκριμένα παραδείγματα του τι παράγει η δεξιότητα—ένα παράδειγμα εξόδου αξίζει περισσότερο από τρεις γραμμές περιγραφής. Τέλος, δοκιμάστε τη δεξιότητά σας σε πολλές περιπτώσεις, συμπεριλαμβανομένης μιας δύσκολης, πριν την κοινοποιήσετε στην ομάδα.
Βασικά σημεία
- Μια δεξιότητα είναι ένας κατάλογος με ένα αρχείο
SKILL.mdπου περιέχει ένα frontmatter YAML - Το frontmatter ορίζει το όνομα, την περιγραφή, τα επιτρεπόμενα εργαλεία και τη δυνατότητα κλήσης
- Το σώμα Markdown λειτουργεί ταυτόχρονα ως τεκμηρίωση και ως prompt για το Vibe
- Το
user-invocable: trueκαθιστά τη δεξιότητα προσβάσιμη μέσω εντολής slash - Δημιουργήστε εξειδικευμένες δεξιότητες με τα ελάχιστα απαραίτητα εργαλεία