◆ Sparround

SKILL.md anatomiyası

Skill iki hissədən ibarətdir:

1. YAML frontmatter (--- arasında) — metadata. Ən vacib sahə description: agent məhz ona baxaraq skill-i nə vaxt yükləyəcəyinə qərar verir.

2. Markdown gövdə — agentin izləyəcəyi təlimatlar.

Qovluğun adı çağırış adına çevrilir: .claude/skills/compose-review/SKILL.md faylı /compose-review əmrini yaradır.

markdown
---
description: Reviews a Compose screen — recomposition, state hoisting, modifier order and previews. Use when the user asks for a Compose UI review or adds a new Composable.
allowed-tools: Read, Grep, Glob
---

## Changed files

!`git diff --name-only main -- '*.kt'`

## Review steps

Read the files above that contain Composables and check each one:

1. **State hoisting** — if the Composable holds its own state it cannot
   be reused. The state should be hoisted.
2. **Recomposition** — is there computation directly in the Composable
   body? It belongs in `remember` or the ViewModel.
3. **Modifier** — is it accepted as a parameter and applied first in
   the modifier chain?
4. **Preview** — does every public Composable have a `@Preview`?

Report each finding as `file:line`. Do not modify files —
report only.

Real skill nümunəsi. `!`git diff...`` sətri **dinamik kontekst injeksiyasıdır**: agent skill-i oxumazdan əvvəl əmr işə düşür və nəticəsi mətnə qoyulur.

Frontmatter sahəsiNə edir
`description`Skill nə edir və nə vaxt işlədilməlidir. Agent qərarı buna əsaslanır — ən vacib sahə.
`when_to_use`Əlavə tetikleyici ifadələr və nümunə sorğular.
`allowed-tools`Skill işləyərkən soruşmadan istifadə edilə bilən alətlər.
`disallowed-tools`Skill aktiv ikən tamamilə çıxarılan alətlər.
`disable-model-invocation``true` — yalnız siz `/ad` ilə çağıra bilərsiniz, agent özü yox.
`model` / `effort`Skill aktiv ikən model və səy səviyyəsi.
`context: fork`Skill-i ayrıca alt-agent kontekstində icra edir.
`paths`Glob-lar — skill yalnız uyğun fayllarla işləyəndə avtomatik yüklənir.

description sahəsini istifadəçinin dilində yazın, öz dilinizdə yox. "Compose review edir" zəifdir; "İstifadəçi Compose UI review istəyəndə və ya yeni Composable əlavə edəndə işlət" güclüdür — çünki real sorğulara uyğun gəlir. description və when_to_use birlikdə siyahıda müəyyən uzunluqdan sonra kəsilir, ona görə ən vacib istifadə halını əvvəldə yazın.

Gövdədə istifadə edilə bilən əlavə mexanizmlər:

  • Dinamik kontekst injeksiyası — ` !əmr ` sətri agent skill-i oxumazdan əvvəl işə düşür və çıxışı mətnə qoyulur.
  • Arqumentlər — $ARGUMENTS, $0, $1 və ya frontmatter-də adlandırılmış arqumentlər.
  • Dəyişənlər — ${CLAUDE_PROJECT_DIR}, ${CLAUDE_SKILL_DIR} kimi yolları göstərmək üçün.
  • Köməkçi fayllar — skill qovluğunda reference.md, scripts/ və s. Onlar yalnız agent onlara müraciət edəndə oxunur.

📚 Mənbələr və sənədlər