Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

Le Skills sono definite come file SKILL.md all’interno di una directory con un nome specifico. Questa pagina illustra tutto ciò che devi sapere per scrivere skills efficaci.

​
Struttura dei file

Colloca le skills nella directory appropriata in base all’ambito: 
# Specifico del progetto (commit su git)
.devin/skills/
└── my-skill/
    └── SKILL.md

# Globale — disponibile in tutti i progetti (non in commit)
# Linux/macOS:
~/.config/devin/skills/
└── my-skill/
    └── SKILL.md

# Windows:
%APPDATA%\devin\skills\
└── my-skill\
    └── SKILL.md
Il nome della directory è l’identificatore della skill (usato per richiamare /my-skill). Il file SKILL.md contiene un frontmatter YAML facoltativo e il contenuto del prompt della skill.
Su Windows, %APPDATA% corrisponde in genere a C:\Users\<YourUser>\AppData\Roaming.

​
Riferimento del frontmatter

---
name: my-skill
description: What this skill does (shown in completions)
argument-hint: "[file] [options]"
model: sonnet
subagent: true
allowed-tools:
  - read
  - grep
  - glob
  - exec
permissions:
  allow:
    - Read(src/**)
  deny:
    - exec
  ask:
    - Write(**)
triggers:
  - user
  - model
---

Your prompt content goes here...

​
Tutti i campi del frontmatter

CampoTipoPredefinitoDescrizione
namestringnome della directoryNome visualizzato della skill
descriptionstringnessunoMostrata nei completamenti degli Slash Command
argument-hintstringnessunoSuggerimento mostrato dopo il nome del comando (ad es. [filename])
modelstringmodello correnteSovrascrive il modello usato per eseguire questa skill
subagentbooleanfalseEsegue la skill come subagent invece che inline
agentstringnessunoEsegue la skill come subagent usando un profilo subagent personalizzato specifico
allowed-toolslistatutti gli strumentiLimita gli strumenti che la skill può usare
permissionsoggettoereditaSovrascritture delle autorizzazioni per questa skill
triggerslista[user, model]Come può essere invocata la skill

​
Override del modello

Usa il campo model per eseguire una skill con un modello diverso da quello attivo nella sessione corrente. È utile se vuoi usare un modello più rapido per attività semplici o uno più potente per quelle complesse: 
---
name: quick-fix
description: Fast lint fix using a lightweight model
model: swe
---

Fix the lint errors in the current file.
Il nome del modello utilizza gli stessi valori del flag CLI --model (ad es. opus, sonnet, swe, codex). Consulta Models per l’elenco completo. Una volta completata la skill, la sessione torna al modello precedentemente attivo.

​
Eseguire le skill come subagent

L’esecuzione delle skill come subagent è sperimentale. I campi subagent e agent del frontmatter potrebbero cambiare nelle versioni future.
Per impostazione predefinita, il prompt di una skill viene iniettato nella conversazione corrente e l’agente lo elabora inline. In alternativa, puoi eseguire una skill come subagent, che avvia un processo indipendente con una propria finestra di contesto. Questa opzione è utile per skill che svolgono attività mirate e autonome, quando non vuoi che l’output appesantisca la conversazione principale. Esistono due modi per eseguire una skill come subagent:

​
subagent: true

Imposta subagent: true per eseguire la skill come subagent usando il profilo predefinito subagent_general: 
---
name: deep-research
description: Thorough codebase research on a topic
subagent: true
model: sonnet
allowed-tools:
  - read
  - grep
  - glob
---

Research the following topic thoroughly: $ARGUMENTS

Search broadly, follow references, and trace call chains.
Report all findings with specific file paths and line numbers.
Quando viene invocata, questa skill avvia un subagent in foreground che esegue il prompt della skill come attività. L’agent principale attende che il subagent termini, quindi ne legge e riassume i risultati.

​
agent: <profile>

Utilizza il campo agent per eseguire la skill come subagent con un profilo personalizzato del subagent: 
---
name: review-pr
description: Review the current PR using the reviewer subagent
agent: reviewer
---

Review the staged changes for correctness, security, and style issues.
Il valore agent deve corrispondere al nome di un profilo subagent registrato (integrato, come subagent_explore / subagent_general, oppure un profilo personalizzato che hai definito). Il subagent eredita il system prompt del profilo, le restrizioni sugli strumenti e il modello, mentre il contenuto della skill diventa l’attività.
Se sono impostati sia agent sia subagent, agent ha la precedenza. Il campo model della skill esegue l’override del modello del profilo subagent quando sono specificati entrambi.
Le skill eseguite come subagent non generano subagent nidificati: se la skill è già in esecuzione all’interno di un subagent, viene invece eseguita inline per evitare una ricorsione infinita.

​
Orchestrare i subagenti con le skill

Poiché le skill possono essere eseguite come subagenti, puoi usarle per orchestrare attività articolate in più passaggi. Definisci un insieme di skill di subagent, ciascuna dedicata a un’attività specifica, quindi scrivi una normale skill che le invochi. La skill esterna diventa l’orchestratore: richiama ogni subagent, raccoglie i risultati e decide cosa fare successivamente. Ad esempio, ecco due skill di subagent e un orchestratore che le coordina: 
---
name: research-changes
description: Research recent code changes and their impact
subagent: true
allowed-tools:
  - read
  - grep
  - glob
  - exec
---

Analyze the recent changes in this repository:

1. Run `git log --oneline -20` to see recent commits
2. For each significant commit, examine what changed and why
3. Identify any patterns, risks, or areas that need attention

Report your findings with specific file paths and commit references.

---
name: validate-tests
description: Run tests and validate coverage for recent changes
subagent: true
allowed-tools:
  - read
  - grep
  - glob
  - exec
---

Validate the test suite for the project:

1. Identify the test framework and run command
2. Run the full test suite
3. Check for any failing tests
4. Review test coverage for recently changed files

Report which tests pass, which fail, and any coverage gaps.

---
name: health-check
description: Full project health check — research changes then validate tests
---

Perform a full health check on this project:

1. First, use the /research-changes skill to understand recent changes
2. Then, use the /validate-tests skill to verify the test suite
3. Finally, synthesize the findings from both into a summary:
   - What changed recently and why
   - Whether tests are passing
   - Any risks or recommended actions
Invocare /health-check esegue l’orchestratore nell’agente principale. Questo richiama /research-changes, che genera un subagent per esplorare la repo. Una volta completato, richiama /validate-tests, che genera un altro subagent per eseguire i test. L’orchestratore sintetizza quindi entrambi i risultati in un riepilogo finale. Una skill di un subagent non utilizza mai un subagent quando richiama altre skill, anche se queste hanno subagent: true: vengono invece eseguite inline. Questo significa che non devi preoccuparti di un annidamento illimitato. Il modello di orchestrazione ha sempre un solo livello di profondità: l’orchestratore genera i subagent e questi eseguono tutto il resto inline.

​
Contenuto del prompt

Il contenuto del file SKILL.md (dopo il frontmatter) è il prompt che viene aggiunto quando la skill viene invocata.

​
Contenuto dinamico

Le skill supportano tre tipi di contenuto dinamico nel corpo del prompt:
Inserisci gli argomenti forniti dall’utente:
---
name: explain
argument-hint: "[file]"
---

Please explain the code in $1 in detail.
All arguments: $ARGUMENTS
  • $1, $2, ecc. — Singoli argomenti posizionali
  • $ARGUMENTS — Tutti gli argomenti in un’unica stringa

​
Autorizzazioni

Le Skills possono definire il proprio ambito di autorizzazione usando la stessa sintassi della configurazione principale delle autorizzazioni: 
permissions:
  allow:
    - Read(src/**)
    - Exec(npm run test)
  deny:
    - Write(/etc/**)
    - exec
  ask:
    - Write(src/**)
Come funzionano le autorizzazioni delle skill:
  • allow — Questi ambiti vengono approvati automaticamente durante l’esecuzione della skill
  • deny — Questi ambiti vengono bloccati durante l’esecuzione della skill
  • ask — Questi ambiti richiedono sempre la conferma dell’utente
Le autorizzazioni delle skill sono cumulative rispetto alle autorizzazioni di base della sessione (non le sostituiscono). Una skill non può concedere autorizzazioni negate a un livello superiore (configurazione del progetto o dell’organizzazione).

​
Strumenti consentiti

Limita gli strumenti che la skill può usare: 
allowed-tools:
  - read
  - grep
  - glob
Nomi dei tool disponibili: read, edit, grep, glob, exec Puoi anche consentire i tool MCP: 
allowed-tools:
  - read
  - mcp__github__list_issues
  - mcp__github__create_issue
Se allowed-tools non è specificato, la skill ha accesso a tutti gli strumenti. Per le skill critiche dal punto di vista della sicurezza, limita sempre l’accesso al minimo necessario.

​
Esempi

​
Skill per la revisione del codice

---
name: review
description: Review staged changes for issues
allowed-tools:
  - read
  - grep
  - glob
  - exec
permissions:
  allow:
    - Exec(git diff)
    - Exec(git log)
---

Review the current changes for quality issues:

!`git diff --staged`

Evaluate:
1. **Correctness** — Any logic errors or edge cases?
2. **Security** — Any vulnerabilities introduced?
3. **Performance** — Any obvious inefficiencies?
4. **Style** — Consistent with the codebase?

Provide a summary with specific line references.

​
Generatore di componenti

---
name: component
description: Generate a React component from a description
argument-hint: "<ComponentName>"
allowed-tools:
  - read
  - edit
  - grep
  - glob
model: sonnet
permissions:
  allow:
    - Write(src/components/**)
---

Create a new React component named `$1`:

1. Check existing components in src/components/ for style conventions
2. Create the component file at src/components/$1/$1.tsx
3. Create a barrel export at src/components/$1/index.ts
4. Add basic tests at src/components/$1/$1.test.tsx
5. Follow the patterns you find in existing components

​
Checklist per la distribuzione

---
name: deploy
description: Esegui la checklist di distribuzione
triggers:
  - user
allowed-tools:
  - read
  - exec
  - grep
permissions:
  allow:
    - Exec(npm run)
    - Exec(git)
---

Esegui la checklist di distribuzione:

1. Esegui la suite di test: `npm run test`
2. Esegui il linter: `npm run lint`
3. Verifica le modifiche non committate: `git status`
4. Verifica la build: `npm run build`
5. Mostra il branch corrente e l'ultimo commit

Riporta lo stato di ogni passaggio. Se qualcosa fallisce, interrompi e spiega il problema.

​
Esperto di ricerca

---
name: find
description: Find relevant code across the project
argument-hint: "<what to find>"
allowed-tools:
  - read
  - grep
  - glob
triggers:
  - user
  - model
---

Search the codebase thoroughly for: $ARGUMENTS

Use grep for content search and glob for file discovery.
Provide relevant file paths and code snippets.
Explain how the pieces connect.

​
Suggerimenti

Mantieni i prompt focalizzati

Una skill dovrebbe fare bene una sola cosa. Crea più skill invece di un’unica mega-skill.

Includi esempi

Nel prompt, mostra all’agente che aspetto dovrebbe avere un buon output.

Usa allowed-tools

Limitare i tool rende le skill più sicure e prevedibili.

Prova con /skill-name

Invoca la tua skill e perfeziona il prompt finché l’output non è quello che vuoi.