SSD Nodes Learn Hosting plans →
Mwongozo Matt ConnorNa Matt Connor · Imeboreshwa 2026-11-14

Ujuzi wa wakala (agent skill) ni nini hasa?

Ujuzi wa wakala ni folda yenye faili ya SKILL.md inayopakiwa wakati wa kazi. Jifunze kwa nini muundo huu ni bora kuliko prompt kubwa na tofauti yake na itifaki ya MCP.

Ujuzi wa wakala (agent skill) ni nini hasa

Ujuzi wa wakala ni folda kwenye diski iliyo na faili inayoitwa SKILL.md ndani yake. Faili hiyo huhifadhi jina, maelezo mafupi, na maagizo yaliyoandikwa kwa markdown ya kawaida. Wakala hupakia maelezo hayo wakati wa kuanza, na husoma maagizo hayo pale tu ombi lako linapolingana na maelezo hayo au unapoita ujuzi huo kwa jina lake. Karibu kila kitu kingine kuhusu ujuzi kinatokana na sentensi hizo mbili.

Folda hiyo inaweza kuwa na faili zaidi ya moja. Uainishaji wa Agent Skills hutaja saraka tatu za hiari: scripts/ kwa ajili ya msimbo (code) ambao wakala huendesha, references/ kwa ajili ya nyaraka ambazo wakala husoma anapozihitaji, na assets/ kwa ajili ya violezo na data. Hakuna hata moja kati ya hizo inayohitajika. Folda iliyo na SKILL.md pekee ni ujuzi kamili.

restore-drill/
  SKILL.md
  references/retention-policy.md
  scripts/verify_snapshot.sh

Maelezo ndiyo sehemu ambayo watu huipuuza. Hiyo ndiyo maandishi pekee ambayo wakala huyaona kabla hajaamua kama atafungua ujuzi huo au la, kwa hivyo ni lazima yaeleze kile ambacho ujuzi huo hufanya na wakati wa kuutumia, kwa maneno ambayo mtu angeandika kweli.

Kwa nini ujuzi haugharimu karibu chochote hadi utakapotumika

Hii ndiyo hoja inayofanya muundo huu kuwa wa thamani kueleweka, na inahusu muktadha, si vipengele. Upakiaji hutokea katika hatua, ambazo vipimo huita ufichuzi wa hatua kwa hatua (progressive disclosure).

Wakati wa kuanza, wakala hupakia name na description ya kila ujuzi uliosanidiwa na si kitu kingine. Vipimo vya Agent Skills huweka hilo kwa takriban token 100 kwa kila ujuzi (mwongozo uliochapishwa, kufikia Oktoba 2026). Sanidi ujuzi kadhaa na utakuwa umetumia muktadha wa aya moja ndefu.

Ombi linapolingana na maelezo, wakala husoma mwili wa SKILL.md hiyo moja. Vipimo vinapendekeza kuweka mwili chini ya token 5,000 na faili chini ya mistari 500. Faili katika references/ na scripts/ bado hazigharimu chochote katika hatua hii. Faili ya marejeleo hupakia tu ikiwa maelekezo yatamwelekeza wakala kwake. Hati iliyofungashwa (bundled script) ni tofauti tena: wakala huiendesha kupitia shell, kwa hivyo chanzo cha hati hakiingii kamwe kwenye dirisha la muktadha na matokeo yake pekee ndiyo huingia.

Sasa linganisha hilo na kitu ambacho watu hukimbilia kwanza, ambacho ni prompt moja kubwa sana. Kila mstari katika prompt ya mfumo au faili ya maelekezo ya kudumu hulipiwa katika kila ombi, katika kila kikao, iwe kazi inahitaji au la, na hushindania umakini na swali lenyewe. Token elfu kumi za maelekezo ya kudumu ni bili unayolipa hata ili kuuliza saa ngapi. Ujuzi kadhaa hugharimu takriban token 1,200 kabla ya kuwezeshwa, lakini maelekezo yaliyopakiwa yanaweza kubaki kwenye muktadha kwa ajili ya kazi za baadaye katika mazungumzo yaleyale. Hiyo ndiyo hoja nzima ya ujuzi, na ndiyo sababu maktaba ndogo inashinda prompt ndefu.

Tahadhari moja huwashangaza watu. Katika Claude Code, ujuzi ukishapakia, mwili wake hubaki kwenye mazungumzo katika hatua za baadaye, kwa hivyo SKILL.md ndefu ni gharama ya mara kwa mara na si ya mara moja. Ufinyanzi (compaction) unaweza kupunguza au kuondoa maudhui ya ujuzi yaliyopakiwa. Kuhamisha maelezo kwenda references/ siyo usafi. Ni utaratibu unaofanya kazi kama ulivyosanifiwa.

Ujuzi wa wakala si wito wa zana

Zana, ambayo pia huitwa wito wa utendaji (function call), ni kitu ambacho modeli inaweza kukiita. Mfumo wa uendeshaji (harness) huipatia modeli schema: jina, maelezo, na umbo la hoja (arguments). Modeli hutoa wito, msimbo wako huutekeleza, na matokeo hurudi kama ujumbe. Zana hufanya kazi. Nusu zote mbili za mabadilishano hayo ni za mfumo wa uendeshaji, programu inayoendesha mzunguko kuzunguka modeli, ambayo pia ndiyo inayosoma maelezo ya ujuzi wako wakati wa kuanza na kuamua wakati wa kufungua mmoja.

Ujuzi hautekelezi chochote peke yake. Wakala huusoma, kisha huchukua hatua kwa kutumia zana zilizokuwepo tayari. Claude Code hukubali hoja wakati ujuzi unapoitwa na kuziingiza kwenye maelekezo yake kupitia viwakilishi kama $ARGUMENTS. Kile ambacho ujuzi unaweza kufanya ni kuiambia modeli ni zana zipi za kutumia, kwa mpangilio upi, na nini cha kukagua baadaye. Kukabidhi kazi kwa wakala wa pili ndio mfano ulio wazi zaidi: kikao kimoja cha Claude Code kinaweza kutuma ujumbe kwa kingine, na ujuzi ndipo unapoandika wakati ambapo ni vyema kufanya hivyo na nini cha kutuma.

Kwa ufupi: zana humpa wakala uwezo mpya, na ujuzi humpa wakala uwezo wa kuhukumu kuhusu uwezo alionao tayari. Ujuzi unapoongeza uwezo, hufanya hivyo kupitia hati iliyofungashwa ambayo wakala huiendesha kwa kutumia shell aliyokuwa nayo tayari. Ikiwa hatua lazima izalishe matokeo kamili na yaliyothibitishwa kila wakati, unahitaji zana au hati. Ikiwa hatua inahitaji mawazo yaleyale kutumika kwa uthabiti, unahitaji ujuzi. Ujuzi unaweza kuwa ni hukumu tu na bado ukawa ndio unaoutumia zaidi, kama inavyoonyeshwa na Ponytail, ambayo humsukuma wakala wa uandishi wa msimbo kufanya mabadiliko madogo zaidi yanayofanya kazi: haiongezi uwezo mpya na inabadilisha tu jinsi wakala anavyotumia uwezo alionao tayari. Hukumu hiyo inaweza kuelekeza upande mwingine pia, na ujuzi wa unlazy, ambao hupitia Depth Tree ili kumzuia wakala kutangaza kazi imekamilika mapema ni mbinu ileile inayolenga ukamilifu badala ya kuzuia.

Ustadi wa wakala si seva ya MCP

MCP (model context protocol) ni itifaki ya kuunganisha wakala na mfumo wa nje. Seva ya MCP ni mchakato unaoendeshwa, unaozungumza itifaki hiyo, na kutoa zana kwa wakala. Kwa kawaida huhitaji usanidi, vitambulisho, na ama amri ya ndani au endpoint ya mtandao. Ustadi (skill) ni folda iliyo na faili ya markdown ndani yake. Hakuna mchakato, hakuna port na hakuna itifaki.

Gharama ya muktadha (context cost) inatofautiana kwa njia hiyo hiyo. Kila zana inayotolewa na seva ya MCP hubeba jina, maelezo na schema ya hoja, na katika mteja anayeyapakia mapema, hayo hukaa kwenye ombi kwa kipindi chote cha kikao, yatumike au yasitumike. Claude Code haifanyi kazi hivyo tena kwa chaguo-msingi: kuanzia Oktoba 2026, utafutaji wake wa zana umewashwa tangu mwanzo, kwa hivyo majina ya zana na maelekezo ya seva pekee ndiyo hupakiwa mwanzoni mwa kikao na ufafanuzi kamili hufika wakati Claude anapoyatafuta. Ustadi uliotulia ni mstari mmoja wa maandishi.

Hivi viwili ni nyongeza, na usanidi imara zaidi huendesha vyote viwili. Seva ya MCP hutoa ufikiaji. Ustadi hutoa utaratibu: ni ipi kati ya zana hizo ya kuita kwa ajili ya mtiririko halisi wa kazi wa timu yako, kwa mpangilio gani, na matokeo mazuri yanaonekanaje. Ikiwa unajihudumia mwenyewe, kuendesha seva za MCP kwenye VPS kunashughulikia upande huo.

Ujuzi wa wakala (agent skill) si prompt ya mfumo wala faili la AGENTS.md

Maelekezo yote mawili yapo katika mfumo wa markdown, kwa hivyo mkanganyiko huu unaeleweka. Tofauti yake ni wakati wa kupakia (load). Prompt ya mfumo na maelekezo ya mradi yanayopakiwa wakati wa kuanzisha programu huwa yanafanya kazi kila wakati; faili zilizowekwa ndani ya AGENTS.md na CLAUDE.md hupakiwa wakati wakala anapofanya kazi kwenye saraka zake. Ujuzi (skill) hufanya kazi pale tu unapohitajika. Mitindo ya matokeo ya Claude Code iko mwishoni mwa kundi la maelekezo yanayofanya kazi kila wakati, kwa sababu kuchagua mtindo mmoja kunabadilisha prompt ya mfumo yenyewe, hivyo huunda kila jibu katika kipindi cha kazi (session), ikiwemo yale ambayo hakuna ujuzi wowote unaoyagusa.

Jaribio ni swali moja: je, kupuuza aya hii itakuwa ni makosa katika kazi ambayo haina uhusiano wowote nayo? Mtindo wa nyumba (house style), amri ya build, na kanuni ya kutaja branch hutumika katika kila kazi, kwa hivyo ni lazima yawe kwenye faili linalofanya kazi kila wakati, ambapo kupakiwa kila mara ndilo lengo. Orodha ya ukaguzi wa release (release checklist) unayoiendesha mara mbili kwa mwezi haitumiki katika kila kazi, kwa hivyo inapaswa kuwa kwenye ujuzi (skill). Sehemu ya faili lako linalofanya kazi kila wakati inapokua na kuwa utaratibu wenye namba, hiyo ni ishara ya kuihamisha.

Faili hizo zina kanuni zake ambazo ni vyema kuzizingatia. Tazama nini kinachopaswa kuwa katika AGENTS.md na nini kinachopaswa kuwa katika faili la binadamu na faili la design.md linaloelezea muundo wa codebase kwa ajili ya faili mbili tunazotumia.

Muonekano wa skill ya msingi

Katika Claude Code, skills za kibinafsi hukaa ndani ya ~/.claude/skills/<name>/SKILL.md na hutumika kwenye miradi yako yote kwenye mashine hiyo, lakini si katika Cowork au vipindi vya cloud. Skills za mradi hukaa ndani ya .claude/skills/<name>/SKILL.md na huwekwa kwenye git, hivyo timu yako pia huzipata; thread za cloud katika mradi wa Claude hazizipakii. GitHub Copilot na VS Code husoma skills za mradi kutoka .github/skills/ na .agents/skills/ pamoja na .claude/skills/. Faili iliyo ndani ni faili ileile.

mkdir -p ~/.claude/skills/restore-drill
---
name: restore-drill
description: Run a restic restore drill and report what was recovered. Use when the user asks to test backups, verify a restore, or check that a snapshot is readable.
---

# Restore drill

1. Run `restic snapshots` and pick the newest snapshot for the host in question.
2. Restore it into a scratch directory under `/tmp`, never over live data.
3. Compare the restored file count and total size against the snapshot summary.
4. Report the snapshot ID and anything that failed to restore.

If `restic snapshots` reports that it cannot open the config file, stop and report the full error instead of guessing the cause.

Hiyo ndiyo skill kamili. Jina la saraka (directory) huwa ndilo amri unayochapa, kwa hivyo hii ni /restore-drill. Katika Claude Code, menyu ya /skills huorodhesha yale yaliyosakinishwa, ambayo ndiyo njia ya haraka zaidi ya kuthibitisha kuwa faili imetambuliwa. Ikiwa haipo kwenye menyu hiyo, kwanza kagua majina: faili lazima iitwe SKILL.md, na vipimo vya Agent Skills vinahitaji jina liwe na herufi ndogo, tarakimu na alama moja ya hyphen, likilingana na saraka. Utaratibu uleule ulioandikwa kama hatua ambazo wakala wako anaweza kuzirudia ni rafiki wa asili wa kuhifadhi nakala za restic kwenye VPS kulingana na ratiba, ambapo uendeshaji wa backup si sawa na urejeshaji wa backup.

Wakati ujuzi unapaswa kuwa hati (script)

Hatua yoyote yenye jibu moja sahihi kila wakati inapaswa kuwa hati, huku ujuzi huo ukipunguzwa hadi mistari michache inayoeleza wakati wa kuiendesha na jinsi ya kusoma matokeo. Kuna sababu mbili, na zote ni za kivitendo.

Kwanza, chanzo cha hati hakiingii kamwe kwenye dirisha la muktadha (context window). Kichanganuzi (parser) cha mistari 300 kinakugharimu matokeo yake tu na si kingine, wakati mantiki hiyo hiyo ikiandikwa kama maelekezo ya markdown inagharimu urefu wake wote kila wakati ujuzi huo unapopakiwa.

Pili, hati hutoa jibu lilelile mara mbili. Mfano (model) unaoulizwa kutengeneza upya kanuni ileile ya kuchanganua logi kila unapoendeshwa utapata tofauti kidogo katika siku mbaya, na hutagundua hadi namba mbili zitakapokinzana.

Kwa hiyo, gawanya kazi kulingana na aina yake. "Changanua CSV na uchapishe kila mstari ambapo jumla hailingani na vitu vilivyoorodheshwa" ni hati. "Angalia mistari ambayo hati imechapisha na ueleze ni ipi inayoonekana kama kosa la uingizaji data" ni maelekezo ya ujuzi. Kuweka hukumu katika markdown na uamuzi katika msimbo (code) ni nidhamu ileile kama kujenga kitanzi ambacho wakala anaweza kukiendesha bila wewe kutazama.

Kwa nini skill yangu haifanyi kazi?

Hii hutokea kwa sababu description yako inaeleza kile ambacho skill hufanya, lakini haielezi ni wakati gani wa kuitumia. Mstari huo mmoja ndio kitu pekee ambacho agent anacho ili kulinganisha na ombi lako. "Husaidia na kazi za database" hailingani na kitu chochote mahususi. "Hufanya schema migration kwenye staging database. Tumia wakati mtumiaji anapoomba kuhamisha table, kuongeza column, au kubadilisha schema" ina maneno ambayo mtu huandika kihalisi, hivyo skill huanza kufanya kazi.

Tatizo la kinyume chake ni skill inayojianzisha kila wakati. Maelezo kama "Tumia kwa mabadiliko yoyote ya code kwenye repository hii" yanalingana na kila kitu, hivyo body hupakiwa kwenye kila task na kubaki kwenye mazungumzo katika hatua zinazofuata. Fupisha maelezo hayo ili yawe mahususi kwa kesi uliyokusudia. Katika Claude Code unaweza pia kuweka disable-model-invocation: true kwenye frontmatter, jambo linalozuia upakiaji wa kiotomatiki na kuifanya skill ipatikane tu unapoandika jina lake.

Tatizo la tatu ni skill inayorudia kazi ya tool nyingine. Maelekezo yanayomwambia agent a-curl API ambayo MCP server yake tayari inaiwezesha, au kutumia grep kwenye faili wakati mfumo una tool ya kutafutia, hukupa njia ya polepole zaidi pamoja na seti mbili za maelekezo zinazoweza kupingana. Futa nakala hiyo na ueleze nia badala yake.

Usikisie ni tatizo lipi kati ya hayo matatu unalo. Endesha prompt ileile mara mbili kwenye session mpya, mara moja skill ikiwa imewashwa na mara nyingine ikiwa imezimwa, kisha linganisha majibu. Session mpya ni muhimu, kwa sababu session uliyotumia kuandika skill tayari ina kila kitu ambacho skill inasema, jambo linaloficha mapungufu yaliyopo kwenye toleo lililoandikwa. Plugin ya skill-creator ya Anthropic hufanya ulinganisho huo kiotomatiki ndani ya Claude Code, ikijumuisha kutengeneza prompts ambazo zinapaswa na zisizopaswa kuianzisha skill hiyo, na kupima mara ngapi kila moja inafanya kazi. Ikiwa skill inapakia na agent bado hafanyi kile inachosema, tatizo si maelezo yako, na sababu zinazomfanya agent kupuuza maelekezo aliyokwisha yasoma ndipo unapaswa kuangalia baadaye.

Je, hii ni fomati ya muuzaji mmoja au ni kiwango cha kawaida?

Anthropic ilichapisha fomati hii mwishoni mwa 2025, kisha ikaitoa kama kiwango huru (open standard) kinachohifadhiwa kwenye agentskills.io. Mnamo Oktoba 22, 2026, Anthropic ilitangaza kutoa Agent Skills kwa Agentic AI Foundation chini ya Linux Foundation. Kufikia Oktoba 2026, vipimo hivyo vinafafanua sehemu za lazima za name na description, sehemu za hiari za license, compatibility, metadata na allowed-tools, saraka tatu za hiari, na tabia ya upakiaji wa hatua kwa hatua (staged loading). Pia inatoa kithibitishaji cha marejeleo (reference validator), kwa hivyo skills-ref validate ./my-skill hukagua folda kulingana na vipimo hivyo kabla hujaishiriki.

Orodha ya wateja ndiyo ishara halisi. Folda hiyo hiyo inasomwa na Claude Code, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, VS Code, Goose, OpenHands na opencode, miongoni mwa wengine. Microsoft huchapisha ujuzi wake wenyewe katika fomati hiyo kwenye github.com/microsoft/skills, na hutoa zana ya mezani (desktop tool) inayoitwa Skill Recorder inayokutazama ukifanya kazi mara moja, ikaiunda upya kama nia (intent) pamoja na hatua zilizopangwa, na kuandika matokeo kama ujuzi (skill). Muuzaji anayejenga kinasa sauti (recorder) ambacho fomati yake ya matokeo ni ya vipimo vya mtu mwingine ni ishara nzuri kwamba fomati hiyo imeacha kuwa kipengele cha bidhaa moja tu.

Nini cha kuandika kwanza

Usipange maktaba. Subiri hadi ujikute ukibandika maelekezo yaleyale kwenye chat kwa mara ya tatu, kisha hamisha maandishi hayo kwenye SKILL.md na ufute uliyoyabandika. Marudio uliyokwisha yahisi ndiyo kichocheo pekee cha kuaminika cha ujuzi unaostahili kuhifadhiwa. Utaratibu wa kutafuta ni ujuzi mzuri wa kuanzia, na ujuzi wa kutafuta unaoungwa mkono na mfano wako wa SearXNG unaonyesha muundo wake.

Tabia mbili huiweka maktaba katika hali nzuri. Soma kila ujuzi ambao hukuuandika kabla ya kuusakinisha, ikiwemo hati (scripts), kwa sababu ujuzi ni maelekezo ambayo wakala wako atayafuata na msimbo (code) unaoweza kuendeshwa: uuchukulie kama kusakinisha programu kutoka kwa mgeni. Na uweke vitambulisho (credentials) nje ya folda, kwa sababu ujuzi ni faili la maandishi ambalo hufanyiwa commit na kushirikiwa. Kuweka siri mbali na mawakala wako kunaelezea mahali ambapo thamani hizo zinapaswa kuwepo badala yake, na ramani ya njia ya kujifunza mawakala mwaka huu inapanga ujuzi huo pamoja na usanidi mwingine wote.

FAQ

Kuna tofauti gani kati ya agent skill na MCP server?

MCP (model context protocol) server ni mchakato unaoendelea (running process) ambao hutoa zana kwa agent kupitia itifaki fulani, kwa hivyo inahitaji usanidi na vitambulisho. Ufafanuzi kamili wa zana hizo hutumia nafasi ya context kwa kipindi chote cha kazi isipokuwa kama mteja (client) ataziahirisha, kama ambavyo Claude Code hufanya kwa chaguo-msingi. Agent skill ni folda iliyo na faili ya SKILL.md, bila mchakato au itifaki yoyote, na inagharimu takriban token 100 hadi pale agent atakapoamua kuisoma. Tumia MCP server kumpa agent uwezo wa kufikia mfumo. Tumia skill kumwelekeza agent utaratibu wa kutumia uwezo huo vizuri. Usanidi mwingi hutumia zote mbili.

Je, agent skills hufanya kazi na Claude Code pekee?

Hapana. Anthropic ilitengeneza muundo huu na kuutoa kama kiwango huru (open standard) katika agentskills.io, na folda hiyo hiyo inaweza kusomwa na Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, VS Code, Goose, OpenHands na wateja wengine. Kinachotofautiana ni mahali ambapo kila mteja hutafuta na ni sehemu zipi za ziada za frontmatter anazozielewa. Claude Code husoma ~/.claude/skills/ na .claude/skills/, wakati GitHub Copilot na VS Code husoma .github/skills/, .claude/skills/ au .agents/skills/ ndani ya hazina (repository). Faili ya SKILL.md yenyewe huhama kati yao bila kubadilika.

Ninaweza kusakinisha skills ngapi kabla ya mfumo kuwa mzito?

Kikwazo ni bajeti ya kuanzisha (startup budget) badala ya idadi ya skills. Kila skill iliyosakinishwa huchangia jina na maelezo yake, takriban token 100 kulingana na mwongozo uliotolewa wa vipimo, kwa hivyo skills thelathini hugharimu takriban token 3,000 kabla ya yoyote kati yao kutumika. Kinachopungua kasi kwanza ni uwezo wa kulinganisha (matching), si kasi ya mfumo: skills nyingi zenye maelezo yanayopishana hufanya iwe vigumu kwa model kuchagua ile sahihi. Andika maelezo yasiyopishana, na ufute skills ambazo hujaanza kuzitumia tena.

Je, maelekezo haya yaende kwenye skill au kwenye AGENTS.md?

Jiulize kama yanahusu kila kazi ndani ya hazina. Amri za ujenzi (build commands), mtindo wa kazi, na sheria za utoaji majina hutumika kwa kazi zote, kwa hivyo ni lazima yawe kwenye faili inayowaka kila wakati (always-on file), ambapo kupakia kila wakati ndiyo lengo. Utaratibu unaouendesha mara kwa mara, kama vile orodha ya ukaguzi ya release au mazoezi ya kurejesha mfumo (restore drill), unapaswa kuwa skill, ili ugharimu tu maelezo yake ya mstari mmoja kabla ya kuwashwa. Mara tu inapopakiwa kwenye Claude Code, maelekezo yake hubaki kwenye mazungumzo katika hatua zinazofuata, hata kwa kazi zisizohusiana. Sehemu ya AGENTS.md ambayo imekua na kuwa hatua zenye namba kwa kawaida ni skill inayongojea kuhamishwa.

Je, makala hii ilikusaidia?