Ce face Crearea unui skill (.agents/skills/)
Skills sunt un standard deschis pentru extinderea agentului. Un skill de proiect stă în .agents/skills/<nume-skill>/, iar unul global pentru CLI în ~/.gemini/antigravity-cli/skills/<nume-skill>/. Folderul vechi .agent/skills este încă acceptat.
SKILL.md începe cu un antet YAML. description este obligatoriu: este textul pe care agentul îl vede la începutul conversației și după care decide dacă folosește skill-ul. name este opțional (litere mici, cratime) și implicit este numele folderului. Directoarele scripts/, examples/ și resources/ sunt opționale.
Agentul citește instrucțiunile complete doar când skill-ul pare relevant (progressive disclosure). Poți rula și explicit skill-ul cu /<nume-skill>; după modificări, /skills reload îl reîncarcă.
Sintaxă și opțiuni
| Opțiune / Parametru | Descriere |
|---|---|
description |
Obligatoriu. Ce face skill-ul și când se folosește. |
name |
Opțional. Implicit numele folderului. |
scripts/ |
Scripturi pe care agentul le poate rula. |
examples/ |
Implementări de referință. |
resources/ |
Șabloane, scheme sau date. |
Exemple practice
Exemplul 1: Un skill pentru deploy pe Kubernetes
# .agents/skills/k8s-deployer/SKILL.md
---
name: k8s-deployer
description: Verifies Helm manifests, applies them to the staging cluster and checks pod status. Use when the user asks for a Kubernetes deploy.
---
# Kubernetes Deployment Workflow
1. Run helm lint before applying.
2. Run scripts/diff_check.py --help, then check the resource diff.
3. Confirm that all pods are Running.Greșeli frecvente și bune practici
- Scrii o descriere generică. Agentul nu știe când să activeze skill-ul; include cuvintele cheie ale sarcinii.
- Pui în
descriptionun text cu două puncte fără ghilimele. Versiunile dinainte de 1.3.6 nu încărcau skill-ul; pune textul între ghilimele. - Pui parole sau chei în
SKILL.md. Folosește variabile de mediu.