Sistemul de Skills (Abilități) este mecanismul prin care extinzi capabilitățile cognitive ale lui Google Antigravity pe propriul proiect. O abilitate este un pachet modular stocat în directorul .agents/skills/<nume-skill>/ care învață agentul cum să execute un flux de lucru particular din compania ta.
Nucleul fiecărei abilități este fișierul SKILL.md, compus dintr-un antet YAML (conținând `name` și `description`) și un ghid tehnic detaliat în Markdown. Descrierea din YAML este crucială: Antigravity o citește la fiecare pas și știe exact când sarcina utilizatorului se potrivește cu acea abilitate pentru a o activa automat.
O abilitate completă poate include directoare de suport: `scripts/` (utilitare Python sau Bash pe care agentul le poate rula direct), `examples/` (implementări de referință) și `references/` (manuale și specificații de API).
Sintaxă, opțiuni și concepte cheie
| Opțiune / Concept | Descriere practică |
|---|---|
YAML Frontmatter |
Blocul obligatoriu `– name: … description: … –` de la începutul fișierului SKILL.md. |
Trigger Semantic |
Descrierea exactă a contextului când agentul trebuie să activeze abilitatea. |
scripts/ |
Director cu scripturi autonome pe care agentul le apelează prin linia de comandă. |
Progressive Disclosure |
Încărcarea detaliilor și a scripturilor doar când abilitatea este activată, economisind contextul de lucru. |
Exemple practice de terminal și cod
Exemplul 1: Exemplu de fișier SKILL.md pentru un proces automat de deploy pe Kubernetes
Cum se structurează un skill profesional în proiect.
# .agents/skills/k8s-deployer/SKILL.md
---
name: k8s-deployer
description: >-
Fluxul de lucru pentru verificarea manifestelor Helm, aplicarea pe clusterul de staging
și verificarea stării pod-urilor după lansare. Folosește acest skill când utilizatorul
cere deploy pe Kubernetes sau verificarea clusterului.
---
# Kubernetes Deployment Workflow
## 1. Pași Obligatorii de Siguranță
1. Rulează întotdeauna `helm lint` înainte de aplicare.
2. Verifică diff-ul resurselor cu scriptul atașat:
```bash
python3 .agents/skills/k8s-deployer/scripts/diff_check.py
```
3. Verifică că toate pod-urile sunt în starea `Running`.Rezultat & Impact
Agentul devine un expert certificat în procedurile specifice de infrastructură ale echipei tale.Greșeli frecvente și bune practici
- Omiterea descrierii clare din YAML frontmatter; dacă descrierea este generică, agentul nu va ști când să activeze abilitatea.
- Hardcodarea de parole sau chei secrete în interiorul fișierelor SKILL.md în loc de utilizarea variabilelor de mediu.