Claude Code skills: திறன்கள் எப்படி அமைந்துள்ளன, SKILL.md என்றால் என்ன, முகவர் அவற்றை எப்போது ஏற்றுகிறது

Claude Code-இல் skills என்றால் என்ன

Skill (திறன்) என்பது SKILL.md கோப்பு உள்ள ஒரு அடைவு; அதில் ஒரு குறிப்பிட்ட வகைப் பணிக்கான அறிவுறுத்தல் எழுதப்பட்டிருக்கும்: திட்டத்தை எப்படி deploy செய்வது, review எப்படி நடத்துவது, release எப்படி வெளியிடுவது. முகவருக்கு திறன் அமர்வின் தொடக்கத்திலிருந்தே தெரியும், ஆனால் பணிக்கு அது தேவைப்படும்போது மட்டுமே முழுவதும் படிக்கிறது.

Claude Code skills நீண்ட காலமாக CLAUDE.md-ஐ எழுதுபவர்கள் அனைவரும் அறிந்த பிரச்சினையைத் தீர்க்கின்றன: அறிவுறுத்தல் கோப்பு பெருகிக்கொண்டே போகிறது. 80 வரி deploy நடைமுறை வாரத்துக்கு ஒரு முறை மட்டுமே தேவை, ஆனால் அது ஒவ்வொரு அமர்விலும் context-இல் இடம் பிடிக்கிறது — README-இல் ஒரு எழுத்துப் பிழையைத் திருத்தும்போதும். Skill இத்தகைய நடைமுறைகளை நிலையான context-இலிருந்து வெளியே எடுத்து தேவைக்கேற்ப இணைக்கிறது.

ஒரு திறனின் அமைப்பு

குறைந்தபட்ச திறன் ஒரு அடைவும் ஒரு கோப்பும். திட்டத் திறன்கள் களஞ்சியத்தில் இருக்கும், தனிப்பட்டவை பயனரின் வீட்டு அடைவில்:

.claude/skills/deploy/SKILL.md      # திட்டத் திறன், git வழியாக குழுவுக்குப் பொதுவானது
~/.claude/skills/review/SKILL.md    # தனிப்பட்ட திறன், எல்லா திட்டங்களிலும் கிடைக்கும்

SKILL.md-இன் அருகில் உதவிக் கோப்புகளை வைக்கலாம்: வார்ப்புருக்கள், ஸ்கிரிப்டுகள், குறிப்பு நூல்கள். முக்கிய உரை அவற்றைக் குறிப்பிட்டு, தேவைப்பட்டால் மட்டுமே முகவர் அவற்றைத் திறக்கும்:

.claude/skills/deploy/
├── SKILL.md           # முக்கிய அறிவுறுத்தல்
├── checklist.md       # விரிவான சரிபார்ப்புப் பட்டியல், இணைப்பின் வழியாகப் படிக்கப்படும்
└── rollback.sh        # திரும்பப்பெறும் ஸ்கிரிப்ட்

Frontmatter: name மற்றும் description

கோப்பு --- கோடுகளுக்கு இடையில் YAML தொகுதியுடன் தொடங்குகிறது. மற்ற எல்லாவற்றையும்விட இரண்டு புலங்கள் முக்கியம்: name — திறனின் குறுகிய பெயர், மற்றும் description — அது என்ன செய்கிறது, எப்போது பயன்படுத்த வேண்டும் என்ற விளக்கம்.

---
name: deploy
description: FTP வழியாக தளத்தை hosting-இல் deploy செய்தல். மாற்றங்களை சர்வருக்கு அனுப்ப வேண்டியபோது, சர்வருடனான வேறுபாடுகளைச் சரிபார்க்க அல்லது deploy-ஐ திரும்பப்பெற வேண்டியபோது பயன்படுத்தவும்.
---

# Deploy

1. முதலில் சோதனை ஓட்டம்: ./deploy.sh -n.
2. கோப்புப் பட்டியலைச் சரிபார்க்கவும்: அதில் ரகசியங்களும் சோதனை ஸ்கிரிப்டுகளும் இருக்கக்கூடாது.
3. அனுப்பவும்: ./deploy.sh.
4. மாற்றப்பட்ட பக்கங்களைத் திறந்து அவை 200 தருகின்றனவா என்று உறுதிசெய்யவும்.

திரும்பப்பெறுதல் — இந்த அடைவில் உள்ள rollback.sh-ஐப் பார்க்கவும்.

Frontmatter-க்குக் கீழே சாதாரண Markdown: படிகள், கட்டளைகள், கட்டுப்பாடுகள், அருகிலுள்ள கோப்புகளுக்கான இணைப்புகள். அதை முதல் முறையாக இந்தப் பணியைச் செய்யும் புதிய சக ஊழியருக்கு எழுதுவது போல் எழுதுங்கள்.

முகவர் திறனை எப்போது ஏற்றுகிறது

அமர்வின் தொடக்கத்தில் ஒவ்வொரு கிடைக்கும் திறனின் பெயரும் விளக்கமும் மட்டுமே context-இல் செல்லும். ஒரு திறனுக்கு இது சில வரிகள், எனவே பத்துகளை வைத்திருக்கலாம். பயனரின் கோரிக்கையோ தற்போதைய படியோ விளக்கத்துடன் பொருந்தும்போது முகவர் திறனை அழைக்கிறது — அப்போதுதான் SKILL.md-இன் முழு உரை context-இல் ஏற்றப்படுகிறது.

இதிலிருந்து முக்கியமான நடைமுறை விதி வருகிறது: திறன் விளக்கத்தின் படி இயங்குகிறது. அதைத் திறக்க முடிவு செய்யும் வரை முகவர் திறனின் உடலைப் பார்க்காது. description-இல் «உதவிகரமான திறன்» என்று எழுதியிருந்தால், அது எப்போது தேவை என்று முகவருக்குத் தெரியாது. «தளத்தை hosting-இல் deploy செய்தல்; மாற்றங்களை சர்வருக்கு அனுப்ப அல்லது திரும்பப்பெற வேண்டியபோது பயன்படுத்தவும்» என்று எழுதியிருந்தால் தெரியும்.

தானியங்கி தேர்வைத் தவிர, திறனை பெயரால் slash மூலம் வெளிப்படையாக அழைக்கலாம், எடுத்துக்காட்டாக /deploy. எந்த நடைமுறை தேவை என்று உறுதியாகத் தெரிந்தால், கோரிக்கையை முகவர் விளக்கத்துடன் பொருத்தும் என்று நம்பாமல் இதைப் பயன்படுத்தலாம்.

description எப்படி எழுதுவது, திறன் வேலை செய்ய

• என்ன செய்கிறது — ஒரு வாக்கியத்தில், வினைச்சொல்லுடன்: «தளத்தை deploy செய்தல்», «commit-க்கு முன் மாற்றங்களை review செய்தல்».
• எப்போது பயன்படுத்த வேண்டும் — பயனர் உண்மையில் இந்தப் பணியைக் கேட்கும் சொற்றொடர்களை பட்டியலிடுங்கள்: «சர்வருக்கு அனுப்பு», «வெளியிடு», «திரும்பப்பெறு».
• எப்போது பயன்படுத்தக்கூடாது, அருகிலுள்ள திறனுடன் குழப்பம் வந்தால்: «bot-ஐ deploy செய்ய அல்ல, தளத்துக்கு மட்டும்».
• «பயனுள்ள திறன்», «வேலையில் உதவுகிறது» போன்ற பொதுவான சொற்களைத் தவிருங்கள் — அவை எந்த சமிக்ஞையும் தருவதில்லை.

படிப்படியான வெளிப்படுத்தல்

Skills படிப்படியான வெளிப்படுத்தல் (progressive disclosure) கொள்கையில் கட்டப்பட்டுள்ளன: தகவல் அடுக்குகளாக வழங்கப்படுகிறது, ஒவ்வொரு அடுத்த அடுக்கும் தேவைப்படும்போது மட்டுமே ஏற்றப்படுகிறது.

இது அறிவுறுத்தல் கோப்பில் ஒரு பெரிய சுவருக்குப் பதிலாக ஒரு router வைப்பது போன்றது: சுருக்கமான வரைபடம் எப்போதும் கையில், விவரங்கள் இணைப்பின் வழியாக. வேறுபாடு என்னவென்றால், திறன் இந்த ஏற்றுதலை ஒரு இயல்பான பொறிமுறையாக்குகிறது — முகவர் தானாகவே தேவையான ஆவணத்தைத் திறக்கும் என்ற நம்பிக்கையில் அல்ல. கூடுதல் நன்மை: மூன்றாம் அடுக்கில் உள்ள ஸ்கிரிப்டை முகவர் அதன் முழுக் குறியீட்டையும் context-இல் ஏற்றாமல் ஒரு சாதாரண கட்டளையாக இயக்க முடியும்.

Skills, CLAUDE.md மற்றும் slash-கட்டளைகள்: வேறுபாடு என்ன

மூன்று பொறிமுறைகளும் முகவருக்கு அறிவுறுத்தல்களை வழங்குகின்றன, ஆனால் வெவ்வேறு தருணங்களில், context-க்கு வெவ்வேறு விலையுடன்.

தேர்வுக்கான நடைமுறை விதி எளிது. அறிவுறுத்தல் கிட்டத்தட்ட ஒவ்வொரு பணிக்கும் தேவைப்பட்டால் — அதன் இடம் CLAUDE.md. ஒரு வகைப் பணிக்கு மட்டும் தேவைப்பட்டால் — அது ஒரு திறன். ஒவ்வொரு முறையும் நீங்களே ஒரே நீண்ட கோரிக்கையைத் தட்டச்சு செய்தால் — அது கட்டளை அல்லது கைமுறையாக அழைக்கப்படும் திறனுக்கான வேட்பாளர்.

கடுமையான தடைகளை திறனுக்குள் வைக்காதீர்கள். திறன் ஏற்றப்படாமலும் போகலாம், «ரகசியங்களை ஒருபோதும் commit செய்யாதே» என்ற விதி எப்போதும் செயல்பட வேண்டும். அத்தகைய மாறாத விதிகள் CLAUDE.md-இல் இருக்கும், முடிந்தால் hooks, அணுகல் அனுமதிகள், CI சரிபார்ப்புகள் மூலம் வலுப்படுத்தப்படும்.

Claude Code-க்கு skill உருவாக்குவது எப்படி: படிப்படியாக

1. மீண்டும் வரும் நடைமுறையைக் கண்டுபிடியுங்கள். நல்ல அறிகுறி: ஒரே விஷயத்தை முகவருக்கு மூன்று முறை விளக்கியிருப்பீர்கள், அல்லது CLAUDE.md-இல் பத்தில் ஒரு பணிக்கு மட்டும் தேவைப்படும் ஒரு பகுதி இருக்கும்.
2. அடைவை உருவாக்குங்கள் .claude/skills/<பெயர்>/ மற்றும் உள்ளே SKILL.md கோப்பு.
3. frontmatter எழுதுங்கள் — name மற்றும் description, எப்போது பயன்படுத்த வேண்டும் என்பது தெளிவாக.
4. படிகளை விவரியுங்கள் — குறிப்பிட்ட கட்டளைகளுடனும் தயார்நிலை அளவுகோல்களுடனும்: எதைச் சரிபார்க்க வேண்டும், எந்த முடிவு வெற்றியாகக் கருதப்படும்.
5. நீளமானதை வெளியே வையுங்கள் அருகிலுள்ள கோப்புகளில், முக்கிய உரையிலிருந்து இணைப்பு கொடுங்கள்.
6. CLAUDE.md-இலிருந்து நகலை நீக்குங்கள், ஒரு சுட்டி வரி மட்டும் வைத்து: «Deploy — deploy திறன்».
7. சரிபாருங்கள்: புதிய அமர்வில் திறனின் பெயரைக் குறிப்பிடாமல் பணியை உங்கள் சொற்களில் கேளுங்கள், முகவர் அதை எடுத்துக்கொள்கிறதா என்று பாருங்கள். இல்லையென்றால் விளக்கத்தை மீண்டும் எழுதுங்கள்.

எடுத்துக்காட்டு திறன்கள்

Deploy திறன்

உன்னதமான வேட்பாளர்: நடைமுறை அரிதானது, நீளமானது, ஆபத்தானது, தவறு அதிக விலை கொடுக்கும். திறனில் படிகளின் வரிசை பதிவாகிறது (முதலில் சோதனை ஓட்டம், பின்னர் அனுப்புதல்), எதை அனுப்பக்கூடாது, முடிவை எப்படிச் சரிபார்ப்பது, எப்படி திரும்பப்பெறுவது. ஒவ்வொரு குறியீடு திருத்தத்தின் போதும் இதை தலையில் வைத்திருக்க முகவருக்கு தேவையில்லை — சர்வர் பற்றிப் பேசும்போது மட்டுமே.

Review திறன்

---
name: review
description: commit-க்கு முன் தற்போதைய மாற்றங்களை review செய்தல். diff-ஐச் சரிபார்க்கவும், திருத்தங்களில் பிழைகளைத் தேடவும், அல்லது மாற்றங்களை commit-க்குத் தயார்படுத்தவும் கேட்கும்போது பயன்படுத்தவும்.
---

# மாற்றங்களின் review

1. diff-ஐப் பெறுங்கள்: git diff மற்றும் git diff --staged.
2. மாற்றப்பட்ட ஒவ்வொரு கோப்புக்கும் சரிபாருங்கள்:
   - பயனர் உள்ளீடு வெளியீட்டின்போது escape செய்யப்படுகிறதா;
   - SQL வினவல்கள் parameterized-ஆ;
   - debug வெளியீடும் தற்காலிக கோப்புகளும் இல்லையா.
3. திட்டத்தின் சோதனைகளையும் linter-ஐயும் இயக்குங்கள் (கட்டளைகள் — CLAUDE.md-இல்).
4. அறிக்கை: கோப்பும் வரியும் குறிப்பிட்ட பிரச்சினைகளின் பட்டியல், கடுமையானவற்றிலிருந்து சிறியவை வரை.
   பிரச்சினைகள் இல்லையென்றால் அதையே எழுதுங்கள், கற்பனையான குறிப்புகள் சேர்க்காதீர்கள்.

இந்தத் திறன் «ஒருமுறை பார்த்து எல்லாம் சரியா என்று சொல்லு» என்பதை ஒவ்வொரு முறையும் ஒரே பட்டியல் கொண்ட மீண்டும் செய்யக்கூடிய சரிபார்ப்பாக மாற்றுகிறது.

அமர்வு நிறைவு திறன்

இன்னொரு பயனுள்ள வகை — வேலையின் முடிவில் ஒரு சடங்கு: உள்ளூர் சூழலை நிறுத்துவது, தற்காலிக கோப்புகளை நீக்குவது, முன்னேற்றப் பதிவில் என்ன செய்யப்பட்டது, என்ன மீதம் உள்ளது என்று எழுதுவது, விரிவான விளக்கத்துடன் commit செய்வது. இது அமர்வுகளுக்கு இடையிலான context இழப்பை நேரடியாகத் தீர்க்கிறது: அடுத்த அமர்வு யூகங்களிலிருந்து அல்ல, களஞ்சியத்தின் தற்போதைய நிலையிலிருந்து தொடங்குகிறது.

அடிக்கடி நிகழும் தவறுகள்

• தெளிவற்ற விளக்கம். திறன் இருக்கிறது, ஆனால் முகவர் அதை அழைப்பதில்லை. தீர்வு: குறிப்பிட்ட தூண்டுதல்களுடன் description-ஐ மீண்டும் எழுதுவது.
• திறன்-சுவர். SKILL.md-இல் பழைய 400 வரிப் பகுதி முழுவதும் போடப்பட்டது. பெருகிய context பிரச்சினை மீண்டும் வந்தது, சற்று தாமதமாக. முக்கிய உரையை சுருக்கமாக வையுங்கள், விவரங்களை அருகிலுள்ள கோப்புகளில்.
• CLAUDE.md உடன் நகல். ஒரே நடைமுறை இரண்டு இடங்களில் விவரிக்கப்பட்டு காலப்போக்கில் வேறுபடுகிறது. உண்மையின் ஆதாரம் ஒன்றாக இருக்க வேண்டும்.
• ஒன்றுடன் ஒன்று மோதும் திறன்கள். ஒத்த விளக்கங்களுடன் இரண்டு திறன்கள் — முகவர் அவற்றுக்கிடையே தற்செயலாகத் தேர்கிறது. «பயன்படுத்து / பயன்படுத்தாதே» என்று தெளிவாகப் பிரியுங்கள்.
• காலாவதியான கட்டளைகள். ஸ்கிரிப்ட் பெயர் மாற்றப்பட்டது, ஆனால் திறன் பழைய பெயரைக் குறிப்பிடுகிறது. திறன் திட்டக் குறியீட்டின் ஒரு பகுதி: நடைமுறையுடன் அதே commit-இல் அதையும் திருத்துங்கள்.

எப்போது ஒரு பகுதியை திறனுக்கு நகர்த்த வேண்டும் என்பதை அறிவது

அவ்வப்போது CLAUDE.md-ஐப் பார்த்து ஒவ்வொரு பகுதிக்கும் கேளுங்கள்: சாதாரண பணிகளில் எத்தனை சதவீதத்துக்கு அது உண்மையில் தேவை? கிட்டத்தட்ட எப்போதும் தேவைப்பட்டால் — அது சரியான இடத்தில் இருக்கிறது. பத்தில் ஒரு பணிக்கு மட்டும் என்றால் — அது திறனுக்கான வேட்பாளர்.

இரண்டாவது அறிகுறி நீளம். ஒரு திரையில் அடங்காத பகுதி கிட்டத்தட்ட நிச்சயமாக ஒரு விதியை அல்ல, ஒரு நடைமுறையை விவரிக்கிறது. நடைமுறைகளை செயல்படுத்தும் நேரத்தில் முழுதாகப் படிப்பது எளிது, அமர்வு முழுவதும் பின்னணியில் வைத்திருக்கத் தேவையில்லை.

மூன்றாவது அறிகுறி மீண்டும் மீண்டும் வரும் விளக்கங்கள். ஒரே பணிக்கு அதே திருத்தங்களை முகவருக்கு மீண்டும் மீண்டும் எழுதுகிறீர்கள் என்றால், ஒருமுறை திறனில் எழுதுங்கள். ஒரு வாரம் கழித்து கைமுறைத் திருத்தங்கள் குறைந்துவிட்டதா என்று பாருங்கள்: அதுதான் திறன் வேலை செய்கிறது என்பதற்கான சோதனை.

முடிவு

Claude Code skills நடைமுறைகளைத் திட்டத்தின் அருகில் வைத்திருக்கவும், ஒவ்வொரு அமர்விலும் அவற்றுக்கு context-இல் விலை கொடுக்காமல் இருக்கவும் ஒரு வழி. விளக்கம் எப்போதும் தெரியும், உடல் தேவைக்கேற்ப ஏற்றப்படுகிறது, உதவிக் கோப்புகள் இன்னும் பின்னால். CLAUDE.md-இல் திட்ட வரைபடமும் கடுமையான விதிகளும் இருக்கின்றன; திறன்களுக்கு deploy, review, release மற்றும் ஒரு வகைப் பணிகள் செல்கின்றன. கோப்பு அமைப்பும் படிப்படியான context வெளிப்படுத்தலும் harness engineering பாடநெறியில் நடைமுறையில் விளக்கப்படுகின்றன.