Skills

Le Skills di Verdent sono pacchetti di conoscenza riutilizzabili che estendono le competenze dell'agente. Ogni Skill contiene prompt specifici del dominio, script, riferimenti e best practice. Basta invocare una Skill per nome e l'agente carica il contesto corrispondente seguendo il flusso di lavoro predefinito.

Cosa sono le Skills?

Concetto di base

Una Skill è un pacchetto di conoscenza strutturato memorizzato in una cartella. Ogni Skill contiene un file SKILL.md che ne definisce il nome, la descrizione e il prompt dettagliato. Quando invochi una Skill in una conversazione, Verdent legge questo file e ne inserisce il contenuto nel contesto dell'agente.

Differenze tra Skills, sottoagenti e MCP

In sintesi: le Skills forniscono conoscenza e guida sui flussi di lavoro, i sottoagenti eseguono attività indipendenti e MCP collega strumenti e fonti di dati esterne.

Come usare le Skills

Invocare una Skill

Puoi invocare una Skill in due modi:

1. Menziona il nome della Skill nella conversazione

Use the skill-creator skill to help me create a new Skill

2. Usa la sintassi di menzione @

@skill-creator help me create a Skill for API documentation generation

Quando una Skill viene attivata:

1. L'agente chiama lo strumento skill per leggere il file SKILL.md della Skill
2. Il contenuto del file viene inserito nel contesto della conversazione corrente
3. L'agente prosegue il lavoro seguendo la guida della Skill

Sfogliare le Skills disponibili

Accedi al pannello Skills tramite le impostazioni:

1. Apri il menu Settings
2. Seleziona la scheda Skills
3. Sfoglia le Skills installate e quelle disponibili nello Skill Store

Puoi anche digitare @ nella casella di input per attivare il completamento automatico e selezionare rapidamente una Skill disponibile.

Skills integrate

Verdent include un insieme di Skills integrate che coprono i flussi di lavoro più comuni:

Creare Skills personalizzate

Puoi creare Skills personalizzate per racchiudere le competenze di dominio del tuo team o i flussi di lavoro specifici del progetto.

Struttura della cartella di una Skill

Una cartella Skill standard ha questo aspetto:

my-custom-skill/
├── SKILL.md              # Required: Skill definition file
├── agents/
│   └── verdent.yaml      # Optional: UI configuration (icons, display name)
├── scripts/              # Optional: helper scripts
└── references/           # Optional: reference docs or examples

Formato di SKILL.md

SKILL.md è il file principale della Skill e contiene un frontmatter YAML e un corpo Markdown:

---
name: my-custom-skill
description: A concise description shown in the Skill list
metadata:
  version: "1.0.0"
  author: "Your Name"
  license: "MIT"
---

# Detailed Instructions

This is the detailed prompt content the Agent reads.

## Workflow

1. Step one
2. Step two
3. ...

## Best Practices

- Practice suggestion 1
- Practice suggestion 2

Requisiti dei campi del frontmatter:

• name (obbligatorio): deve corrispondere al nome della cartella. Sono ammessi solo lettere minuscole, numeri e trattini (a-z0-9-). Lunghezza: 1–64 caratteri. Niente trattini consecutivi né trattini iniziali o finali.
• description (obbligatorio): una breve descrizione, massimo 1024 caratteri.
• metadata (opzionale): versione, autore, licenza e altre meta-informazioni.

Installare Skills personalizzate

Metodo 1: importazione tramite impostazioni

1. Apri Settings → Skills
2. Fai clic su Import Skill
3. Seleziona la cartella della Skill (o un archivio .zip / .skill)
4. Verdent convalida SKILL.md e la installa in ~/.verdent/skills/

Metodo 2: copia manuale

cp -r my-custom-skill ~/.verdent/skills/

La Skill diventa disponibile dopo aver riavviato Verdent o aggiornato l'elenco delle Skills.

Metodo 3: Skill a livello di progetto

Posiziona la Skill all'interno della cartella del progetto:

cp -r my-custom-skill /path/to/your/project/.verdent/skills/

Le Skills a livello di progetto sono visibili solo all'interno di quel progetto e hanno priorità sulle Skills globali con lo stesso nome.

Ambiti delle Skills

Verdent supporta tre livelli di ambito per le Skills:

Regole di priorità:

Quando esistono Skills con lo stesso nome in più ambiti:

• Il progetto ha la precedenza sul globale

Skill Store

Verdent offre uno Skill Store per sfogliare e installare Skills della community e ufficiali.

Sfogliare lo Skill Store

1. Apri Settings → Skills
2. Passa alla scheda Store
3. Sfoglia le Skills disponibili o usa la casella di ricerca

Installare dallo Store

1. Trova la Skill desiderata nello Store
2. Fai clic su Install
3. La Skill viene scaricata e installata automaticamente in ~/.verdent/skills/

Verifica di sicurezza:

Le Skills installate dallo Store sono sottoposte a verifica del checksum SHA256 per garantire l'integrità e la sicurezza dei file.

Esempi pratici

Esempio 1: creare una nuova Skill con skill-creator

@skill-creator help me create a Skill for guiding the team on writing Go unit tests

L'agente:

1. Legge il contenuto della Skill skill-creator
2. Ti guida nella compilazione del nome, della descrizione e del prompt principale della Skill
3. Genera un file SKILL.md standard
4. Suggerisce il percorso di installazione e i passaggi di verifica

Esempio 2: analizzare dati con spreadsheet

@spreadsheet read sales-2025.xlsx from the project root, analyze Q1 sales trends, and generate a chart

L'agente:

1. Carica la Skill spreadsheet
2. Usa pandas e openpyxl per leggere il file Excel
3. Analizza i dati e genera visualizzazioni
4. Salva i risultati o li mostra nella conversazione

Esempio 3: correggere la CI con gh-fix-ci

@gh-fix-ci my PR #123 GitHub Actions tests are failing, help me debug

L'agente:

1. Usa la CLI di gh per recuperare i log della CI per la PR #123
2. Analizza il fallimento (ad es. errori nei casi di test, problemi di dipendenze)
3. Propone una correzione
4. Con la tua approvazione, modifica il codice e invia la correzione

Domande frequenti

Uso avanzato

Incorporare script nelle Skills

Aggiungi una cartella scripts/ alla tua Skill e fai riferimento agli script in SKILL.md:

## Data Processing Script

Run the following command to process data:

\`\`\`bash
python scripts/process_data.py --input data.csv --output results.json
\`\`\`

L'agente legge questa istruzione ed esegue lo script quando necessario.

Riferimenti alla documentazione

Memorizza documentazione API, specifiche o codice di esempio in una cartella references/ e collegali in SKILL.md:

## Reference Documentation

See [references/api-spec.md](references/api-spec.md) for the detailed API specification.

L'agente può leggere questi file di riferimento in base alle istruzioni della Skill.

Best practice

Vedi anche