Jinsi ya kushiriki agent skills bila drift kati ya repos

Jinsi ya kushiriki ujuzi wa agent kati ya repos

Ili kushiriki ujuzi wa agent kati ya repos, acha kunakili faili na badala yake uitegemee. Weka repository moja ya skills, ipe tag, kisha kila project ibane matumizi yake kwenye tag hiyo. Ongeza smoke test kwa kila skill, na kagua kila bump kama unavyokagua bump ya dependency.

Hii ina sehemu nne: chanzo kimoja cha ukweli, version iliyobainishwa kwa kila repository, smoke test kwa kila skill, na njia ya kufanya review. Maelezo yote hapa chini yanaeleza kwa nini kila sehemu ipo, zana zinazo ship katika 2026 zinafanya nini kuhusu hilo, na jinsi ya kujenga mfumo mzima kwenye git remote inayojihost bila kutumia service yoyote ya nje.

Skill ya agent ni folder iliyo na faili la SKILL.md, pamoja na scripts na reference files inazohitaji. Ikiwa unit hiyo ni mpya, soma kwanza agent skill ni nini na SKILL.md inavyofanya kazi. Ukurasa huu unahusu supply chain inayozunguka unit hiyo.

Mahali skill inapatikana, na kwa nini kuishiriki ni vigumu

Claude Code hupakia skills kutoka sehemu tatu, na hati za skills hutaja kila path.

• ~/.claude/skills/<skill-name>/SKILL.md ni ya kibinafsi. Hupakiwa katika miradi yako yote, wala si katika miradi ya mtu mwingine.
• .claude/skills/<skill-name>/SKILL.md ni ya kiwango cha mradi. Hupakiwa kwa kila mtu anayefanya checkout ya repository hiyo.
• <plugin>/skills/<skill-name>/SKILL.md husafirishwa ndani ya plugin. Hupakiwa kila mahali plugin hiyo inapowezeshwa.

Ya pili ndiyo muhimu kwa timu, kwa sababu huwekwa kwenye repository na kila mtu anayefanya clone ya repo huipata. Hapo ndipo tatizo huanza. Skill iliyo katika .claude/skills/ ni ya repository moja. Una repositories nane. Kwa hiyo, skill hiyo inanakiliwa mara nane.

Frontmatter haisaidii. Agent Skills spec inaruhusu keys sita, na paths za usambazaji zinazotekeleza spec hiyo huchapisha orodha hiyo unapotumia key nyingine:

Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

Angalia kisichokuwapo: hakuna key ya version. Hakuna chochote ndani ya file kinachoonyesha ni nakala ipi iliyo mpya zaidi. Hilo linaeleweka, kwa sababu skill ni hati, si package. Hata hivyo, inamaanisha versioning lazima itoke kwenye layer inayozunguka file hiyo, na layer hiyo ni jukumu lako.

Tatizo la kwanza: nakala nane zinazoanza kutofautiana kimya kimya

Kununakili na kubandika hufanya kazi siku ya kwanza. Hushindwa siku ya sitini. Mtu anarekebisha maelekezo yasiyo sahihi katika repo ya payments, lakini hazigusi zile saba nyingine. Mtu mwingine anaongeza kanuni kuhusu pagination katika orders. Sasa jina lilelile la skill hutoa ukaguzi tofauti kulingana na directory ambayo agent ilianzishwamo, na hakuna developer anayejua.

Kushindwa huku hutokea bila kuonekana kwa sababu hakuna hali ya error. Skill ni maandishi. Maelekezo yaliyopitwa na wakati husababisha jibu lenye kujiamini lakini lisilo sahihi, na hilo ndilo tatizo lenye gharama kubwa. Hakuna kitu katika agent kinacholinganisha nakala yako na nakala za wengine, kwa hiyo ishara pekee ni mtu kugundua kwamba repo mbili hazikubaliani.

Tatizo la pili: hakuna kinachobainisha toleo

Hata timu inapoweka ujuzi wote mahali pamoja, njia ya kawaida ya kushiriki ni hatua ya kunakili: script ya usanidi, mstari wa curl kwenye hati ya kuanza kazi, au shell alias inayosawazisha folda. Njia hizi zote husakinisha kile kilicho kwenye kilele cha branch kwa sasa.

Hii inamaanisha kuwa developers wawili wanaotumia commit moja ya application moja wanaweza kuwa wanaendesha maelekezo tofauti, kwa sababu waliendesha usawazishaji katika siku tofauti. Pia inamaanisha huwezi kujibu swali muhimu baada ya agent kuendesha vibaya: ni toleo gani la skill lililosababisha hali hii? Bila revision iliyorekodiwa, uendeshaji huo hauwezi kurudiwa kwa usahihi, kwa hiyo ripoti ya hitilafu haiwezi kusaidia uchunguzi.

Tatizo la tatu: hakuna anayejua kama skill bado inafanya kazi

Skill haina compiler. Ni maelekezo yanayolenga model, kwa hiyo inaweza kuacha kufanya kazi huku faili likibaki sawa byte kwa byte. Upgrade ya model hubadilisha kiwango ambacho inafuata kwa ukaribu maelekezo marefu. Command-line tool inayotumiwa na skill hubadilisha jina la flag. URL iliyo kwenye reference file huanza kurudisha 404, na agent hutumia error page kama chanzo.

Hakuna hali yoyote kati ya hizi inayosababisha failure ionekane wazi. Agent bado inajibu. Jibu huwa baya zaidi kuliko lilivyokuwa mwezi uliopita, na hilo ni jambo gumu kugundua hatua kwa hatua katika pull request moja baada ya nyingine.

Mambo ambayo zana zinazotolewa mwaka 2026 zinatatua

Majibu kadhaa yanaanza kupatikana sasa, na yanatofautiana kuhusu mahali ambapo toleo linapaswa kuhifadhiwa.

Lockfiles. Zana ya mstari wa amri skills kutoka Vercel Labs (vercel-labs/skills, yenye leseni ya MIT, v1.5.22 kufikia 5 August 2026) husakinisha skills kutoka git repository kwenye directory ambayo agent yako inatarajia, na inajua mpangilio wa zaidi ya agents sabini. npx skills add <repo> husakinisha, npx skills update husasisha, na npx skills list huonyesha ulivyonavyo. Rekodi ya vilivyosakinishwa huhifadhiwa mara moja kwa kila mtumiaji badala ya mara moja kwa kila repository, na ombi lililo wazi kwenye mradi huo (issue 283) linaomba command ya skills install inayosakinisha tena kila skill iliyofuatiliwa kutoka kwenye lock file ili mashine ya pili iwe na seti ileile. Chukulia ombi hilo kama ripoti ya hali. Wazo la lockfile limekubaliwa. Sehemu ya kila mradi bado inajengwa.

Specs na tests. SkillSpec inachukua mtazamo mwingine. Inachukulia SKILL.md kama mkataba wa kukaguliwa badala ya maelezo ya kuaminiwa, ikiwa na lengo lililotajwa la kufanya skills "ziweze kufuatwa, kufanyiwa majaribio na kuthibitishwa". skillspec doctor <path> huripoti mahali ambapo agent ana uwezekano wa kupoteza mfuatano. skillspec boundary map <path> huripoti kile ambacho skill inaweza kufikia, na skillspec boundary assess <path> hupanga matokeo hayo kwa kiwango cha hatari. Ni Rust crate yenye leseni mbili, MIT au Apache 2.0, katika toleo 0.2.2 kufikia 29 July 2026. Sakinisha toleo lililowekwa badala ya toleo jipya zaidi:

cargo install skillspec --version 0.2.2 --locked
skillspec --version

--locked hujenga kwa kutumia matoleo ya dependencies ambayo crate ilichapishwa nayo, kwa hiyo build haibadiliki bila kutarajiwa. skillspec --version inapaswa kuchapisha 0.2.2. Nambari tofauti inamaanisha binary ya zamani iliyo mapema katika PATH yako ndiyo inayotumika.

Mbinu ya vendor. Google ilieleza jinsi inavyojenga skills katika google/skills kwenye chapisho kuhusu jinsi inavyojenga, kujaribu na kupanua skills za agents. Ukiondoa ukubwa wa mfumo, utaratibu huo ni continuous integration (CI) ya kawaida. Kila skill hupitishwa kwenye linters za frontmatter metadata, idadi ya mistari, mpangilio wa directory na majina kabla ya kuunganishwa. Link checker husababisha build ishindwe kwenye URL yoyote inayorejesha 404, jambo linalogundua link inayoonekana halali lakini iliyobuniwa na agent. Waandishi lazima watoe seti ya evaluation prompts na scoring rubric pamoja na skill. Kazi za evaluation zilizopangwa huendeshwa kila wiki dhidi ya library nzima ili kugundua regressions, na kila skill ina owner aliyetajwa ambaye anatarajiwa kuirekebisha ubora unaposhuka.

Muundo ulio chini ya majibu yote matatu

Si lazima uchague mojawapo. Chini yake kuna muundo mmoja, na git ya kawaida inakupa kila kitu unachohitaji.

1. Chanzo kimoja cha ukweli. Skill ina mahali pamoja pekee, na kila repository hurejelea mahali hapo badala ya kuhifadhi nakala.
2. Toleo lililofungwa kwa kila repository. Kila mradi huhifadhi revision halisi unayotumia, kwa hiyo kuboresha ni kufanya commit katika mradi huo ikiwa na mwandishi na tarehe.
3. Smoke test kwa kila skill. Kuna ukaguzi mmoja unaoweza kuendeshwa unaothibitisha kwamba skill bado inazalisha matokeo iliyoahidi.
4. Njia ya ukaguzi. Mabadiliko kwenye skill inayoshirikiwa hupitia ukaguzi, na kila mtumiaji huona tofauti kabla ya kuyapokea.

Huo ndio muundo wa dependency. Skills zikawa artifact inayoshirikiwa kwa kasi zaidi kuliko zana zilivyokua kuziunga mkono, kwa hiyo zana unazoziamini tayari ndizo salama zaidi kutumia.

Muundo wa timu ndogo inayotumia git remote iliyojihostia

Repository moja huhifadhi maarifa ya timu. Hakuna kitu kingine kinachowekwa humo, kwa hiyo historia yake husomeka kama changelog ya maelekezo.

agent-skills/
  skills/
    api-review/
      SKILL.md
    release-notes/
      SKILL.md
  tests/
    api-review.sh
    release-notes.sh
  CHANGELOG.md

Releases ni tags. Tumia annotated tags kwa sababu hubeba ujumbe na tarehe. Andika ujumbe huo ukieleza sababu ambayo mtumiaji angependa kufanya bump:

git tag -a v1.4.0 -m "api-review: require pagination on list endpoints"
git push origin v1.4.0

Ikiwa remote yako ni Gitea, Forgejo, GitLab au bare repository kupitia SSH kwenye VPS yako, hakuna kinachobadilika katika hatua zinazofuata. Kila kitu hapa ni git pamoja na symlink.

Kuweka commit maalum kwa kutumia git submodule

Submodule huhifadhi commit moja maalum ya repository nyingine ndani ya repository yako. Rekodi hiyo ndiyo pin. Katika kila project inayotumia submodule:

git submodule add https://git.example.com/team/agent-skills.git vendor/agent-skills
git -C vendor/agent-skills fetch --tags
git -C vendor/agent-skills checkout v1.4.0
mkdir -p .claude/skills
ln -s ../../vendor/agent-skills/skills/api-review .claude/skills/api-review
git add .gitmodules vendor/agent-skills .claude/skills/api-review
git commit -m "Pin shared agent skills to v1.4.0"

Symlink ndiyo inayofanya utaratibu huu ufanye kazi. Skill entry ya kiwango cha project inaweza kuwa symlink inayoelekeza kwenye directory nyingine kwenye disk, na Claude Code huifuata na kusoma SKILL.md kutoka kwenye target. Kwa hiyo, skill hupakiwa kama project skill ya kawaida, huku bytes zikiwa kwenye submodule katika commit uliyochagua.

Kagua pin:

git submodule status

Mstari sahihi huanza na space, ukifuatiwa na commit, path, kisha tag iliyo karibu zaidi:

 4d1a7c2f0b93e5a1c8d6f2b40e7a95c3d1f8b602 vendor/agent-skills (v1.4.0)

- mwanzoni humaanisha kuwa submodule haikuwahi kuanzishwa, kwa hiyo .claude/skills/api-review haielekezi popote na skill haipakii bila kutoa ujumbe. Rekebisha hilo kwa git submodule update --init. + mwanzoni humaanisha kuwa commit iliyokaguliwa inatofautiana na ile iliyohifadhiwa, kwa hiyo developer huyo anaendesha instructions ambazo wengine hawana. Clone mpya zinahitaji git clone --recurse-submodules, na mstari huo unapaswa kuwekwa kwenye README, kwa sababu clone ya kawaida huacha vendor/agent-skills ikiwa tupu na haitoi error.

Kuboresha hufanywa kwa makusudi, na hilo ndilo lengo kuu:

git -C vendor/agent-skills fetch --tags
git -C vendor/agent-skills diff v1.4.0 v1.5.0 -- skills/
git -C vendor/agent-skills checkout v1.5.0
git add vendor/agent-skills
git commit -m "Bump shared agent skills to v1.5.0"

Mstari wa diff ndiyo njia ya review. Unaonyesha mabadiliko yaleyale ambayo kila repo nyingine inayotumia submodule itaona, na unaweza kuuweka kwenye pull request.

Kuweka pin kwa kutumia plugin marketplace badala yake

Ikiwa ungependa kutowataka kila developer ajifunze submodules, mfumo wa plugin wa Claude Code unasambaza plugin hizo kwa ajili yako, na hufanya kazi na remote ya self-hosted. Weka catalog katika .claude-plugin/marketplace.json kwenye skills repository:

{
  "name": "acme-agents",
  "owner": { "name": "Platform team", "email": "platform@example.com" },
  "plugins": [
    {
      "name": "team-skills",
      "description": "Shared review and release skills",
      "version": "1.4.0",
      "source": {
        "source": "url",
        "url": "https://git.example.com/team/agent-skills.git",
        "ref": "v1.4.0",
        "sha": "4d1a7c2f0b93e5a1c8d6f2b40e7a95c3d1f8b602"
      }
    }
  ]
}

Hapa kuna sources mbili tofauti, na kuzichanganya ndilo kosa la kawaida. Marketplace source, yaani mahali catalog yenyewe inapopakuliwa, inakubali ref kwa branch au tag, lakini haikubali sha. Plugin source ndani ya catalog inakubali zote mbili, na zote zikiwekwa, sha ndiyo pin inayotumika. Kwa hiyo, pin ya exact commit inapaswa kuwekwa kwenye catalog entry.

Kisha kila repository inayotumia plugin hutangaza marketplace katika .claude/settings.json yake iliyo committed:

{
  "extraKnownMarketplaces": {
    "acme-agents": {
      "source": {
        "source": "url",
        "url": "https://git.example.com/team/agent-skills.git",
        "ref": "v1.4.0"
      }
    }
  },
  "enabledPlugins": {
    "team-skills@acme-agents": true
  }
}

Mteammate anayeamini project folder ataombwa kusakinisha marketplace, na plugin itawezeshwa bila ukurasa wa wiki kumwelekeza kufanya hivyo. Skills hizo zitapatikana kupitia /team-skills:api-review, kwa sababu plugin skills hupewa namespace kulingana na jina la plugin na haziwezi kugongana na project skill yenye jina lilelile. Baada ya kusukuma tag mpya, watumiaji wa plugin wata-refresh kwa /plugin marketplace update acme-agents, kisha waendeshe /reload-plugins ikiwa muhtasari wa usakinishaji utawaomba kufanya hivyo.

Kuandika smoke test ya skill moja

Smoke test ni uendeshaji wa agent ulioandikwa kwa script dhidi ya fixture yenye kosa linalojulikana, pamoja na assertion moja. Claude Code huendeshwa bila mwingiliano kwa kutumia -p, na skill inayoitwa na mtumiaji hufanya kazi katika hali hiyo: weka /skill-name kwenye prompt string, nayo itapanuliwa kabla ya uendeshaji kuanza.

#!/usr/bin/env bash
set -euo pipefail

claude -p "/api-review Read fixtures/orders-api.md and list the rule ids it breaks." \
  --allowedTools "Read" \
  --output-format json \
  --json-schema '{"type":"object","properties":{"rule_ids":{"type":"array","items":{"type":"string"}}},"required":["rule_ids"]}' \
  | jq -e '.structured_output.rule_ids | index("pagination-required")' > /dev/null

fixtures/orders-api.md ni faili fupi lenye kosa moja lililowekwa kimakusudi. Assertion ni kwamba skill itaje kosa hilo. jq -e hutoka kwa hali isiyo ya sifuri wakati filter yake inatoa null, kwa hiyo skill inapoacha kunasa kosa lililowekwa, script hufeli. claude yenyewe hutoka kwa hali isiyo ya sifuri uendeshaji unapofeli, na set -euo pipefail hubadilisha kushindwa kokote kuwa test iliyofeli.

Model hubadilisha maneno ya majibu yake kati ya uendeshaji, kwa hiyo usiwahi kufanya assertion kwenye sentensi nzima. Fanya assertion kwenye kitambulisho ambacho skill inapaswa kutoa, au kwenye field ya schema uliyoomba. Weka fixture ikiwa ndogo ili uendeshaji ubaki wa gharama ndogo.

Katika CI, ongeza --bare. Bila hiyo, claude -p hupakia context ileile ambayo session shirikishi ingetumia, ikiwemo hooks, plugins na CLAUDE.md kutoka kwenye mashine inayoendesha. Kwa hiyo, configuration binafsi ya mwenzako inaweza kubadilisha matokeo. Bare mode huruka auto-discovery yote. Hii inamaanisha pia huruka skill unayoijaribu, kwa hiyo ipakie hiyo skill moja waziwazi. Bare mode haisomi login ya subscription yako pia, kwa hiyo weka ANTHROPIC_API_KEY kwenye mazingira kwanza:

claude --bare -p "/team-skills:api-review Read fixtures/orders-api.md and list the rule ids it breaks." \
  --plugin-dir vendor/agent-skills \
  --allowedTools "Read" \
  --output-format json

Ukitumia --output-format stream-json, event ya kwanza ya uendeshaji huripoti plugins zilizopakiwa na huwa na array ya plugin_errors ya plugins ambazo hazikupakiwa. Fanya CI job ifeli ikiwa plugin_errors si tupu. Hii hunasa pin inayolenga revision ambayo haipo tena. Bila ukaguzi huu, hali hiyo huonekana kana kwamba agent inapuuza kwa utulivu house rules zako.

Ujuzi wa pamoja ni maagizo yanayoweza kutekelezwa

Vipengele viwili hufanya hilo liwe halisi, na vyote ni muhimu faili inapotoka kwa timu nyingine.

Kwanza, SKILL.md inaweza kutekeleza amri za shell kabla modeli haijasoma chochote. Mstari kama huu katika mwili wa faili ni preprocessing:

- Current branch: !`git rev-parse --abbrev-ref HEAD`

Amri hiyo hutekelezwa kwenye mashine inayopakia ujuzi, na matokeo yake hubadilisha placeholder kwenye maandishi ambayo modeli inapokea. Block iliyozungushiwa alama za backtick tatu na kuanza kwa ! hutekeleza amri kadhaa kwa njia hiyo hiyo. Hakuna mtu anayeidhinisha haya wakati wa utekelezaji. Kusoma ujuzi wa pamoja kunamaanisha kusoma substitutions za amri zake.

Pili, frontmatter inaweza kuidhinisha tools mapema. allowed-tools inaruhusu tools zilizoorodheshwa bila prompt ya ruhusa kwa zamu iliyoanzisha ujuzi huo. Kwa ujuzi wa mradi, ruhusa hiyo huanza kutumika mtu anapokubali workspace trust dialog ya folda. Nyaraka za Claude Code zinaeleza matokeo hayo wazi: kagua ujuzi wa miradi kabla ya kuamini repository, kwa sababu ujuzi unaweza kujipa ufikiaji mpana wa tools.

Kwa hiyo, shughulikia bump ya ujuzi kama bump ya dependency. Tumia exact commit kila mahali ambapo utaratibu unaruhusu, kwa sababu tag inaweza kuhamishwa na branch huhama kwa asili yake. Kwenye mashine iliyofungwa, "disableSkillShellExecution": true katika settings hubadilisha kila command substitution kuwa maandishi halisi [shell command execution disabled by policy] badala ya kuyatekeleza, na ikitumika kupitia managed settings mtumiaji hawezi kuibatilisha. Ujuzi uliounganishwa pamoja na ule unaosimamiwa hauathiriwi na setting hiyo.

Tahadhari hiyo hiyo inahitajika kuhusu kile ambacho ujuzi husoma. Ujuzi unaotekeleza env au kufungua config file huingiza kila kitu unachopata kwenye context ya modeli. Hili ndilo tatizo lililofafanuliwa katika kuweka secrets nje ya agents unaoendesha. Ujuzi unaofetch ukurasa au kutekeleza query hupeleka mwanya huo huo upande wa nje, kwa sababu maandishi yaliyopatikana huingia kwenye context yakionekana sawa kabisa na maagizo uliyoandika. Huu ni mpaka unaofaa kuusoma kabla ya kuelekeza agent kwenye SearXNG instance yako kwa web search.

Cha kusoma wakati wa kusasisha toleo

• Diff ya kila SKILL.md body, kwa sababu maandishi hayo ndiyo maagizo ambayo agent yako itafuata.
• Kila command substitution, kwa sababu hizo hutekelezwa kwenye mashine yako skill inapopakia.
• Mabadiliko yoyote kwenye allowed-tools, kwa sababu mstari huo hutoa zana bila kuomba uthibitisho.
• Utekelezaji wa test ulio nyuma ya tag. Ikiwa repository inayoshirikiwa huendesha smoke tests zake katika CI, tag unayoweka pin inapaswa kuwa na run iliyofanikiwa iliyoambatishwa.

Reviewer ambaye hawezi kusoma diff yote ndani ya dakika kumi anaangalia skill iliyokua kubwa kupita kiasi. Igawanye. Hoja hiyo hiyo inatumika kwa nyaraka za repository ambazo agents wako husoma: weka kanuni za kudumu katika faili zilizoelezwa kwenye mgawanyo wa AGENTS.md na HUMAN.md, na hoja za usanifu katika DESIGN.md iliyoandikwa kwa agents, kisha acha skills zibaki kuwa procedures finyu.

Mabadiliko ya model au tool yanapoharibu skill

Mambo kadhaa yanaweza kubadilika ndani ya skill bila mtu yeyote kuihariri. Upgrade ya model hubadilisha jinsi inavyofuata kwa uhakika instruction ndefu, hivyo skill iliyotegemea model kufikia hatua ya tisa inaweza kuacha kuifikia. Command line tool inaweza kubadilisha jina la flag, hivyo agent ikaendesha flag ya zamani, ikasoma error, kisha ikaamua hatua kwa kubahatisha. URL iliyorejelewa inaweza kuanza kurudisha 404. Agent harness inaweza kubadilisha jinsi inavyochagua skills, hivyo description iliyokuwa ikishinda ulinganifu inaweza isishinde tena. Procedure inapoanza kumalizika mapema kwa njia hiyo, kuongeza version hakutarekebisha tatizo. Maelekezo yenyewe yanahitaji muundo unaolazimisha hatua za mwisho kukamilishwa. Huo ndio msingi wa skill ya unlazy na mbinu yake ya Depth Tree.

Ndiyo maana smoke test huwa na uzito katika mpangilio huu. Endesha test ya kila skill kwa ratiba, na pia kila unapofanya push. Google huendesha evaluation jobs zake kila wiki dhidi ya library nzima kwa sababu hii. Kwa timu yenye skills kumi, weekly cron job kwenye VPS ndogo inatosha. Hii ndiyo njia pekee ya kupata taarifa kuhusu kuvurugika kabla developer hajakugundua.

Portability pia husaidia. Agent Skills spec inaweka frontmatter kwenye keys sita, hivyo skill iliyoandikwa kulingana na spec hiyo inaweza kupakiwa kwenye tools nyingine zaidi ya ile iliyoandikiwa. Kila key maalum kwa harness unayoongeza ni kamari kwenye vendor mmoja. Kuandika skills zinazostahimili kubadilishwa kwa model ni discipline yake yenyewe. Imeelezwa katika jinsi ya kufanya skill ifanye kazi kwenye model yoyote.

FAQ

Ninawezaje kushiriki skill moja ya agent katika repositories kadhaa?

Weka skill hiyo katika repository maalum ya git, weka tags za releases humo, kisha kila mradi unaoitumia urejelee tag badala ya kunakili file. Mbinu mbili zinafaa. Git submodule huhifadhi commit halisi, na symlink kutoka .claude/skills/<name> kwenda kwenye submodule hufanya skill ipakie kama skill ya kawaida ya mradi. Plugin marketplace hufanya kazi hiyo hiyo kupitia /plugin, huku pin ikitangazwa katika .claude/settings.json ya repository inayotumia plugin. Zote mbili huweka version kwenye historia ya git, kwa hiyo unaweza kubaini ni maagizo gani yalizalisha run fulani ya agent.

Je, ninaweza kuweka pin ya skill ya agent kwenye version maalum?

Si kutoka ndani ya SKILL.md, kwa sababu frontmatter hiyo haina key ya version. Pin lazima itoke kwenye layer inayozunguka file hilo. Git submodule huweka pin ya commit halisi kwa muundo wake. Katika Claude Code plugin marketplace, plugin source hukubali ref kwa branch au tag na sha kwa commit halisi, na sha hutangulizwa ikiwa zote zipo. Marketplace source yenyewe hukubali ref pekee. Pendelea pin ya commit, kwa sababu tag inaweza kuhamishwa baada ya kuikagua.

Smoke test ya skill inapaswa kuthibitisha nini?

Thibitisha kitu thabiti. Endesha skill bila mwingiliano dhidi ya fixture iliyo na hitilafu inayojulikana, kisha hakikisha identifier maalum inaonekana kwenye output, kwa mfano rule id ambayo skill inapaswa kuripoti. Kuomba structured output kwa kutumia --output-format json na --json-schema hufanya ukaguzi uwe sahihi, na jq -e husimamisha script wakati value hiyo haipo. Usithibitishe sentensi nzima, kwa sababu model hubadilisha maneno ya majibu yake kati ya runs.

Je, ni salama kusakinisha skill inayoshirikiwa kutoka repository ya timu nyingine?

Ichukulie kama code dependency, kwa sababu ni maagizo yanayoweza kutekelezwa. SKILL.md inaweza kuendesha shell commands wakati wa kupakia kupitia command substitution form ya !, na field ya frontmatter allowed-tools inaweza kuidhinisha tools mapema bila prompt. Soma diff katika kila bump, weka pin kwenye commit halisi badala ya branch, na pendelea source inayodhibitiwa na timu yako. Kwenye mashine zinazosimamiwa, "disableSkillShellExecution": true katika settings huzuia command substitutions kuendeshwa kabisa.

Je, skill inayoshirikiwa itafanya kazi katika agents wengine isipokuwa Claude Code?

Inategemea frontmatter unayotumia. Agent Skills spec inafafanua keys sita: name, description, license, compatibility, metadata na allowed-tools. Skill inayotumia keys hizo pekee hupakiwa katika tools zinazotekeleza spec hiyo, na pia hupakiwa katika Claude Code bila mabadiliko. Keys maalum za harness na body features zilizo nje ya spec hupuuziwa au kukataliwa kwenye tools nyingine, kwa hiyo ziondoe kwenye skill yoyote unayokusudia kushiriki kwa upana.