మీ స్వంత agent skill ఎలా రాయాలి

ఒక నిజమైన వైఫల్యం నుంచి మీ స్వంత agent skill రాయండి

మీ స్వంత agent skill రాయడానికి ఉత్తమ మార్గం, దాన్ని ఒక నిజమైన వైఫల్యం నుంచి సారాంశంగా రూపొందించడం. మీ coding agent రెండుసార్లు తప్పుగా చేసిన ఒక పనిని ఎంచుకోండి. రెండు సార్లూ మీరు టైప్ చేసిన సవరణను రాసి, agent స్వయంగా load చేసుకోగలిగే SKILL.md file గా సేవ్ చేయండి. ఆ తర్వాత మిగిలేది mechanics మాత్రమే: file layout, అలాగే skill ఎప్పుడైనా అమలవుతుందో లేదో నిర్ణయించే ఒకే line.

ఆ క్రమం ముఖ్యం. ఊహ ఆధారంగా రాసిన skill, మీరు ఎప్పుడూ ఎదుర్కోని సమస్యను document చేస్తుంది. అయినా ప్రతి session లో context ను వినియోగిస్తుంది. మీరు గమనించిన ఒక వైఫల్యం నుంచి రూపొందించిన skill కు దాని స్వంత test కూడా ఉంటుంది: అదే అభ్యర్థనను మళ్లీ ఇవ్వండి, ఈసారి agent సరిగ్గా చేస్తుందో చూడండి. ఈ format మీకు కొత్తగా ఉంటే, ముందుగా agent skills ఏమిటి, agent వాటిని ఎలా load చేస్తుంది చదివి, తరువాత తిరిగి వచ్చి ఒకటి రాయండి.

ఏజెంట్ ఒక పనిని రెండుసార్లు తప్పుగా చేసినప్పుడు అక్కడి నుంచే ప్రారంభించండి

ఒకసారి జరగడం యాదృచ్ఛికం కావచ్చు. రెండుసార్లు జరగడం ఒక నమూనా. అలాంటి నమూనాను ఒక ఫైల్‌లో నమోదు చేయాలి.

నిజమైన సర్వర్లలో పునరావృతమయ్యే వైఫల్యం ఇది. nginx కు reverse proxy block జోడించమని మీరు ఏజెంట్‌ను అడుగుతారు. అది /etc/nginx/conf.d/app.conf ను సవరించి, తరువాత sudo systemctl restart nginx ను అమలు చేస్తుంది. ఆ సవరణలో typo ఉండటంతో nginx ప్రారంభం కావడానికి నిరాకరిస్తుంది. మీరు దాన్ని సరిచేసే వరకు site అందుబాటులో ఉండదు:

nginx: [emerg] unknown directive "proxy_pas" in /etc/nginx/conf.d/app.conf:12
Job for nginx.service failed because the control process exited with error code.

చాట్‌లో దాన్ని సరిచేయండి. service ను మార్చే ముందు sudo nginx -t తో configuration ను test చేయండి. తరువాత restart కు బదులుగా reload తో దాన్ని apply చేయండి. ఒక వారం తరువాత, వేరే పనిలో అదే తప్పు మళ్లీ జరుగుతుంది. ఆ రెండోసారి వచ్చిన సంఘటనే సంకేతం.

వైఫల్యం మీ ముందే ఉన్నప్పుడు రెండు విషయాలను రాసుకోండి: మీరు టైప్ చేసిన request, అలాగే మీరు ఉపయోగించిన పదాలతో ఇచ్చిన correction. ఆ రెండు పంక్తులే skill గా మారతాయి. trigger ఏదిని match చేయాలో request తెలియజేస్తుంది. correction లో skill కు అవసరమైన మొత్తం content ఉంటుంది.

Anthropic యొక్క స్వంత authoring guidance కూడా ఇదే విషయాన్ని మొదటగా సూచిస్తుంది. ఎటువంటి skill లేకుండా representative tasks పై agent ను నడపండి. అది ఎక్కడ విఫలమవుతుందో నమోదు చేయండి. తరువాత ఆ వైఫల్యాలను సరిచేసే కనీస instructions రాయండి. వైఫల్యాలే specification. అందువల్ల ఏ వైఫల్యానికి అనుసంధానించలేని skill సాధారణంగా ఎవరికీ అవసరం లేని skill అవుతుంది.

skill యొక్క నిర్మాణం

skill అనేది ఒక అవసరమైన file కలిగిన directory.

.claude/skills/nginx-config-changes/
├── SKILL.md
├── reference/
│   └── proxy-headers.md
└── scripts/
    └── check-and-reload.sh

SKILL.md వద్ద frontmatter block ప్రారంభమవుతుంది. ఇందులో YAMLలో రాసిన కొన్ని settings ఉంటాయి. ఇదే configuration format ను Docker Compose files ఉపయోగిస్తాయి. ఈ block --- markers మధ్య ఉంటుంది. దాని తరువాత markdownలో instructions ఉంటాయి. పై failureకు సంబంధించిన పూర్తి skill ఇదే.

---
name: nginx-config-changes
description: Tests and reloads nginx safely after a config edit. Use when editing files under /etc/nginx, adding a server block or a reverse proxy, or changing a TLS certificate path.
---

## Rules

Run `sudo nginx -t` after every edit under `/etc/nginx`. Do not touch the service until it prints `test is successful`.

Apply the change with `sudo systemctl reload nginx`. Never use `restart`. A reload keeps the running workers serving traffic until the new config parses, so a broken config leaves the site up. A restart stops nginx first, so a broken config takes the site down.

If `nginx -t` fails, fix the file and test again. Never reload a config that failed the test.

For the proxy header defaults this project expects, see [reference/proxy-headers.md](reference/proxy-headers.md).

ఈ fileలో ఇరవై lines కంటే తక్కువ ఉన్నాయి. అయినప్పటికీ ఇది పూర్తి skill. ఇందులోని భాగాలు:

• name: గరిష్ఠంగా 64 characters ఉండాలి. lowercase letters, digits, hyphens మాత్రమే ఉపయోగించాలి. ఇందులో claude లేదా anthropic పదాలు ఉండకూడదు. personal లేదా project skillలో ఇది display label మాత్రమే. మీరు type చేసే command directory name నుంచి వస్తుంది. అందువల్ల దీనిని /nginx-config-changes పేరుతో పిలుస్తారు.
• description: skill ఏమి చేస్తుంది, ఎప్పుడు ఉపయోగించాలి అనే వివరణ. దీని పరిమితి 1,024 characters. ఇది ప్రధానంగా పనిచేసే line. తదుపరి section మొత్తం దీనిపైనే ఆధారపడి ఉంటుంది.
• Body: instructions. skill నిజంగా trigger అయినప్పుడు మాత్రమే ఇవి load అవుతాయి.
• reference/: agent అవసరమైనప్పుడు చదివే అదనపు files. వాటికి SKILL.md నుంచి links ఇవ్వాలి. Links ను ఒక స్థాయి లోతులోనే ఉంచాలి. మరొక referenced file నుంచి reference చేసిన fileను agent తరచుగా కొంత భాగం మాత్రమే చదువుతుంది.
• scripts/: agent చదవకుండా execute చేసే files. వాటి output మాత్రమే contextను వినియోగిస్తుంది. అందువల్ల 300 lines ఉన్న script కూడా తక్కువ ఖర్చుతో ఉంటుంది.

Directoryను ఎక్కడ ఉంచుతారో దాని ఆధారంగా ఆ skill ఎవరికి అందుబాటులో ఉంటుందో నిర్ణయించబడుతుంది.

• Repositoryలోని .claude/skills/<name>/SKILL.md: ఈ projectకు మాత్రమే. Repositoryను clone చేసే ప్రతి ఒక్కరికీ ఇది అందుతుంది.
• ~/.claude/skills/<name>/SKILL.md: మీ machineలోని ప్రతి projectకు. ఇతరుల projectsకు కాదు.
• <plugin>/skills/<name>/SKILL.md: pluginలో భాగంగా ship అవుతుంది. ఆ plugin enabled ఉన్న ప్రతి చోట అందుబాటులో ఉంటుంది.

mkdir -p .claude/skills/nginx-config-changes తో ఒకదాన్ని సృష్టించి fileను రాయండి. Claude Code ఈ directoriesను monitor చేస్తుంది. అందువల్ల ఇప్పటికే ఉన్న skillను edit చేస్తే అది running sessionలోనే అమల్లోకి వస్తుంది. Session ప్రారంభమైనప్పుడు లేని top-level skills directoryను సృష్టిస్తే restart అవసరం. Session ప్రారంభమైన సమయంలో దాన్ని monitor చేయడానికి ఏదీ ఉండదు.

ఫైల్‌లో description ఫీల్డ్ అత్యధిక ప్రభావం చూపే పంక్తి

ప్రారంభ సమయంలో agent అందుబాటులో ఉన్న ప్రతి skill కు సంబంధించిన name మరియు description ను తన context లోకి లోడ్ చేస్తుంది. వాటి bodies ను లోడ్ చేయదు. మీ request వచ్చినప్పుడు, ఆ ఒక్క పంక్తే ఈ skill సంబంధితదా కాదా అని నిర్ణయించడానికి పూర్తి ఆధారం. అందువల్ల అస్పష్టమైన description వెనుక ఉన్న అద్భుతమైన body ఎప్పటికీ చదవబడదు.

description ను third person లో రాయండి. "Tests and reloads nginx safely" పనిచేస్తుంది. "I can help you with nginx" పనిచేయదు. ఎందుకంటే ఆ text system prompt లోకి inject అవుతుంది; అక్కడ first person వాడితే model తన గురించి మాట్లాడుతున్నట్టుగా కనిపిస్తుంది.

description లో రెండు విషయాలు ఉండాలి: skill ఏమి చేస్తుంది, అది ఏ పరిస్థితిలో వర్తిస్తుంది. ముఖ్యమైన use case ను ముందుగా ఉంచండి. Claude Code listing entry ను 1,536 characters వద్ద truncate చేస్తుంది. అదనపు trigger phrases మరియు example requests కోసం ఐచ్ఛికంగా when_to_use field ఉంది. అదే character పరిమితిలో అది description కు జతచేయబడుతుంది.

తరువాత మీరు వాస్తవంగా టైప్ చేసే పదాలనే ఉపయోగించండి. description: Helps with nginx ఏదీ match చేయదు. ఎందుకంటే ఎవరూ "helps with" అని టైప్ చేయరు. పై version లో /etc/nginx, server block, reverse proxy మరియు TLS (transport layer security) certificate path ఉన్నాయి. ఆ skill ను trigger చేయాల్సిన ఏ request లోనైనా సాధారణంగా కనిపించే vocabulary ఇదే.

description ను పరీక్షించే విధానం ఇది. body ను ఎప్పుడూ చూడని వ్యక్తికి ఆ ఒక్క పంక్తిని, మీరు టైప్ చేయబోయే request తో కలిపి ఇవ్వండి. ఆ skill వర్తిస్తుందా అని అడగండి. అతనికి అర్థం కాకపోతే, model కు కూడా అర్థం కాదు.

బాడీని చిన్నగా ఉంచండి, ఎందుకంటే అది context లోనే ఉంటుంది

ఒక skill invoke అయినప్పుడు, దాని rendered content సంభాషణలో ఒక message గా చేరి, session మొత్తం అక్కడే ఉంటుంది. తరువాతి turns లో Claude Code ఆ file ను మళ్లీ చదవదు. మీరు రాసే ప్రతి line ఒక సమాధానానికి మాత్రమే కాదు, మొత్తం session కు అయ్యే ఖర్చు.

Anthropic, SKILL.md ను 500 lines కంటే తక్కువగా ఉంచి, వివరాలను separate files లోకి తరలించాలని సిఫార్సు చేస్తుంది. Compaction ద్వారా ఈ సంఖ్య యాదృచ్ఛికం కాదని తెలుస్తుంది. Context ను ఖాళీ చేయడానికి conversation ను summarise చేసినప్పుడు, Claude Code ప్రతి skill యొక్క అత్యంత ఇటీవలి invocation ను మళ్లీ జతచేస్తుంది, ప్రతి దానిలోని మొదటి 5,000 tokens ను మాత్రమే ఉంచుతుంది, మరియు skillలను చివరిగా invoke చేసినది మొదలయ్యేలా కలిపిన 25,000 token budget ను నింపుతుంది. పొడవైన skill మధ్యలోనే కత్తిరించబడుతుంది. అనేక పొడవైన skills ఉంటే, అవి ఒకదానినొకటి పూర్తిగా బయటకు నెట్టివేయవచ్చు.

కాబట్టి model కు ఇప్పటికే తెలిసిన విషయాలను మాత్రమే రాయండి. nginx ఏమిటో, reverse proxy ఏమి చేస్తుందో దానికి తెలుసు. reload ను restart కంటే ఎక్కువగా ఉపయోగించకూడదనే మీ సంస్థ నియమం దానికి తెలియదు; ఈ file ఉండటానికి అదే ఒక్క కారణం.

skill agent ను bundled script run చేయమని చెప్పినప్పుడు, path ను ${CLAUDE_SKILL_DIR} తో పేర్కొనండి. అప్పుడు skill ఎక్కడ install చేసినా అది సరైన path కు resolve అవుతుంది. అదే command కు ముందుగానే permission ఇవ్వండి, తద్వారా run permission prompt వద్ద ఆగదు.

---
name: nginx-config-changes
description: Tests and reloads nginx safely after a config edit. Use when editing files under /etc/nginx, adding a server block or a reverse proxy, or changing a TLS certificate path.
allowed-tools: Bash(${CLAUDE_SKILL_DIR}/scripts/check-and-reload.sh *)
---

ఈ grant skill ను invoke చేసిన turn కు మాత్రమే వర్తిస్తుంది. మీరు తదుపరి message పంపినప్పుడు అది clear అవుతుంది. అందువల్ల అది నిశ్శబ్దంగా permanent permission గా మారదు.

నైపుణ్యం పనిచేస్తుందని ఎలా నిరూపించాలి

నైపుణ్యం load అవడాన్ని గమనిస్తే agent దాన్ని కనుగొందని తెలుస్తుంది. కానీ సమాధానం మారిందని మాత్రం తెలియదు. ఈ రెండింటినీ తనిఖీ చేయాలి. అదీ fresh session లో చేయాలి. ఎందుకంటే మీరు నైపుణ్యం రాసిన session లో, దాన్ని రాస్తున్నప్పుడు ఇచ్చిన మొత్తం సమాచారం ఇప్పటికే ఉంటుంది. ఆ మిగిలిన context ఫైల్‌లోని లోపాలను దాచవచ్చు.

1. project లో claude తో కొత్త session ప్రారంభించండి.
2. సాధారణ పనిదినంలో అడిగినట్లుగా, మీ స్వంత మాటల్లో request ను టైప్ చేయండి. skill పేరు ప్రస్తావించవద్దు.
3. invocation కోసం గమనించండి. skill పనిచేయకపోతే description ను సరిచేయండి. ఇప్పటికి body సమస్య కాదు.
4. నియంత్రణ కోసం /nginx-config-changes తో దాన్ని చేతితో invoke చేయండి. చేతితో invoke చేసినప్పుడు సరైన ప్రవర్తన, request ద్వారా invoke చేసినప్పుడు తప్పు ప్రవర్తన కనిపిస్తే, అది instruction సమస్య కాకుండా trigger సమస్య అని నిర్ధారించవచ్చు.
5. skill off చేసి అదే request ను మళ్లీ అమలు చేసి, రెండు సమాధానాలను పోల్చండి. /skills menu లో skill ను highlight చేసి, దాని state ను off కు మార్చడానికి Space నొక్కండి. తరువాత సేవ్ చేయడానికి Enter నొక్కండి. ఇది .claude/settings.local.json లో skillOverrides entry ను రాస్తుంది. పని పూర్తయిన తర్వాత Space ను మళ్లీ నొక్కితే state తిరిగి on కు మారుతుంది.
6. skill trigger కాకూడని కొన్ని requests రాసి, వాటిపై అది నిశ్శబ్దంగా ఉంటుందో తనిఖీ చేయండి.

ఈ loop ను automate చేయడానికి official marketplace నుంచి skill-creator plugin ను install చేయండి.

/plugin marketplace add anthropics/claude-plugins-official
/plugin install skill-creator@claude-plugins-official

install output లో Run /reload-plugins to activate. కనిపిస్తే, ఆ command ను అమలు చేయండి. తరువాత మీ skill ను పేరు ద్వారా evaluate చేయమని Claude ను అడగండి. plugin test cases ను skill directory లోని evals/evals.json లో నిల్వ చేసి, ప్రతి case ను దాని స్వంత subagent లో అమలు చేస్తుంది. అందువల్ల ప్రతి run clean context తో ప్రారంభమవుతుంది. తరువాత with-skill మరియు without-skill పోలికను రాస్తుంది. ఇదే నిజమైన కొలత: skill వల్ల కలిగే tokens మరియు సమయ వ్యయంతో పోల్చి కొలిచిన pass rate improvement.

విఫల స్థితి: skill ఎప్పుడూ trigger కాదు

మీరు అభ్యర్థనను టైప్ చేసినా agent మునుపటి తప్పు చర్యనే చేస్తుంది, అలాగే skill line కనిపించదు. కింది అంశాలను ఈ క్రమంలో పరిశీలించండి.

• Description skill ఏమి చేస్తుందో చెబుతుంది, కానీ దాన్ని ఎప్పుడు ఉపయోగించాలో చెప్పదు. అందువల్ల మీ అభ్యర్థనలోని ఏదీ దానితో సరిపోలదు.
• Description మీరు టైప్ చేసే పదాలను ఉపయోగించదు. మీరు "nginx" అని చెబితే, description లో కూడా nginx ఉండాలి.
• Frontmatter లో disable-model-invocation: true సెట్ చేయబడింది. దాంతో description model context నుంచి పూర్తిగా తొలగిపోతుంది. ఆ skill ను /name ద్వారా మీరు మాత్రమే invoke చేయగలరు.
• Frontmatter లోని paths glob activation ను సరిపోలే files కు మాత్రమే పరిమితం చేస్తుంది. మీరు పనిచేస్తున్న file దానికి సరిపోలదు.
• Skill, మీరు ప్రారంభించిన directory కింద ఉన్న nested .claude/skills/ directory లో ఉంది. Agent ఆ subdirectory లోని file ను చదివిన లేదా సవరించిన తర్వాత మాత్రమే అవి load అవుతాయి. అప్పటి వరకు skill అసలు అందుబాటులో ఉండదు.

విఫల స్థితి: skill నిరంతరం trigger అవుతుంది

అసంబంధిత పనులకూ skill అమలయ్యేంత విస్తృతంగా description ఉండటం దీనికి విరుద్ధమైన సమస్య. “server పై పని చేస్తున్నప్పుడు ఉపయోగించండి” అనే నియమం server repository లోని దాదాపు ప్రతి అభ్యర్థనకూ సరిపోతుంది. అప్పుడు body సహాయం చేయలేని పనుల సమయంలో కూడా load అవుతుంది. అది session మిగతా కాలం context లోనే ఉంటుంది.

నిజంగా అవసరమైన condition కు description ను పరిమితం చేయండి. అది వర్తించే files లేదా commands పేర్లను కూడా పేర్కొనండి. skill కొన్ని files కు మాత్రమే వర్తిస్తే paths glob ను జోడించండి. deploy లేదా commit వంటి side effects ఉన్న పనులకు disable-model-invocation: true ను సెట్ చేసి, /name తో మీరే invoke చేయండి. అప్పుడు deploy చేయడానికి ఇదే సరైన సమయం అని agent స్వయంగా నిర్ణయించదు.

విఫలత పరిస్థితి: ఈ నైపుణ్యం మీ rules file లో ఉండాలి

CLAUDE.md లేదా AGENTS.md వంటి rules file ప్రతి session ప్రారంభంలో లోడ్ అవుతుంది మరియు ప్రతి task కు వర్తిస్తుంది. skill body మాత్రం ఆ skill అమలైనప్పుడు మాత్రమే లోడ్ అవుతుంది. నిర్ణయానికి frequency ప్రధాన ఆధారం. repository లోని ప్రతి task కు వర్తించే package manager వంటి విషయం rules file లో ఉండాలి. పై nginx rule వంటి కొద్దిపాటి task లకు మాత్రమే వర్తించే procedure skill లో ఉండాలి. ఎవరూ nginx ను edit చేయని రోజుల్లో దానికి ఎలాంటి అదనపు ఖర్చు ఉండదు.

దాన్ని రెండు చోట్ల ఉంచడమే అసలు వైఫల్యం. రెండు కాపీలు వేర్వేరుగా మారిపోతాయి. agent తప్పు పని చేసినప్పుడు అది ఏ కాపీని అనుసరించిందో గుర్తించలేరు. ప్రతి instruction కు ఒకే స్థానం ఎంచుకోండి. skills, MCP servers మరియు rules files మధ్య సరిహద్దు మరింత క్లిష్టమైన సందర్భాలను కూడా వివరిస్తుంది. అందులో కొత్త instruction కాకుండా agent కు కొత్త tool అందించే MCP (model context protocol) server సరైన ఎంపిక అయ్యే సందర్భాలు కూడా ఉన్నాయి.

స్థిరమైన ఉపయోగం నిరూపించుకున్న తర్వాత దాన్ని పంచుకోండి

వాస్తవ పనిలో ఒక వారం పాటు సమర్థంగా పనిచేసిన skill ను repository లో commit చేయడం విలువైనది. .claude/skills/ లోని project skills ను code మాదిరిగానే review చేస్తారు. అవి repository తోపాటు వస్తాయి. కాబట్టి teammate దాన్ని clone చేసినప్పుడు అదనపు setup అవసరం లేకుండా మీ సవరణను పొందుతారు. copy and paste చేయకుండా ఒక repository నుంచి మరొకదానికి skill ను తరలించడం వేరే సమస్య. దాని గురించి repos మధ్య agent skills ను ఎలా పంచుకోవాలి లో వివరించారు.

Portability కు సంబంధించి ఒక గమనిక. Claude Code విస్తృతమైన frontmatter fields జాబితాను అంగీకరిస్తుంది. కానీ Agent Skills standard కేవలం ఆరు fields ను మాత్రమే అనుమతిస్తుంది: name, description, license, compatibility, metadata మరియు allowed-tools. frontmatter లో ఇతర field ఏదైనా ఉండగా skill ను claude.ai కు upload చేసినా లేదా Skills API కోసం package చేసినా, ఆ field ను విస్మరించకుండా పూర్తిగా విఫలమవుతుంది:

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

ఆ ఆరు fields లోనే ఉండండి. అప్పుడు అదే file Claude Code లోనూ, ఈ standard ను చదివే ఇతర సాధనాల్లోనూ load అవుతుంది. వేరే model కు తరలించినా instructions పనిచేసేలా వాటిని రాయడం ప్రత్యేకమైన పని. దాని గురించి ఏ model తోనైనా పనిచేసే skills రాయడం లో వివరించారు.

FAQ

SKILL.md ఫైల్ ఎంత పొడవుగా ఉండాలి?

దాన్ని 500 lines కంటే తక్కువగా ఉంచండి. ఉపయోగకరమైన చాలా skills అంతకంటే చాలా చిన్నవిగా ఉంటాయి. Skill ను invoke చేసినప్పుడు దాని body conversation లోకి చేరి, session మిగిలినంతసేపు అక్కడే ఉంటుంది. అందువల్ల ప్రతి line ఒక్కసారి అయ్యే ఖర్చు కాకుండా, మళ్లీ మళ్లీ వచ్చే ఖర్చుగా మారుతుంది. పొడవైన reference material ను skill directory లోని ప్రత్యేక files కు తరలించి, వాటిని SKILL.md నుండి ఒక స్థాయి లోతులో link చేయండి. అప్పుడు agent కు అవసరమైనప్పుడు మాత్రమే వాటిని చదువుతుంది. Bundled scripts చదవబడవు; వాటి బదులు execute అవుతాయి. అందువల్ల వాటి ఖర్చు వాటి output కు మాత్రమే పరిమితం అవుతుంది.

నా skill ఎప్పుడూ trigger ఎందుకు కావడం లేదు?

సాధారణంగా కారణం description. Model నిర్ణయం తీసుకునే సమయంలో context లో ఉండే skill యొక్క ఏకైక భాగం అదే. Description లో skill ఏమి చేస్తుందో మాత్రమే కాకుండా, దాన్ని ఎప్పుడు ఉపయోగించాలో కూడా చెప్పండి. మీ requests లో మీరు వాస్తవంగా టైప్ చేసే పదాలు అందులో ఉన్నాయో చూసుకోండి. Description సరిగ్గా కనిపిస్తే, frontmatter లోని disable-model-invocation: true ను తనిఖీ చేయండి. అది skill ను model నుండి పూర్తిగా దాచేస్తుంది. అలాగే, మీరు touch చేయని files కు మాత్రమే పరిమితం చేసే paths glob ఉందో చూడండి. మీరు ప్రారంభించిన directory కింద ఉన్న nested .claude/skills/ directory లో skill ఉండటం కూడా కారణం కావచ్చు. ఆ subdirectory లోని file ను agent చదివిన తర్వాత లేదా edit చేసిన తర్వాత మాత్రమే అది load అవుతుంది.

ఇది skill కావాలా, లేక నా rules file లోని ఒక line కావాలా?

మీ tasks లో ఇది ఎన్ని వాటికి వర్తిస్తుందో ఆలోచించండి. Rules file ప్రతి session లో load అవుతుంది. కాబట్టి package manager లేదా branch naming convention వంటి ప్రతి task కు నిజమైన విషయాలను అందులో ఉంచాలి. Skill trigger అయినప్పుడు మాత్రమే load అవుతుంది. అందువల్ల కొద్దిపాటి tasks కు మాత్రమే అవసరమైన procedure ను ఉంచడానికి అది సరైన స్థలం. ఒకే instruction ను రెండు చోట్ల ఎప్పుడూ రాయవద్దు. రెండు copies కాలక్రమేణా వేర్వేరుగా మారుతాయి. అప్పుడు agent ఏ copy ను అనుసరించిందో గుర్తించే సామర్థ్యాన్ని కోల్పోతారు.

Skill నిజంగా సహాయపడిందో ఎలా తెలుసుకోవాలి?

దాన్ని baseline తో పోల్చండి. కొన్ని నిజమైన requests సేకరించండి. Skill అందుబాటులో ఉన్న fresh session లో ప్రతి request ను ఒకసారి run చేయండి. తరువాత /skills menu నుండి skill ను switch off చేసి, వాటినే మళ్లీ run చేయండి. రెండు సమాధానాలను పక్కపక్కన చదవండి. Fresh session ముఖ్యం. ఎందుకంటే మీరు skill రాసిన conversation లో మీ explanations ఇంకా ఉంటాయి. దాంతో అసంపూర్ణ file కూడా పూర్తిగా కనిపించవచ్చు. skill-creator plugin ఈ comparison ను మీ కోసం నిర్వహించి, token cost పక్కన pass rate ను చూపిస్తుంది.

వేరే agent తో అదే SKILL.md ను ఉపయోగించవచ్చా?

అవును. Agent Skills standard నిర్వచించే fields పరిధిలోనే ఉంటే ఉపయోగించవచ్చు: name, description, license, compatibility, metadata మరియు allowed-tools. Claude Code ఇంకా అనేక fields ను అంగీకరిస్తుంది. ఇతర tools అమలు చేయని shell command injection వంటి body features కు కూడా అది మద్దతు ఇస్తుంది. Standard కు వెలుపల ఉన్న field తో skill ను upload చేస్తే, అనుమతించబడిన properties ను చూపించే explicit error తో అది విఫలమవుతుంది. కాబట్టి skill Claude Code లోనే ఉండాలా, లేక ఇతర tools కు తరలించాలా అనే విషయాన్ని ముందుగానే నిర్ణయించండి.