Ujuzi wa wakala (agent skill) ni nini hasa?

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 maelekezo yaliyoandikwa kwa markdown ya kawaida. Wakala hupakia maelezo hayo wakati wa kuanza, na husoma maelekezo hayo pale tu ombi lako linapolingana na maelezo hayo. Karibu kila kitu kingine kuhusu ujuzi kinatokana na sentensi hizo mbili.

Folda hiyo inaweza kuwa na zaidi ya faili hiyo moja. Uainishaji wa Agent Skills hutaja saraka tatu za hiari: scripts/ kwa ajili ya msimbo (code) ambao wakala huendesha, references/ kwa ajili ya hati ambazo wakala husoma anapozihitaji, na assets/ kwa ajili ya violezo na data. Hakuna hata moja kati ya hizo inayohitajika. Folda isiyo na kitu kingine isipokuwa SKILL.md 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 ya kuamua kama atafungua ujuzi huo au la, kwa hivyo lazima yaeleze ujuzi huo hufanya nini na wakati gani wa kuutumia, kwa kutumia maneno ambayo mtu angeandika kweli.

Kwa nini ujuzi haugharimu karibu chochote hadi utakapotumika

Hii ndiyo hoja inayofanya muundo huu kuwa wa maana kueleweka, na inahusu muktadha, si vipengele. Upakiaji hutokea kwa hatua, jambo ambalo vipimo (specification) 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 kiasi hicho kuwa takriban token 100 kwa kila ujuzi (mwongozo uliotolewa, kufikia Agosti 2026). Sanidi ujuzi kadhaa na utakuwa umetumia muktadha wa aya moja ndefu.

Ombi linapolingana na maelezo, wakala husoma mwili wa SKILL.md huo mmoja. 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, 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 hushindana kwa umakini na swali lenyewe. Token elfu kumi za maelekezo ya kudumu ni bili unayolipa hata kuuliza saa ngapi. Ujuzi kadhaa hugharimu takriban token 1,200 wakati wa utulivu na hupanuka tu kwa ajili ya kazi moja inayoyahitaji. Hiyo ndiyo hoja nzima ya ujuzi, na ndiyo sababu maktaba ndogo inashinda prompt ndefu.

Tahadhari moja huwakanganya watu. Ujuzi unapoanza kupakia, mwili wake hubaki kwenye muktadha kwa muda wote wa kikao, kwa hivyo SKILL.md ndefu ni gharama ya mara kwa mara na si ya mara moja. Kuhamisha maelezo kwenda references/ siyo usafi. Ni utaratibu unaofanya kazi kama ulivyosanifiwa.

Ujuzi wa wakala si mwito wa zana

Zana, ambayo pia huitwa mwito wa utendaji (function call), ni kitu ambacho modeli inaweza kukiita. Mfumo hutuma schema kwa modeli: jina, maelezo, na umbo la hoja (arguments). Modeli hutoa mwito, msimbo wako huutekeleza, na matokeo hurudi kama ujumbe. Zana hufanya mambo.

Ujuzi (skill) hautekelezi chochote peke yake. Wakala husoma ujuzi huo, kisha huchukua hatua kwa kutumia zana ilizokuwa nazo tayari. Modeli haiwezi kupitisha hoja kwa ujuzi kwa namna inavyopitisha hoja kwa zana. Kile ambacho ujuzi unaweza kufanya ni kuiambia modeli ni zana zipi za kutumia, kwa mpangilio upi, na nini cha kukagua baadaye.

Kwa ufupi: zana humpa wakala uwezo mpya, na ujuzi humpa uwezo wa kufanya maamuzi kuhusu uwezo alionao tayari. Ikiwa hatua lazima itoe matokeo kamili yaliyothibitishwa kila wakati, unahitaji zana au hati (script). Ikiwa hatua inahitaji fikra zilezile kutumika kwa uthabiti, unahitaji ujuzi. Ujuzi unaweza kuwa ni maamuzi tu na bado ukawa ndio unaoutumia zaidi, kama Ponytail, ambayo humsukuma wakala wa uandishi wa msimbo kufanya mabadiliko madogo zaidi yanayofanya kazi inavyoonyesha: haiongezi uwezo mpya na inabadilisha tu jinsi wakala anavyotumia uwezo alionao tayari.

Ujuzi wa wakala (agent skill) si seva ya MCP

MCP (model context protocol) ni itifaki ya kuunganisha wakala na mfumo wa nje. Seva ya MCP ni mchakato (process) unaoendeshwa, unaotumia itifaki hiyo, na kutoa zana (tools) kwa wakala. Kwa kawaida huhitaji usanidi, vitambulisho (credentials), na ama amri ya ndani (local command) au endpoint ya mtandao. Ujuzi (skill) ni folda yenye faili ya markdown ndani yake. Hakuna mchakato, hakuna port, na hakuna itifaki.

Gharama ya muktadha (context cost) hutofautiana kwa njia hiyo hiyo. Kila zana inayotolewa na seva ya MCP hubeba jina, maelezo, na schema ya hoja (argument schema), na kwa chaguomsingi hizo hukaa kwenye ombi la kikao kizima, ziwe zimetumika au la. Baadhi ya wateja wameanza kuchota schema za zana pale zinapohitajika, lakini kuzipakia mapema bado ndiyo hali ya kawaida. Ujuzi uliotulia ni mstari mmoja wa maandishi.

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

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

Zote mbili ni maelekezo katika markdown, kwa hivyo mkanganyiko huu ni wa kawaida. Tofauti yake ni wakati zinapopakiwa. AGENTS.md, CLAUDE.md na prompt ya mfumo huwa zimewashwa kila wakati. Ujuzi (skill) huwashwa pale unapohitajika.

Jaribio ni swali moja: je, kupuuza aya hii itakuwa ni kosa katika kazi ambayo haina uhusiano nayo? Mtindo wa nyumba (house style), amri ya build na kanuni ya kutaja branch hutumika katika kila kazi, kwa hivyo ni lazima viwemo kwenye faili inayowaka 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. Sehemu ya faili yako inayowaka kila wakati inapokua na kuwa utaratibu wenye namba, hiyo ndiyo ishara ya kuihamisha.

Faili hizo zina kanuni zake ambazo ni vyema kuzizingatia. Tazama kinachopaswa kuwa katika AGENTS.md na kinachopaswa kuwa katika faili ya binadamu na design.md inayoelezea umbo la codebase kwa zile 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. Skills za mradi hukaa ndani ya .claude/skills/<name>/SKILL.md na huwekwa kwenye git, hivyo kila mtu na kila wakala anayefanya kazi kwenye hifadhi hiyo anakuwa nazo. GitHub Copilot na VS Code husoma workspace skills kutoka .github/skills/ badala yake. 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` prints `Fatal: unable to open config file`, the repository path or the password is wrong. Stop and report that instead of guessing.

Hiyo ni skill kamili. Jina la saraka 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, jina si sahihi: faili lazima iitwe SKILL.md, na jina la saraka lazima liwe na herufi ndogo, tarakimu, na alama moja ya hyphen. Utaratibu uleule ulioandikwa kama hatua ambazo wakala wako anaweza kuzirudia ni rafiki wa asili wa scheduled restic backups on a VPS, 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 haianzishi (trigger) kamwe?

Kwa sababu description yake inaeleza kile ambacho skill hufanya lakini haielezi wakati wa kuitumia. Mstari huo mmoja ndio kitu pekee ambacho wakala (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 kuhamaisha (migrate) jedwali, kuongeza safu, au kubadilisha schema" ina maneno ambayo mtu huandika kihalisi, kwa hivyo huanza kufanya kazi.

Kosa la kinyume ni skill inayojianzisha kila wakati. Maelezo kama "Tumia kwa mabadiliko yoyote ya msimbo kwenye hazina hii" yanalingana na kila kitu, kwa hivyo mwili (body) hupakiwa kwenye kila kazi na kubaki kwenye muktadha kwa muda wote wa kikao. Finyaza maelezo hayo ili yawe mahususi kwa kisa ulichokusudia. Katika Claude Code unaweza pia kuweka disable-model-invocation: true kwenye frontmatter, jambo linalozuia upakiaji wa kiotomatiki na kuifanya skill ipatikane unapochapa jina lake.

Kosa la tatu ni skill inayorudia zana (tool) nyingine. Maelekezo yanayomwambia wakala kutumia curl API ambayo seva yake ya MCP tayari inaiweka wazi, au kutumia grep kwenye faili wakati mfumo una zana ya utafutaji, hukupa njia ya polepole zaidi pamoja na seti mbili za maelekezo zinazoweza kupingana. Futa nakala hiyo na ueleze nia badala yake.

Usikisie ni lipi kati ya hayo matatu unalo. Endesha prompt ileile mara mbili kwenye kikao kipya, mara moja skill ikiwa imewashwa na mara nyingine ikiwa imezimwa, kisha linganisha majibu. Kikao kipya ni muhimu, kwa sababu kikao ambacho uliandikia skill tayari kina kila kitu ambacho skill inasema, jambo linaloficha mapungufu katika toleo lililoandikwa. Plugin ya skill-creator ya Anthropic hufanya ulinganisho huo kiotomatiki ndani ya Claude Code, ikijumuisha kutengeneza prompts ambazo zinapaswa na zisizopaswa kuanzisha skill hiyo na kupima mara ngapi kila moja hufanya hivyo.

Je, umbizo hili ni la muuzaji mmoja au ni kiwango cha kawaida?

Anthropic ilichapisha umbizo hili mwishoni mwa 2025, kisha ikaliachia kama kiwango huru kinachohifadhiwa katika agentskills.io. Kufikia Agosti 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. Pia inatoa kithibitishaji cha marejeleo, 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 yenyewe katika umbizo hili kwenye github.com/microsoft/skills, na hutoa zana ya mezani inayoitwa Skill Recorder inayokutazama ukifanya kazi mara moja, ikaiunda upya kama nia pamoja na hatua zilizopangwa, na kuandika matokeo kama ujuzi. Muuzaji anayejenga kinasa sauti ambacho umbizo lake la matokeo ni la vipimo vya mtu mwingine ni ishara nzuri kwamba umbizo hilo limeacha 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) unaotoa zana kwa agent kupitia itifaki fulani, kwa hivyo inahitaji usanidi na vitambulisho, na ufafanuzi wa zana zake kwa kawaida huchukua nafasi ya context kwa kipindi chote cha session iwe zinatumika au la. Agent skill ni folda iliyo na faili ya SKILL.md, bila mchakato wala itifaki, na inagharimu takriban token 100 hadi pale agent anapoamua kuisoma. Tumia MCP server kumpa agent uwezo wa kufikia mfumo. Tumia skill kumwelekeza agent utaratibu wa kutumia uwezo huo vizuri. Usanidi mwingi hutumia vyote viwili.

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 inasomwa na Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, VS Code, Goose, OpenHands na wateja wengine. Kinachotofautiana ni mahali ambapo kila mteja hutazama na ni sehemu zipi za ziada za frontmatter anazozielewa. Claude Code inasoma ~/.claude/skills/ na .claude/skills/, wakati GitHub Copilot na VS Code zinasoma .github/skills/ kwenye 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. 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. Kinachoshuka kwanza ni uwezo wa kulinganisha (matching), si kasi: skills nyingi zenye maelezo yanayopishana hufanya iwe vigumu kwa model kuchagua ile sahihi. Andika maelezo yasiyopishana, na ufute skills ambazo hujaendelea kuzitumia.

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

Jiulize kama yanahusu kila kazi kwenye repository. Amri za ujenzi (build commands), mtindo wa kazi (house style) na sheria za utoaji majina hutumika kwa zote, kwa hivyo ni vyema yawe kwenye faili inayowashwa kila wakati, ambapo kupakia kila mara ndiyo lengo. Utaratibu unaouendesha mara kwa mara, kama vile orodha ya ukaguzi ya release au mazoezi ya restore, unapaswa kuwa skill, ili usigharimu chochote kwenye kazi ambazo hazihitaji utaratibu huo. Sehemu ya AGENTS.md ambayo imekua na kuwa hatua zenye namba kwa kawaida ni skill inayongojea kuhamishwa.