Claude Code skills: paano gumagana ang mga skill, SKILL.md, at kailan ito kinukuha ng agent

Ano ang skills sa Claude Code

Ang skill ay folder na may file na SKILL.md, kung saan nakasulat ang tagubilin para sa isang uri ng gawain: paano i-deploy ang proyekto, paano magsagawa ng review, paano maglabas ng release. Alam ng agent na may skill mula sa simula ng session, pero binabasa lang niya ito nang buo kapag talagang kailangan ng gawain.

Nilulutas ng Claude Code skills ang problemang pamilyar sa sinumang matagal nang nagmamantine ng CLAUDE.md: lumalaki ang file ng tagubilin. Isang proseso ng deploy na 80 linya ay kailangan minsan sa isang linggo, pero sa bawat session ay umuukupa ito ng espasyo sa context, kahit kapag nag-aayos lang ng typo sa README. Inililipat ng skill ang ganitong proseso mula sa palaging context papunta sa on-demand na pagkuha.

Mga bahagi ng isang skill

Ang pinakasimpleng skill ay isang folder at isang file. Ang mga skill ng proyekto ay nasa repositoryo, ang mga personal ay nasa home directory ng user:

.claude/skills/deploy/SKILL.md      # skill ng proyekto, shared ng team sa pamamagitan ng git
~/.claude/skills/review/SKILL.md    # personal na skill, available sa lahat ng proyekto

Maaari kang maglagay ng mga pantulong na file sa tabi ng SKILL.md: mga template, script, at sanggunian. Bubuksan ito ng agent kung ire-refer ito ng pangunahing teksto ng skill at kung kailangan ito:

.claude/skills/deploy/
├── SKILL.md           # pangunahing tagubilin
├── checklist.md       # detalyadong checklist, binabasa sa pamamagitan ng link
└── rollback.sh        # script ng rollback

Frontmatter: name at description

Nagsisimula ang file sa YAML block sa pagitan ng mga linyang ---. Ang dalawang field na pinakamahalaga ay: name — maikling pangalan ng skill, at description — paglalarawan ng ginagawa ng skill at kung kailan ito gagamitin.

---
name: deploy
description: Pag-deploy ng site sa hosting sa pamamagitan ng FTP. Gamitin kapag kailangang i-upload ang mga pagbabago sa server, suriin ang pagkakaiba sa server, o i-rollback ang deploy.
---

# Deploy

1. Una, pasubok na pagpapatakbo: `./deploy.sh -n`.
2. Suriin ang listahan ng file: wala dapat dito ang mga secret at test script.
3. I-upload: `./deploy.sh`.
4. Buksan ang mga binagong pahina at siguraduhing 200 ang sagot ng mga ito.

Rollback — tingnan ang rollback.sh sa folder na ito.

Sa ibaba ng frontmatter ay karaniwang Markdown: mga hakbang, command, limitasyon, at link sa mga kalapit na file. Isulat ito gaya ng pagsulat ninyo ng tagubilin para sa bagong kasamahang gagawa ng gawaing ito sa unang pagkakataon.

Kailan kinukuha ng agent ang skill

Sa simula ng session, ang pumapasok lamang sa context ay ang pangalan at paglalarawan ng bawat available na skill. Ilang linya lang bawat skill, kaya kayang panatilihin ang sampu-sampu nito. Kapag tumugma ang kahilingan ng user o ang kasalukuyang hakbang sa paglalarawan, tinatawag ng agent ang skill, at saka lamang pumapasok sa context ang buong SKILL.md.

Mula dito ang pangunahing praktikal na panuntunan: tumatama ang skill ayon sa paglalarawan. Hindi nakikita ng agent ang katawan ng skill hangga't hindi niya nagpapasyang buksan ito. Kung nakasulat sa description ang "Pantulong na skill", hindi malalaman ng agent kung kailan ito kailangan. Kung nakasulat ang "Deploy sa hosting; gamitin kapag kailangang i-upload ang mga pagbabago sa server o i-rollback" — malalaman niya.

Bukod sa awtomatikong pagpili, maaaring tawagin ang skill nang tahasan sa pangalan gamit ang slash, halimbawa /deploy. Kapaki-pakinabang ito kapag alam ninyo nang eksakto kung aling proseso ang kailangan at ayaw ninyong umasa na itutugma ito ng agent sa paglalarawan.

Paano sumulat ng description para tumama ang skill

• Ano ang ginagawa — isang pariralang may pandiwa: "Pag-deploy ng site", "Pagre-review ng mga pagbabago bago mag-commit".
• Kailan gamitin — ilista ang mga pariralang aktwal na ginagamit ng user sa paghingi ng gawain: "i-upload sa server", "ilabas", "i-rollback".
• Kailan hindi gamitin, kung madaling malito sa katabing skill: "hindi para sa deploy ng bot, para lang sa site".
• Walang malalabong salita gaya ng "kapaki-pakinabang na skill" at "tumutulong sa trabaho" — walang dalang senyales ang mga ito.

Progressive disclosure

Nakabatay ang skills sa prinsipyo ng progressive disclosure: inilalabas ang impormasyon sa mga patong, at bawat susunod na patong ay kinukuha lamang kapag kailangan.

Pareho ito ng ideya ng router sa halip na pader ng teksto sa file ng tagubilin: nasa kamay palagi ang maikling mapa, at ang detalye ay nasa link. Ang pagkakaiba, ginagawa ng skill ang ganitong pagkuha bilang regular na mekanismo, hindi umaasang bubuksan ng agent ang tamang dokumento. Dagdag pa, maaaring patakbuhin lang ng agent ang script mula sa patong 3 nang hindi kinakarga ang buong code nito sa context.

Skills, CLAUDE.md, at slash command: ano ang pagkakaiba

Lahat ng tatlong mekanismo ay nagbibigay ng tagubilin sa agent, pero sa magkakaibang sandali at may magkakaibang gastos sa context.

Simple ang praktikal na panuntunan sa pagpili. Kung kailangan ang tagubilin halos sa bawat gawain, dapat ito sa CLAUDE.md. Kung kailangan ito sa mga gawain ng isang partikular na uri, ito ay skill. Kung paulit-ulit ninyong tina-type ang iisang mahabang request, ito ay kandidato para sa command o skill na tinatawag nang manu-mano.

Huwag ilagay sa skill ang mahigpit na pagbabawal. Maaaring hindi ma-load ang skill, pero dapat laging umiral ang panuntunang "huwag kailanman mag-commit ng secret." Ang mga ganitong di-nagbabagong patakaran ay nananatili sa CLAUDE.md at, kung posible, sinusuportahan ng mekanismo: hooks, karapatan ng access, at mga pagsusuri sa CI.

Paano gumawa ng skill para sa Claude Code: hakbang-hakbang

1. Hanapin ang paulit-ulit na proseso. Magandang senyales na tatlong beses na ninyong ipinaliwanag sa agent ang iisang bagay, o may seksyon sa CLAUDE.md na kailangan sa isa sa sampung gawain.
2. Gumawa ng folder na .claude/skills/<pangalan>/ at ng file na SKILL.md sa loob.
3. Isulat ang frontmatter na may name at description, kung saan malinaw na sinasabi kung kailan gagamitin ang skill.
4. Ilarawan ang mga hakbang gamit ang tiyak na command at pamantayan ng pagiging handa: ano ang susuriin at ano ang ituturing na tagumpay.
5. Ilipat ang mahaba sa mga kalapit na file at i-refer ang mga ito mula sa pangunahing teksto.
6. Alisin ang duplikasyon sa CLAUDE.md, at iwan ang isang linyang tagapagturo: "Deploy — skill na deploy."
7. Suriin: sa bagong session, hilingin ang gawain sa sarili ninyong salita, nang hindi binabanggit ang pangalan ng skill, at tingnan kung kinuha ito ng agent. Kung hindi, isulat muli ang paglalarawan.

Mga halimbawa ng skill

Skill ng deploy

Klasikong kandidato ito: bihira, mahaba, at mapanganib ang proseso, at mahal ang pagkakamali. Nakasulat sa skill ang pagkakasunod-sunod ng mga hakbang (una ang pasubok na pagpapatakbo, saka ang pag-upload), ano ang hindi dapat ilabas, paano suriin ang resulta, at paano mag-rollback. Hindi na kailangang dalhin ng agent ito sa isip sa bawat pag-edit ng code, kundi kapag napag-usapan na ang server.

Skill ng review

---
name: review
description: Pag-review ng kasalukuyang mga pagbabago bago mag-commit. Gamitin kapag hinihiling na suriin ang diff, hanapin ang mga error sa mga edit, o ihanda ang mga pagbabago para sa commit.
---

# Pag-review ng mga pagbabago

1. Kunin ang diff: `git diff` at `git diff --staged`.
2. Sa bawat binagong file, suriin:
   - nae-escape ang input ng user sa pag-output;
   - parameterized ang mga SQL query;
   - walang debug output at pansamantalang file.
3. Patakbuhin ang test at linter ng proyekto (nasa CLAUDE.md ang mga command).
4. Ulat: listahan ng mga problema na may file at linya, mula sa seryoso hanggang sa maliit.
   Kung walang problema, sabihin ito nang diretso, nang walang inimbentong puna.

Ginagawa ng ganitong skill ang "tingnan mo kung ayos ang lahat" na pagsusuri bilang paulit-ulit na proseso na may parehong listahan ng punto sa bawat pagkakataon.

Skill ng pagtatapos ng session

Isa pang kapaki-pakinabang na uri ay ang ritwal sa dulo ng trabaho: ihinto ang lokal na environment, burahin ang pansamantalang file, isulat sa journal ng progreso kung ano ang nagawa at kung ano ang natitira, at mag-commit na may detalyadong paglalarawan. Direktang nilulunasan nito ang pagkawala ng context sa pagitan ng mga session: nagsisimula ang susunod na session sa kasalukuyang estado ng repositoryo, hindi sa hula.

Karaniwang pagkakamali

• Malabong paglalarawan. Mayroong skill pero hindi ito tinatawag ng agent. Ayusin sa pamamagitan ng muling pagsulat ng description na may tiyak na trigger.
• Skill na parang pader. Inilipat ang buong lumang seksyon na 400 linya sa SKILL.md. Bumalik ang problema ng namamagang context, mas huli nga lang. Panatilihing maikli ang pangunahing teksto at ilagay ang detalye sa mga kalapit na file.
• Duplikasyon sa CLAUDE.md. Ang iisang proseso ay nakasulat sa dalawang lugar at nagkakaiba sa paglipas ng panahon. Dapat iisa ang pinagmumulan ng katotohanan.
• Nagsasalungatang skill. Dalawang skill na magkatulad ang paglalarawan — pumipili ang agent sa pagitan nila nang random. Paghiwalayin ang mga ito gamit ang tahasang "gamitin / huwag gamitin".
• Lumang command. Pinalitan ang pangalan ng script, pero lumang pangalan pa rin ang nasa skill. Bahagi ng code ng proyekto ang skill: itama ito sa parehong commit ng proseso.

Paano malalaman kung oras na para ilipat ang seksyon sa skill

Makabubuting paminsan-minsang balikan ang CLAUDE.md at itanong sa bawat seksyon: sa anong bahagi ng karaniwang gawain talaga ito kailangan? Kung halos palagi, nasa tamang lugar ito. Kung sa isa sa sampung gawain lang, kandidato ito para sa skill.

Ikalawang senyales ang haba. Ang seksyon na hindi kasya sa isang screen ay malamang na naglalarawan ng proseso, hindi ng panuntunan. Mas mabuting basahin ang proseso nang buo sa oras ng pagpapatupad, hindi itago sa likod ng buong session.

Ikatlong senyales ang paulit-ulit na paliwanag. Kung paulit-ulit ninyong sinasabi sa agent ang parehong paglilinaw sa iisang gawain, isulat ito minsan sa skill. Pagkalipas ng isang linggo, tingnan kung bumaba ang bilang ng manu-manong pagwawasto: iyon ang patunay na gumagana ang skill.

Buod

Ang Claude Code skills ay paraan ng pag-iingat ng mga proseso sa tabi ng proyekto nang hindi nagbabayad ng context sa bawat session. Nakikita palagi ang paglalarawan ng skill, kinukuha ang katawan kung kailangan, at mas huli pa ang mga pantulong na file. Sa CLAUDE.md nananatili ang mapa ng proyekto at ang mahigpit na panuntunan, habang sa mga skill napupunta ang deploy, review, release, at iba pang gawain ng partikular na uri. Ang pag-aayos ng mga file ng tagubilin at ang progressive disclosure ng context ay tinatalakay nang praktikal sa kursong harness engineering.