repos இடையே agent skills பகிரும் சரியான முறை
எட்டு repos-ல் skill-ஐ நகலெடுத்தால் copies drift ஆகும். ஒரே shared repo-வை source of truth ஆக வைத்து, ஒவ்வொரு project-லும் version-ஐ pin செய்து review செய்யுங்கள்.
Repos முழுவதும் agent skills-ஐப் பகிர்வது எப்படி
Repos முழுவதும் agent skills-ஐப் பகிர, file-ஐ நகலெடுப்பதை நிறுத்தி, அதன்மீது dependency வைத்திருக்கத் தொடங்கவும். ஒரே skills repository-ஐ பராமரித்து, அதற்கு tag உருவாக்கி, ஒவ்வொரு project-மும் ஒரு tag-ஐ pin செய்யட்டும். பின்னர் ஒவ்வொரு skill-க்கும் ஒரு smoke test சேர்க்கவும். ஒவ்வொரு version bump-ஐயும் dependency bump-ஐ review செய்வது போல review செய்யவும்.
இதில் நான்கு பகுதிகள் உள்ளன: shared source of truth, ஒவ்வொரு repository-க்கும் pinned version, ஒவ்வொரு skill-க்கும் smoke test, மற்றும் review path. கீழே உள்ள அனைத்தும் ஒவ்வொரு பகுதியும் ஏன் தேவை, 2026-ல் வெளிவரும் tools இதை எவ்வாறு கையாளுகின்றன, மேலும் வெளிப்புற git host அல்லது package registry எதையும் பயன்படுத்தாமல் self-hosted git remote-ல் முழு அமைப்பை எவ்வாறு உருவாக்குவது என்பதைக் விளக்குகின்றன. Smoke tests மட்டும் விதிவிலக்கு. அவை Claude Code-ஐ இயக்குகின்றன. Claude Code ஒவ்வொரு request-ஐயும் model API-க்கு அனுப்புகிறது. எனவே அந்த படியில் உங்கள் server-ஐ விட்டு request வெளியே செல்கிறது.
ஒரு agent skill என்பது SKILL.md file-ஐக் கொண்ட folder ஆகும். அதற்குத் தேவையான scripts மற்றும் reference files-உம் அதில் இருக்கலாம். இந்த unit உங்களுக்கு புதியதாக இருந்தால், முதலில் agent skill என்றால் என்ன, SKILL.md எவ்வாறு செயல்படுகிறது என்பதைப் படிக்கவும். இந்தப் பக்கம் அந்த unit-ஐச் சுற்றியுள்ள supply chain பற்றி விளக்குகிறது.
திறன்கள் எங்கு சேமிக்கப்படுகின்றன மற்றும் பகிர்வது ஏன் கடினம்
Claude Code பின்வரும் இடங்களிலிருந்து திறன்களை (skills) ஏற்றுகிறது, மேலும் திறன்கள் ஆவணத்தில் ஒவ்வொரு பாதையும் குறிப்பிடப்பட்டுள்ளது.
.claude/skills/<skill-name>/SKILL.mdஎன்பது நிர்வகிக்கப்படும் அமைப்புகள் கோப்பகத்திற்குள் (managed settings directory) உள்ள நிறுவனத்திற்கான இடமாகும். ஒரு நிறுவனம் இதை நிறுவும் கணினிகளில் உள்ள அனைத்து பயனர்களுக்கும் இது ஏற்றப்படும்.~/.claude/skills/<skill-name>/SKILL.mdஎன்பது தனிப்பட்ட பயன்பாட்டிற்கானது. இது உங்கள் அனைத்து திட்டங்களிலும் ஏற்றப்படும், மற்றவர்களுக்கு ஏற்றப்படாது..claude/skills/<skill-name>/SKILL.mdஎன்பது திட்ட அளவிலான (project level) இடமாகும். அந்த களஞ்சியத்தை (repository) பதிவிறக்கம் செய்யும் எவருக்கும் இது ஏற்றப்படும்.<plugin>/skills/<skill-name>/SKILL.mdஎன்பது ஒரு செருகுநிரலுக்குள் (plugin) இருக்கும். அந்த செருகுநிரல் எங்கு செயல்படுத்தப்படுகிறதோ, அங்கு இது ஏற்றப்படும்.
Claude Code ஆனது உள்ளமைக்கப்பட்ட திட்ட கோப்பகங்கள், --add-dir மூலம் வழங்கப்பட்ட கோப்பகங்கள் மற்றும் உங்கள் claude.ai கணக்கிற்காக செயல்படுத்தப்பட்ட திறன்களிலிருந்தும் திறன்களை ஏற்றுகிறது.
திட்ட அளவிலான திறன் ஒரு குழுவிற்கு மிகவும் பயனுள்ளது, ஏனெனில் அது கமிட் (commit) செய்யப்படுகிறது மற்றும் களஞ்சியத்தை குளோன் (clone) செய்யும் அனைவருக்கும் அது கிடைக்கிறது. இங்குதான் சிக்கல் தொடங்குகிறது. .claude/skills/-ல் உள்ள ஒரு திறன் ஒரு களஞ்சியத்திற்கு மட்டுமே சொந்தமானது. உங்களிடம் எட்டு களஞ்சியங்கள் இருந்தால், அந்த திறன் எட்டு முறை நகலெடுக்கப்படும்.
முன்மொழிவு (frontmatter) இதில் எந்த உதவியையும் வழங்கவில்லை. Agent Skills விவரக்குறிப்பு ஆறு விசைகளை (keys) அனுமதிக்கிறது, மேலும் நீங்கள் வேறொன்றைப் பயன்படுத்தும்போது, அதை அமல்படுத்தும் விநியோகப் பாதைகள் அந்தப் பட்டியலை அச்சிடுகின்றன:
Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, nameஇதில் இல்லாததைக் கவனியுங்கள்: version என்ற விசை இல்லை. metadata-ன் கீழ் ஒரு பதிப்பை (version) பதிவு செய்ய முடியும், ஆனால் இந்த விவரக்குறிப்பு எந்தவொரு சார்புநிலை (dependency) அல்லது புதுப்பித்தல் பொறிமுறையையும் வரையறுக்கவில்லை. இது நியாயமானது, ஏனெனில் ஒரு திறன் என்பது ஒரு தொகுப்பு (package) அல்ல, அது ஒரு ஆவணம். இதன் பொருள் பதிப்பு மேலாண்மை (versioning) என்பது கோப்பைச் சுற்றியுள்ள அடுக்கிலிருந்து வர வேண்டும், அந்த அடுக்கைப் பராமரிப்பது உங்கள் பொறுப்பு.
சிக்கல் ஒன்று: மெதுவாக வேறுபடும் எட்டு பிரதிகள்
முதல் நாளில் copy-paste செயல்படும். அறுபதாவது நாளில் அது தோல்வியடையும். ஒருவர் payments repo-வில் உள்ள தவறான instruction-ஐ சரிசெய்கிறார்; மற்ற ஏழு பிரதிகளை அவர் மாற்றுவதில்லை. வேறொருவர் orders-ல் pagination குறித்த rule-ஐச் சேர்க்கிறார். இப்போது agent எந்த directory-யிலிருந்து தொடங்கியது என்பதைப் பொறுத்து, ஒரே skill name-க்கு இரண்டு வேறுபட்ட reviews கிடைக்கின்றன. இதை எந்த developer-க்கும் தெரியாது.
இங்கு error state இல்லாததால் இந்த தோல்வி அமைதியாக நிகழ்கிறது. Skill என்பது prose மட்டுமே. காலாவதியான instruction நம்பிக்கையுடன் தவறான பதிலை உருவாக்கும்; இதுவே அதிகச் செலவுடைய தோல்வி வகையாகும். உங்கள் copy-ஐ வேறு ஒருவரின் copy-யுடன் agent ஒப்பிடுவதில்லை. ஆகவே, இரண்டு repo-களில் முரண்பாடு இருப்பதை ஒருவர் கவனிப்பதே ஒரே signal ஆகும்.
Problem two: version-ஐ எதுவும் pin செய்யப்படவில்லை
ஒரு team skills-ஐ ஒரே இடத்தில் வைத்திருந்தாலும், வழக்கமான sharing முறை copy step ஆகும்: ஒரு setup script, onboarding doc-ல் உள்ள curl line, அல்லது ஒரு folder-ஐ sync செய்யும் shell alias. இவை அனைத்தும் branch-ன் தற்போதைய head-ல் இருப்பதையே install செய்யும்.
இதனால், ஒரே application-ன் ஒரே commit-ல் இருக்கும் இரண்டு developers வெவ்வேறு instructions-ஐ இயக்கக்கூடும். காரணம், அவர்கள் வெவ்வேறு நாட்களில் sync செய்திருக்கலாம். மேலும், agent run தோல்வியடைந்த பிறகு முக்கியமான கேள்விக்கும் நீங்கள் பதிலளிக்க முடியாது: இதை எந்த version-ன் skill உருவாக்கியது? பதிவு செய்யப்பட்ட revision இல்லையெனில், அந்த run-ஐ மீண்டும் உருவாக்க முடியாது. எனவே bug report-ல் பயனுள்ள நடவடிக்கை எடுக்க முடியாது.
சிக்கல் மூன்று: அந்த skill இன்னும் செயல்படுகிறதா என்பது யாருக்கும் தெரியாது
ஒரு skill-க்கு compiler இல்லை. அது ஒரு model-க்கு வழங்கப்படும் instructions ஆகும். எனவே, file byte-by-byte அப்படியே இருந்தாலும் அது செயல்படாமல் போகலாம். Model upgrade செய்யப்பட்டால், நீண்ட instruction எவ்வளவு நெருக்கமாகப் பின்பற்றப்படுகிறது என்பது மாறும். அந்த skill பயன்படுத்தும் command line tool-ல் ஒரு flag-ன் பெயர் மாற்றப்படலாம். Reference file-ல் உள்ள URL 404 status திருப்பத் தொடங்கலாம்; அப்போது agent அந்த error page-ஐ அடிப்படையாகக் கொண்டு செயல்படும்.
இந்த நிலைகளில் எதுவும் வெளிப்படையாகத் தோல்வியடையாது. Agent தொடர்ந்து பதிலளிக்கும். ஆனால் அந்தப் பதில் கடந்த மாதத்தைவிட மோசமாக இருக்கும். ஒவ்வொரு pull request-ஐ தனித்தனியாகப் பார்க்கும்போது இதைக் கண்டறிவது கடினம்.
2026-ல் வெளியாகும் கருவிகள் தீர்க்கும் சிக்கல்கள்
தற்போது பல தீர்வுகள் முன்வைக்கப்படுகின்றன, ஆனால் பதிப்பு (version) எங்கு இருக்க வேண்டும் என்பதில் அவற்றுக்கிடையே கருத்து வேறுபாடுகள் உள்ளன.
Lockfiles. Vercel Labs-ன் skills கட்டளை வரி கருவி (vercel-labs/skills, MIT உரிமம், 9 அக்டோபர் 2026 நிலவரப்படி v1.7.2), git களஞ்சியத்திலிருந்து உங்கள் agent எதிர்பார்க்கும் கோப்பகத்திற்கு skills-ஐ நிறுவுகிறது. இது எழுபதுக்கும் மேற்பட்ட agent-களின் அமைப்பை அறியும். npx skills add <repo> நிறுவுகிறது, npx skills update மேம்படுத்துகிறது, மற்றும் npx skills list உங்களிடம் உள்ளவற்றைக் காட்டுகிறது. இது இரண்டு lock கோப்புகளைப் பராமரிக்கிறது. ~/.agents/.skill-lock.json-ல் உள்ள ஒரு உலகளாவிய கோப்பு, ஒரு பயனர் எதை நிறுவியுள்ளார் என்பதைப் பதிவு செய்கிறது. v1.4.1 (20 பிப்ரவரி 2026) முதல், project scope-ல் நிறுவும்போது, project root-ல் skills-lock.json கோப்பையும் உருவாக்குகிறது. அந்தக் கோப்பை version control-ல் சேர்க்க வேண்டும் என்று கருவியின் மூலக் குறியீடு குறிப்பிடுகிறது. npx skills experimental_install ஒரு project-ன் skills-ஐ அதிலிருந்து மீட்டெடுக்கிறது. மற்றொரு கணினியில் உலகளாவிய lock கோப்பை மீட்டெடுக்க skills install கட்டளையைக் கோரிய 283-வது சிக்கல், 5 நவம்பர் 2026 அன்று திட்டமிடப்படவில்லை எனக் கூறி மூடப்பட்டது; பராமரிப்பாளர் இதை 549-வது சிக்கலின் அதே கோரிக்கையாகக் கருதுகிறார். இரண்டையும் ஒரு நிலை அறிக்கையாகப் படிக்கவும். project-க்கு உட்பட்ட lockfile உள்ளது. வெளியிடப்பட்ட v1.8.1-ல், restore கட்டளை இன்னும் உதவிப் பகுதியில் experimental என்று குறிக்கப்பட்டுள்ளது, ஆனால் source குறிப்பிடப்படாத npx skills install கட்டளையும் project lockfile-ஐ மீட்டெடுக்கும்.
Specs மற்றும் சோதனைகள். SkillSpec மற்றொரு கோணத்தை எடுக்கிறது. இது SKILL.md-ஐ நம்பகமான உரைக்கு பதிலாகச் சரிபார்க்க வேண்டிய ஒப்பந்தமாகப் பார்க்கிறது. skills-ஐ "பின்பற்றக்கூடியதாகவும், சோதிக்கக்கூடியதாகவும், நிரூபிக்கக்கூடியதாகவும்" மாற்றுவதே இதன் நோக்கம். skillspec doctor <path> ஒரு agent எங்குத் தொடர்பைத் துண்டிக்கும் என்பதைத் தெரிவிக்கிறது. skillspec boundary map <path> ஒரு skill-ல் என்ன உள்ளது என்பதைக் காட்டுகிறது, மற்றும் skillspec boundary assess <path> அது எதை அணுக முடியும் என்பதை அபாயத்தின் அடிப்படையில் வரிசைப்படுத்தித் தெரிவிக்கிறது. இது ஒரு Rust crate, MIT அல்லது Apache 2.0 ஆகிய இரட்டை உரிமங்களைக் கொண்டது. பதிப்பு 0.2.2, 29 ஜூலை 2026 அன்று வெளியிடப்பட்டது, 10 அக்டோபர் 2026 நிலவரப்படி crates.io-வில் இதுவே புதியது. புதிய பதிப்பிற்குப் பதிலாக, குறிப்பிட்ட பதிப்பை நிறுவவும்:
cargo install skillspec --version 0.2.2 --locked
skillspec --version12 நவம்பர் 2026 அன்று வெளியிடப்பட்ட Cargo 1.100 முதல், cargo install இயல்பாகவே தொகுக்கப்பட்ட lockfile-ஐப் பயன்படுத்துகிறது, மற்றும் --locked எந்தச் செயல்பாட்டையும் செய்யாது. skillspec --version கட்டளை 0.2.2 என்று அச்சிட வேண்டும். வேறு எண் வந்தால், உங்கள் PATH-ல் உள்ள பழைய binary முன்னுரிமை பெறுகிறது என்று அர்த்தம்.
Vendor நடைமுறை. google/skills-ல் உள்ள skills-ஐ எவ்வாறு உருவாக்குவது என்பதை agent skills-ஐ உருவாக்குதல், சோதித்தல் மற்றும் அளவிடுதல் குறித்த பதிவில் Google விவரித்துள்ளது. அளவீட்டை நீக்கிவிட்டுப் பார்த்தால், அதன் செயல்முறை சாதாரண continuous integration (CI) ஆகும். ஒவ்வொரு skill-ம் இணைக்கப்படுவதற்கு முன்பு, frontmatter metadata, வரி எண்ணிக்கை, கோப்பக அமைப்பு மற்றும் பெயரிடுதல் ஆகியவற்றிற்கான linters சோதனைகளைத் தாண்ட வேண்டும். 404 பிழையைத் தரும் எந்த URL-ம் build-ஐத் தோல்வியடையச் செய்யும் link checker, agent உருவாக்கிய போலியான இணைப்புகளைக் கண்டறிய உதவுகிறது. ஆசிரியர்கள் skill-டன் சேர்த்து மதிப்பீட்டு prompt தொகுப்பையும், மதிப்பெண் வழங்கும் முறையையும் வழங்க வேண்டும். திட்டமிடப்பட்ட மதிப்பீட்டுப் பணிகள் வாரந்தோறும் முழு நூலகத்திலும் இயங்கி, தரம் குறைவதைக் கண்டறியும். ஒவ்வொரு skill-க்கும் ஒரு உரிமையாளர் உள்ளார், தரம் குறையும்போது அவர் அதைச் சரிசெய்ய வேண்டும் என்று எதிர்பார்க்கப்படுகிறது.
மூன்று பதில்களுக்கும் அடிப்படையான அமைப்பு
அந்த மூன்றில் ஒன்றைத் தேர்ந்தெடுக்க வேண்டியதில்லை. அவற்றின் அடியில் ஒரே அமைப்பு உள்ளது; plain git அதன் அனைத்து பகுதிகளையும் வழங்குகிறது.
- ஒரே truth source. ஒவ்வொரு skill-க்கும் சரியாக ஒரு இருப்பிடம் இருக்கும். ஒவ்வொரு repository-யும் copy வைத்திருப்பதற்குப் பதிலாக அந்த இருப்பிடத்தையே குறிக்கும்.
- ஒவ்வொரு repository-க்கும் pinned version. ஒவ்வொரு project-மும் பயன்படுத்தும் exact revision-ஐ பதிவு செய்கிறது. ஆகவே upgrade என்பது அந்த project-ல் author மற்றும் date கொண்ட ஒரு commit ஆகும்.
- ஒவ்வொரு skill-க்கும் smoke test. Skill உறுதியளிக்கும் result-ஐ இன்னும் உருவாக்குகிறது என்பதை நிரூபிக்கும் ஒரு runnable check இருக்கும்.
- Review path. Shared skill-ல் செய்யப்படும் மாற்றம் review வழியாகச் செல்லும். ஒவ்வொரு consumer-மும் அதை ஏற்கும் முன் diff-ஐ பார்க்கும்.
இதுவே dependency-யின் அமைப்பு. Tooling அதற்கேற்ப வளர்வதற்கும் முன்பே skills shared artifact-ஆக மாறிவிட்டன. எனவே நீங்கள் ஏற்கனவே நம்பும் tooling-ஐப் பயன்படுத்துவதே பாதுகாப்பான அணுகுமுறையாகும்.
சுயமாக host செய்யப்படும் git remote-ல் ஒரு சிறிய குழுவுக்கான layout
Skills அனைத்தும் ஒரே repository-ல் இருக்கும். வேறு எதுவும் அதில் இருக்காது. எனவே, அதன் history instructions-ன் changelog போல இருக்கும்.
agent-skills/
skills/
api-review/
SKILL.md
release-notes/
SKILL.md
tests/
api-review.sh
release-notes.sh
CHANGELOG.mdReleases என்பது tags ஆகும். Annotated tags-ஐப் பயன்படுத்தவும். அவற்றில் message மற்றும் date இருப்பதால், அந்த message-ஐ consumer ஏன் இந்த bump-ஐ விரும்புவார் என்பதை விளக்கும் காரணமாக எழுதவும்:
git tag -a v1.4.0 -m "api-review: require pagination on list endpoints"
git push origin v1.4.0உங்கள் remote Gitea, Forgejo, GitLab அல்லது உங்கள் சொந்த VPS-ல் SSH வழியாக அணுகப்படும் bare repository ஆக இருந்தாலும், அடுத்ததாகக் கூறப்படுவது எதுவும் மாறாது. இங்கு git மற்றும் ஒரு symlink மட்டுமே பயன்படுத்தப்படுகின்றன.
git submodule மூலம் குறிப்பிட்ட commit-ஐ pin செய்தல்
ஒரு submodule, மற்றொரு repository-யின் ஒரு குறிப்பிட்ட commit-ஐ உங்கள் repository-க்குள் பதிவு செய்கிறது. அந்தப் பதிவே pin ஆகும். பயன்படுத்தும் ஒவ்வொரு project-லும்:
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 முக்கியமான பகுதி. Project level-ல் உள்ள ஒரு skill entry, disk-ல் வேறு இடத்தில் உள்ள directory-க்கான symlink ஆக இருக்கலாம். Claude Code அந்த symlink-ஐப் பின்தொடர்ந்து target-இலிருந்து SKILL.md-ஐ வாசிக்கும். ஆகவே skill, வழக்கமான project skill போல load ஆகும்; அதன் files, நீங்கள் தேர்ந்தெடுத்த commit-ல் உள்ள submodule-ல் இருக்கும்.
Pin-ஐச் சரிபார்க்கவும்:
git submodule statusசரியான line, முதலில் ஒரு space, பின்னர் commit, அதன் பிறகு path, இறுதியில் அருகிலுள்ள tag ஆகிய வரிசையில் தொடங்கும்:
4d1a7c2f0b93e5a1c8d6f2b40e7a95c3d1f8b602 vendor/agent-skills (v1.4.0)முன்னிலை - இருந்தால், submodule இதுவரை initialise செய்யப்படவில்லை. அதனால் .claude/skills/api-review எதையும் சுட்டிக்காட்டாது; skill அமைதியாக load ஆகாது. இதை git submodule update --init மூலம் சரிசெய்யவும். முன்னிலை + இருந்தால், checkout செய்யப்பட்ட commit, பதிவு செய்யப்பட்ட commit-இலிருந்து வேறுபடுகிறது. ஆகவே அந்த developer, மற்றவர்கள் யாரும் பயன்படுத்தாத instructions-ஐ இயக்குகிறார். புதிய clones-க்கு git clone --recurse-submodules தேவை. அந்த line README-ல் இருக்க வேண்டும். ஏனெனில் plain clone, vendor/agent-skills-ஐ காலியாக விட்டுவிட்டு எந்த error-ஐயும் காட்டாது.
Upgrade திட்டமிட்ட முறையில் செய்யப்பட வேண்டும். இதுவே இதன் முக்கிய நோக்கம்:
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"diff line review-க்கான வழியாகும். மற்ற அனைத்து consuming repos-லும் காணப்படும் அதே மாற்றத்தை இது காட்டுகிறது. மேலும், இது pull request-க்குள் எளிதாகப் பரிசீலிக்க முடியும்.
plugin marketplace மூலம் pinning செய்தல்
ஒவ்வொரு developer-ம் submodule-களைக் கற்றுக்கொள்ள வேண்டிய அவசியமில்லை என நீங்கள் கருதினால், Claude Code plugin அமைப்பு உங்களுக்காக விநியோகத்தைச் செய்துவிடும். இது self-hosted remote-உடன் இணைந்து செயல்படும். skills repository-ல் .claude-plugin/marketplace.json-ல் ஒரு catalog-ஐ உருவாக்கவும்:
{
"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"
}
}
]
}இங்கே இரண்டு வெவ்வேறு sources பயன்பாட்டில் உள்ளன; இரண்டையும் குழப்பிக்கொள்வது பொதுவான தவறு. marketplace source, அதாவது catalog எங்கிருந்து பெறப்படுகிறது என்பது, branch அல்லது tag-க்கு ref-ஐ ஏற்கும். Claude Code v2.1.324 அல்லது அதற்குப் பிந்தைய பதிப்புகளில், முழுமையான lowercase commit SHA-வையும் ஏற்கும்; இது தனித்தனி sha field-ஐ ஏற்காது. catalog-க்குள் இருக்கும் plugin source இரண்டையும் ஏற்கும்; இரண்டும் குறிப்பிடப்பட்டிருந்தால், sha-வே இறுதியான pin-ஆகக் கருதப்படும். marketplace source-ன் ref மூலம் catalog-ஐயும், catalog entry-ன் sha மூலம் plugin-ஐயும் pin செய்யவும். இவற்றின் type பெயர்களும் மாறுபடும். catalog-க்குள், url என்பது clone செய்யப்பட வேண்டிய git repository-ஐக் குறிக்கும். marketplace source-ல், url என்பது marketplace.json கோப்பிற்கான நேரடி இணைப்பைக் குறிக்கும், git repository என்பது git ஆகும்.
ஒவ்வொரு consuming repository-ம் அதன் committed .claude/settings.json-ல் marketplace-ஐ அறிவிக்கும்:
{
"extraKnownMarketplaces": {
"acme-agents": {
"source": {
"source": "git",
"url": "https://git.example.com/team/agent-skills.git",
"ref": "v1.4.0"
}
}
},
"enabledPlugins": {
"team-skills@acme-agents": true
}
}ஒரு teammate project folder-க்கான workspace trust dialog-ஐ ஏற்றுக்கொண்டவுடன், Claude Code அவர்களுக்காக marketplace-ஐப் பதிவு செய்துவிடும்; இதைச் செய்யச் சொல்லி அவர்களுக்கு wiki பக்கம் எதையும் காட்ட வேண்டியதில்லை. catalog entry ஒரு relative path-க்கு பதிலாக git URL-ஐச் சுட்டிக்காட்டுகிறது, எனவே plugin-ஆனது repository-ன் settings-ஐ மட்டும் வைத்துக்கொண்டு install ஆகாது. ஒவ்வொரு teammate-ம் ஒருமுறை claude plugin install team-skills@acme-agents --scope project-ஐ இயக்க வேண்டும்; அதுவரை plugin project settings-ல் enabled நிலையில் இருப்பதாக Claude Code காட்டும், ஆனால் அது install ஆகியிருக்காது. பின்னர் skills /team-skills:api-review-க்கு பதிலளிக்கும், ஏனெனில் plugin skills-ஆனவை plugin பெயரால் namespaced செய்யப்படுகின்றன, எனவே அதே பெயரில் உள்ள project skill-உடன் அவை மோதிக்கொள்ளாது. நீங்கள் புதிய tag-ஐ push செய்து, catalog மற்றும் consuming repositories-ல் pins-ஐப் புதுப்பித்த பிறகு, பயனர்கள் /plugin marketplace update acme-agents மூலம் refresh செய்ய வேண்டும், பின்னர் install summary கேட்டால் /reload-plugins-ஐ இயக்க வேண்டும்.
ஒரு skill-க்கான smoke test எழுதுதல்
Smoke test என்பது, அறியப்பட்ட fault கொண்ட fixture-க்கு எதிராக script மூலம் agent-ஐ இயக்கி, ஒரு assertion செய்வதாகும். Claude Code, -p உடன் non-interactive முறையில் இயங்கும். User-invoked skill அங்கேயும் செயல்படும்: prompt string-ல் /skill-name-ஐ சேர்த்தால், run தொடங்குவதற்கு முன் அது விரிவாக்கப்படும்.
#!/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/nullfixtures/orders-api.md என்பது திட்டமிட்டு சேர்க்கப்பட்ட ஒரு fault கொண்ட சிறிய file ஆகும். அந்த skill fault-ஐ பெயரிட்டு குறிப்பிடுகிறதா என்பதே assertion. அதன் filter null-ஐ உருவாக்கும்போது jq -e non-zero status-உடன் முடிவடையும். எனவே, seed செய்யப்பட்ட fault-ஐ கண்டறியாமல் நிறுத்தும் skill இந்த script-ல் தோல்வியடையும். Run தோல்வியடைந்தால் claude தானாகவே non-zero status-உடன் முடிவடையும். set -euo pipefail இந்த இரண்டு தோல்விகளில் ஏதேனும் ஒன்றை failed test-ஆக மாற்றும்.
ஒரு model, வெவ்வேறு run-களில் தனது பதில்களை வேறு சொற்களில் எழுதலாம். எனவே, முழு sentence-ஐ ஒருபோதும் assertion செய்ய வேண்டாம். Skill வெளியிட வேண்டிய identifier அல்லது நீங்கள் கேட்ட schema-விலுள்ள field ஒன்றை assertion செய்யவும். Run குறைந்த செலவில் நடைபெற, fixture-ஐ சிறியதாக வைத்திருக்கவும்.
CI-ல் --bare-ஐ சேர்க்கவும். இதைச் சேர்க்கவில்லை என்றால், claude -p ஒரு interactive session பயன்படுத்தும் அதே context-ஐ load செய்யும். இதில் hooks, plugins மற்றும் அது இயங்கும் machine-ல் உள்ள CLAUDE.md ஆகியவையும் அடங்கும். இதனால் teammate-ன் தனிப்பட்ட configuration result-ஐ மாற்றக்கூடும். Explicit-ஆக --add-dir மூலம் வழங்கப்பட்ட directory-யின் கீழ் உள்ள .claude/skills/-ல் இருக்கும் skills-ஐத் தவிர, bare mode auto-discovery-ஐத் தவிர்க்கும். இங்கு நீங்கள் test செய்யும் project skill-ஐ அது skip செய்யும். எனவே அந்த skill-ஐ explicit-ஆக load செய்யவும். Bare mode உங்கள் subscription login-ஐயும் read செய்யாது. ஆகவே முதலில் environment-ல் ANTHROPIC_API_KEY-ஐ அமைக்கவும்:
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--plugin-dir மூலம் load செய்யப்படும் plugin, அதன் பெயரை .claude-plugin/plugin.json-லிருந்து பெறும். அந்த manifest இல்லையெனில், அதன் directory பெயரே plugin பெயராகப் பயன்படுத்தப்படும். Skills repository-ல் உள்ள catalog-க்கு அருகில் "name": "team-skills" உடன் ஒரு plugin.json-ஐ commit செய்யவும். இல்லையெனில், மேலே உள்ள command-ல் /agent-skills:api-review-ஐ அழைக்க வேண்டியிருக்கும்.
--output-format stream-json உடன், system/init event load செய்யப்பட்ட plugins-ஐ குறிப்பிடும். Load ஆகாத plugins-க்கான plugin_errors array-யையும் அது கொண்டிருக்கும். Startup events முதலில் வராவிட்டால், அது stream-ஐத் திறக்கும். plugin_errors காலியாக இல்லாதபோது CI job-ஐ fail செய்யவும். இல்லையெனில் agent உங்கள் house rules-ஐ அமைதியாகப் புறக்கணிக்கும் வகையில் தோன்றும்; இனி இல்லாத revision-ஐ நோக்கி pin அமைக்கப்பட்டிருப்பதையும் இது கண்டறியும்.
ஒரு shared skill என்பது செயல்படுத்தக்கூடிய instruction
இந்தக் கூற்றை உண்மையாக்கும் இரண்டு features உள்ளன. அந்த file மற்றொரு team-இலிருந்து வந்தால், இரண்டும் முக்கியம்.
முதலில், ஒரு SKILL.md model எதையும் படிப்பதற்கு முன் shell commands-ஐ இயக்கலாம். Body-யில் உள்ள இதுபோன்ற line preprocessing ஆகும்:
- Current branch: !`git rev-parse --abbrev-ref HEAD`இந்த command-ஐ skill-ஐ load செய்யும் machine இயக்கும். அதன் output, model பெறும் text-இல் உள்ள placeholder-ஐ மாற்றும். மூன்று backticks-க்கு பிறகு ! கொண்டு தொடங்கும் fenced block-உம் இதே முறையில் பல commands-ஐ இயக்கும். Runtime-ல் இதற்காக யாரிடமும் prompt காட்டப்படாது. Claude Code ஒவ்வொரு command-ஐயும் உங்கள் permission rules-க்கு எதிராகச் சரிபார்க்கும். auto mode-க்கு வெளியே, அந்த rules அனுமதிக்காத command skill-ஐ நிறுத்தும்; கீழே உள்ள இரண்டாவது feature மூலம் skill அதற்கு முன்கூட்டியே அனுமதி அளித்திருந்தால் மட்டும் இது நடக்காது. Deny மற்றும் ask rules அந்த முன்அனுமதியை இன்னும் override செய்யும். Shared skill-ஐ வாசிப்பது, அதிலுள்ள command substitutions-ஐயும் வாசிப்பதாகும்.
இரண்டாவதாக, frontmatter tools-க்கு முன்கூட்டியே அனுமதி அளிக்கலாம். allowed-tools பட்டியலிடப்பட்ட tools-ஐ, skill-ஐ invoke செய்த turn-க்கு permission prompt இல்லாமல் அனுமதிக்கும். Workspace trust இந்த grant-ஐ கட்டுப்படுத்தாது: யாரும் trust செய்யாத folder-ல் -p run நடந்தாலும், Claude Code project skill-ன் allowed-tools-ஐ பயன்படுத்தும். இதன் விளைவை Claude Code documentation தெளிவாகக் கூறுகிறது: ஒரு skill தனக்கே பரந்த tool access-ஐ grant செய்ய முடியும். எனவே, அங்கு Claude Code-ஐ run செய்வதற்கு முன் repository-யில் checked in செய்யப்பட்ட skills-ன் allowed-tools-ஐ review செய்யவும். Managed settings-ல் allowManagedPermissionRulesOnly-ஐ அமைப்பதன் மூலம், organization ஒன்று project மற்றும் personal skills-இலிருந்து இந்த field-ஐ நீக்கலாம். இதற்கு Claude Code v2.1.282 அல்லது அதற்குப் பிந்தைய version தேவை.
எனவே, skill bump-ஐ dependency bump போலவே கையாளவும். Mechanism அனுமதிக்கும் இடங்களில் exact commit மூலம் pin செய்யவும். காரணம், tag-ஐ மாற்ற முடியும்; branch என்பது வரையறையிலேயே மாறிக்கொண்டிருக்கும். Locked-down machine-ல், settings-இல் உள்ள "disableSkillShellExecution": true ஒவ்வொரு command substitution-ஐயும் இயக்காமல், literal text [shell command execution disabled by policy] ஆக மாற்றும். Managed settings மூலம் இது பயன்படுத்தப்பட்டால், user இதை override செய்ய முடியாது. Bundled மற்றும் managed skills இந்த setting-இலிருந்து விலக்கு பெறும்.
Skill எதை வாசிக்கிறது என்பதற்கும் இதே கவனம் தேவை. env-ஐ இயக்கும் அல்லது config file-ஐத் திறக்கும் skill, அங்கு கிடைக்கும் அனைத்தையும் model-ன் context-க்குள் கொண்டு வரும். இது நீங்கள் இயக்கும் agents-இலிருந்து secrets-ஐ விலக்கி வைப்பது பகுதியில் விளக்கப்பட்ட failure ஆகும். ஒரு page-ஐ fetch செய்யும் அல்லது query-ஐ இயக்கும் skill, இதே exposure-ஐ வெளிப்புறமாக ஏற்படுத்தும். காரணம், retrieved text நீங்கள் எழுதிய instructions போலவே context-க்குள் தோன்றும். எனவே web search-க்காக உங்கள் சொந்த SearXNG instance-ஐ agent-க்கு வழங்குவதுற்கு முன், இந்த boundary குறித்து படித்தறிவது நல்லது.
version bump செய்யும்போது படிக்க வேண்டியவை
- ஒவ்வொரு
SKILL.mdbody-யின் diff-ஐப் படிக்க வேண்டும்; ஏனெனில் அந்த உரையே உங்கள் agent பின்பற்றும் instruction ஆகும். - ஒவ்வொரு command substitution-ஐயும் படிக்க வேண்டும்; skill load ஆகும்போது அவை உங்கள் machine-ல் இயங்கும்.
allowed-tools-ல் செய்யப்பட்ட எந்த மாற்றத்தையும் படிக்க வேண்டும்; அந்த வரி prompt இல்லாமல் tools-ஐ வழங்குகிறது.- tag-க்கு பின்னால் இயங்கிய test run-ஐப் படிக்க வேண்டும். Shared repository தனது smoke tests-ஐ CI-ல் இயக்கினால், நீங்கள் pin செய்யும் tag-க்கு இணைக்கப்பட்ட green run இருக்க வேண்டும்.
ஒரு reviewer பத்து நிமிடங்களில் முழு diff-ஐப் படிக்க முடியவில்லை என்றால், அந்த skill அளவுக்கு அதிகமாக வளர்ந்துள்ளது. அதை பிரிக்க வேண்டும். உங்கள் agents படிக்கும் repository documents-க்கும் இதே விதி பொருந்தும்: நிலையான rules-ஐ AGENTS.md மற்றும் HUMAN.md பிரிப்பு-ல் குறிப்பிடப்பட்ட files-ல் வைத்திருக்க வேண்டும்; architectural reasoning-ஐ agents-க்காக எழுதப்பட்ட DESIGN.md-ல் வைக்க வேண்டும்; skills-ஐ குறுகிய procedures-ஆக வைத்திருக்க வேண்டும்.
ஒரு model அல்லது tool மாற்றம் skill-ஐ பாதிக்கும்போது
யாரும் skill-ஐத் திருத்தாமல், அதன் அடிப்படையில் பல விஷயங்கள் மாறலாம். ஒரு model upgrade, நீண்ட instruction-ஐப் பின்பற்றும் நம்பகத்தன்மையை மாற்றலாம். இதனால், ஒன்பதாவது step-ஐ model அடையும் என்று சார்ந்திருந்த skill, அங்கு செல்வதை நிறுத்தலாம். ஒரு command line tool, flag-ன் பெயரை மாற்றலாம். அப்போது agent பழைய flag-ஐ இயக்கி, error-ஐப் படித்து, தன்னிச்சையாக அடுத்த நடவடிக்கையைத் தேர்ந்தெடுக்கலாம். குறிப்பிடப்பட்ட URL, 404-ஐத் திருப்பி அனுப்பத் தொடங்கலாம். ஒரு agent harness, skills-ஐத் தேர்ந்தெடுக்கும் முறையை மாற்றலாம். இதனால் முன்பு match-ல் வென்ற description இனி வெல்லாமல் போகலாம். ஒரு procedure இவ்வாறு முன்கூட்டியே முடிவடையத் தொடங்கினால், எந்த version bump-உம் அதைச் சரிசெய்யாது. அதற்குப் பதிலாக, instructions-க்கு கடைசி steps கட்டாயமாக இயங்கும் வகையிலான structure தேவை. unlazy skill மற்றும் அதன் Depth Tree method இதையே அணுகுமுறையாகக் கொண்டுள்ளது.
இதனால்தான் இந்த arrangement-ல் smoke test முக்கியப் பங்கைக் கொண்டுள்ளது. ஒவ்வொரு skill-ன் test-ஐ push நேரத்தில் மட்டுமல்லாமல், திட்டமிட்ட schedule-லும் இயக்கவும். இந்தக் காரணத்திற்காக Google தனது முழு library-க்கு எதிராக evaluation jobs-ஐ வாரந்தோறும் இயக்குகிறது. பத்து skills கொண்ட ஒரு team-க்கு சிறிய VPS-ல் இயங்கும் weekly cron job போதுமானது. Developer பிரச்சினையை அறியும் முன்பே breakage பற்றி அறிய இதுவே ஒரே வழி.
Portability-யும் உதவுகிறது. Agent Skills spec, frontmatter-ஐ ஆறு keys-க்கு வரையறுக்கிறது. ஆகவே, அந்த spec-க்கு ஏற்ப எழுதப்பட்ட skill, அதற்காக எழுதப்பட்ட tool-ஐத் தாண்டிய பிற tools-லும்கூட load ஆகும். அதே நேரத்தில், நீங்கள் சேர்க்கும் ஒவ்வொரு harness-specific key-உம் ஒரு vendor மீது வைக்கும் நம்பிக்கையாகும். Model மாற்றத்திற்குப் பிறகும் இயங்கும் skills-ஐ எழுதுவது தனித்துவமான ஒரு discipline. இது எந்த model-லிலும் skill இயங்கச் செய்வது என்ற பகுதியில் விளக்கப்பட்டுள்ளது.
FAQ
ஒரு agent skill-ஐ பல repositories-ல் எவ்வாறு பகிர்வது?
அந்த skill-ஐ ஒரு பிரத்யேக git repository-ல் வைத்து, அதில் releases-ஐ tag செய்யவும். கோப்புகளை நகலெடுப்பதற்குப் பதிலாக, ஒவ்வொரு project-லும் ஒரு குறிப்பிட்ட tag-ஐ reference செய்யவும். இதற்கு இரண்டு வழிகள் உள்ளன. ஒரு git submodule துல்லியமான commit-ஐப் பதிவு செய்யும்; .claude/skills/<name>-லிருந்து submodule-க்கு ஒரு symlink உருவாக்குவதன் மூலம் அது ஒரு சாதாரண project skill போல இயங்கும். ஒரு plugin marketplace, /plugin மூலம் இதே வேலையைச் செய்கிறது; இதில் பயன்படுத்தும் repository-ன் .claude/settings.json-ல் pin விவரம் குறிப்பிடப்படும். இவை இரண்டுமே version-ஐ git history-ல் வைப்பதால், எந்தெந்த instructions ஒரு குறிப்பிட்ட agent run-ஐ உருவாக்கியது என்பதை உங்களால் கண்டறிய முடியும்.
ஒரு agent skill-ஐ ஒரு குறிப்பிட்ட version-க்கு pin செய்ய முடியுமா?
SKILL.md-க்குள் இருந்து இதைச் செய்ய முடியாது, ஏனெனில் அந்த frontmatter-ல் version key இல்லை. அந்த கோப்பைச் சுற்றியுள்ள layer-லிருந்துதான் pin செய்யப்பட வேண்டும். ஒரு git submodule வடிவமைப்பிலேயே ஒரு துல்லியமான commit-ஐ pin செய்கிறது. Claude Code plugin marketplace-ல், ஒரு plugin source, branch அல்லது tag-க்கு ref-ஐயும், துல்லியமான commit-க்கு sha-ஐயும் ஏற்கும்; இவை இரண்டும் இருக்கும்போது sha முன்னுரிமை பெறும். marketplace source-ஆனது branch, tag அல்லது Claude Code v2.1.324 அல்லது அதற்குப் பிந்தைய பதிப்புகளில், முழுமையான lowercase commit SHA-வை ref மூலம் ஏற்கும். நீங்கள் review செய்த பிறகு tag மாற்றப்படலாம் என்பதால், commit pin-ஐப் பயன்படுத்துவதே சிறந்தது.
ஒரு skill smoke test எதை உறுதிப்படுத்த வேண்டும்?
நிலையான ஒன்றின் மீது assert செய்யவும். ஒரு அறியப்பட்ட fault உள்ள fixture-க்கு எதிராக skill-ஐ non-interactive முறையில் இயக்கவும். பின்னர், output-ல் ஒரு குறிப்பிட்ட identifier வருகிறதா என்று சரிபார்க்கவும் (உதாரணமாக, அந்த skill தெரிவிக்க வேண்டிய rule id). --output-format json மற்றும் --json-schema மூலம் structured output-ஐக் கோருவது சரிபார்ப்பைத் துல்லியமாக்கும்; மதிப்பு விடுபட்டால் jq -e அந்த script-ஐத் தோல்வியடையச் செய்யும். முழு வாக்கியத்தையும் வைத்து assert செய்ய வேண்டாம், ஏனெனில் ஒவ்வொரு முறை இயக்கும்போதும் model அதன் பதில்களை மாற்றக்கூடும்.
மற்றொரு குழுவின் repository-லிருந்து பகிரப்பட்ட skill-ஐ நிறுவுவது பாதுகாப்பானதா?
இதை ஒரு code dependency-ஆகக் கருதவும், ஏனெனில் இது இயங்கக்கூடிய instruction ஆகும். ஒரு SKILL.md, ! command substitution வடிவம் மூலம் load ஆகும்போது shell commands-ஐ இயக்க முடியும். மேலும், frontmatter allowed-tools field, prompt இல்லாமலேயே tools-க்கு முன்கூட்டியே அனுமதி அளிக்கலாம். ஒவ்வொரு bump-ன் போதும் diff-ஐப் படிக்கவும், branch-க்கு பதிலாக ஒரு துல்லியமான commit-க்கு pin செய்யவும், உங்கள் சொந்தக் குழுவின் கட்டுப்பாட்டில் உள்ள source-ஐப் பயன்படுத்தவும். நிர்வகிக்கப்படும் கணினிகளில் (managed machines), settings-ல் உள்ள "disableSkillShellExecution": true, user, project, plugin மற்றும் additional-directory skills-ல் command substitutions இயங்குவதைத் தடுக்கும்; bundled மற்றும் managed skills-க்கு இதற்கு விலக்கு உண்டு.
பகிரப்பட்ட skill, Claude Code அல்லாத பிற agents-ல் வேலை செய்யுமா?
இது நீங்கள் பயன்படுத்தும் frontmatter-ஐப் பொறுத்தது. Agent Skills spec ஆறு keys-ஐ வரையறுக்கிறது: name, description, license, compatibility, metadata மற்றும் allowed-tools. அந்த spec-ஐச் செயல்படுத்தும் கருவிகளில், இந்த keys-க்கு உட்பட்ட skill இயங்கும்; இது மாற்றங்கள் ஏதுமின்றி Claude Code-லும் இயங்கும். spec-க்கு அப்பாற்பட்ட harness-specific keys மற்றும் body features பிற இடங்களில் புறக்கணிக்கப்படும் அல்லது நிராகரிக்கப்படும். எனவே, நீங்கள் பரவலாகப் பகிர விரும்பும் எந்தவொரு skill-லும் அவற்றைச் சேர்க்க வேண்டாம்.