Elastic Agent कौशल

Elastic Agent कौशल — Elastic बनाने वाले लोगों द्वारा निर्मित — आपके AI कोडिंग एजेंट को सीधे मूल प्लेटफ़ॉर्म विशेषज्ञता प्रदान करते हैं। यह आधिकारिक Agent Skills लाइब्रेरी है, जो Cursor, GitHub Copilot, Windsurf, Gemini CLI और अन्य जैसे एजेंटिक IDE के साथ संगत है। कौशल Agent Skills ओपन स्टैंडर्ड का पालन करते हैं।

[!NOTE] तकनीकी पूर्वावलोकन

ये कौशल प्रारंभिक रिलीज़ में हैं और सक्रिय विकास के अधीन हैं। जैसे-जैसे कौशल को मजबूत मूल्यांकनों के साथ संहिताबद्ध किया जाता है और मॉडल परिदृश्य विकसित होता है, बदलाव की उम्मीद करें। अपडेट के लिए बार-बार जाँच करें।

परिचय

इस रिपॉजिटरी में क्यूरेटेड कौशल शामिल हैं जो निर्देशों, संदर्भ और टूलिंग के पैकेज हैं जो किसी भी AI एजेंट को Elasticsearch, Kibana, Elastic Observability और Elastic Security के साथ सही ढंग से काम करना सिखाते हैं। उन्हें अपने पहले से उपयोग किए जा रहे एजेंट रनटाइम में डालें, और आपका सहायक पुराने पैटर्न का उपयोग करना बंद कर देगा और इसे सही करना शुरू कर देगा।

कौशल क्या हैं?

कौशल स्व-निहित पैकेज हैं जो AI एजेंटों को दोहराए जाने योग्य तरीके से विशिष्ट कार्यों को पूरा करने के लिए ज्ञान और उपकरण प्रदान करते हैं। प्रत्येक कौशल अपने स्वयं के फ़ोल्डर में SKILL.md फ़ाइल के साथ रहता है जिसमें मेटाडेटा और निर्देश होते हैं जिनका एजेंट पालन करता है।

Agent Skills मानक के बारे में अधिक पृष्ठभूमि के लिए, agentskills.io देखें।

दायरा

इस रिपॉजिटरी में कौशल निम्न पर ध्यान केंद्रित करते हैं:

• Elasticsearch API के साथ इंटरैक्ट करना (खोज, अनुक्रमण, क्लस्टर प्रबंधन)
• अलर्ट, कनेक्टर और अधिक जैसी Kibana सामग्री बनाना और प्रबंधित करना
• Elastic Observability, Elastic Security और Agent Builder के लिए पैटर्न

उपलब्ध कौशल

सुरक्षा संबंधी विचार

AI कोडिंग एजेंट वास्तविक क्रेडेंशियल, वास्तविक शेल एक्सेस और अक्सर उन्हें चलाने वाले उपयोगकर्ता की पूर्ण अनुमतियों के साथ काम करते हैं। जब उन एजेंटों को सुरक्षा वर्कफ़्लो पर इंगित किया जाता है, तो दांव ऊंचे होते हैं। यह शुरू करने से पहले जोखिम के बारे में एक स्पष्ट बातचीत की मांग करता है।

• अपना स्वयं का खतरा मॉडलिंग करें। मूल्यांकन करें कि एजेंट किस डेटा तक पहुँच सकता है, वह क्या कार्रवाई कर सकता है, और यदि वह अप्रत्याशित रूप से व्यवहार करता है तो क्या होता है। AI सिस्टम को सुरक्षित रूप से तैनात करने पर CISA का संयुक्त मार्गदर्शन एक अच्छा प्रारंभिक बिंदु है।
• एजेंट के माध्यम से कौन सा डेटा प्रवाहित होता है, इससे अवगत रहें। सुरक्षा डेटा में PII, कमांड लाइनों में एम्बेडेड क्रेडेंशियल और अन्य विनियमित डेटा हो सकता है। जब कोई एजेंट अलर्ट या प्रक्रिया ईवेंट क्वेरी करता है, तो वह सामग्री मॉडल के संदर्भ में प्रवेश करती है और किसी तृतीय-पक्ष API को भेजी जा सकती है। अपनी सूचना सुरक्षा और अनुपालन टीमों को जल्दी शामिल करें।
• ये एजेंट हमलावर-नियंत्रित इनपुट को संसाधित करते हैं। अलर्ट, ईवेंट फ़ील्ड और फ़ाइल सामग्री में नियमित रूप से हमलावरों द्वारा तैयार किए गए स्ट्रिंग होते हैं। प्रॉम्प्ट इंजेक्शन यहाँ सैद्धांतिक नहीं है; यह ऑपरेटिंग वातावरण का एक अंतर्निहित गुण है। Brainworm जैसा शोध दर्शाता है कि एजेंट संदर्भ फ़ाइलें अकेले प्रॉम्प्टवेयर के लिए एक दृढ़ता तंत्र के रूप में काम कर सकती हैं।
• विशेषाधिकारों को सख्ती से सीमित करें। API कुंजियों को न्यूनतम आवश्यक विशेषाधिकार दें। व्यापक प्रतिक्रिया विशेषाधिकार विशेष रूप से खतरनाक होते हैं। केवल-पढ़ने की पहुँच एक अच्छा डिफ़ॉल्ट है जब तक आप व्यवहार को मान्य नहीं कर लेते।
• एजेंट टूल एक्सेस और नेटवर्क पहुँच को प्रतिबंधित करें। अधिकांश AI कोडिंग एजेंट व्यापक डिफ़ॉल्ट के साथ आते हैं: शेल निष्पादन, फ़ाइल सिस्टम राइट, इंटरनेट एक्सेस। उपलब्ध टूल सतह को कम करना सीमित करता है कि एक समझौता किया गया या गलत निर्देशित एजेंट क्या कर सकता है।
• गैर-उत्पादन वातावरण में शुरू करें। कौशल को किसी भी चीज़ से जोड़ने से पहले उनका मूल्यांकन करने के लिए सर्वरलेस ट्रायल प्रोजेक्ट, डेव क्लस्टर या पृथक Kibana स्पेस का उपयोग करें जो लाइव सुरक्षा डेटा ले जा रहा हो।

ये कौशल खुले स्रोत हैं, ठीक इसलिए ताकि आप ऑडिट कर सकें कि वे क्या करते हैं। हम आपको प्रोत्साहित करते हैं कि उन्हें चलाने से पहले पढ़ें।

आरंभ करना

आप Claude Code नेटिव प्लगइन सिस्टम, npx के साथ skills CLI का उपयोग करके, या इस रिपॉजिटरी को क्लोन करके और बंडल इंस्टॉलर स्क्रिप्ट चलाकर Elastic कौशल स्थापित कर सकते हैं। npx विधि के लिए आपके वातावरण में Node.js और npx उपलब्ध होना आवश्यक है।

[!TIP] हर कौशल स्थापित न करें। प्रत्येक स्थापित कौशल रूटिंग संदर्भ जोड़ता है जिसका आपका एजेंट प्रत्येक अनुरोध पर मूल्यांकन करता है। क्लाउड और एलास्टिकसर्च प्रमाणीकरण कौशल स्थापित करें — अधिकांश अन्य कौशल उन पर निर्भर होते हैं — फिर केवल अपने वर्कफ़्लो से संबंधित कौशल जोड़ें। स्थापित सेट को केंद्रित रखने से संदर्भ फूलने से बचा जा सकता है और एजेंट को सही कौशल तक मज़बूती से रूट करने में मदद मिलती है।

Claude Code प्लगइन (Claude Code उपयोगकर्ताओं के लिए अनुशंसित)

Claude Code में एक नेटिव प्लगइन सिस्टम है जो सीधे कौशल प्रबंधित करता है। इस रिपॉजिटरी को मार्केटप्लेस स्रोत के रूप में जोड़कर प्रारंभ करें:```sh claude plugin marketplace add https://github.com/elastic/agent-skills

एक बार जोड़ने के बाद, व्यक्तिगत प्लगइन्स को नाम से स्थापित करें:```sh
claude plugin install elasticsearch@elastic-agent-skills
claude plugin install kibana@elastic-agent-skills
claude plugin install observability@elastic-agent-skills
claude plugin install security@elastic-agent-skills
claude plugin install cloud@elastic-agent-skills

[!NOTE] इंस्टॉल करने के बाद, /reload-plugins चलाने पर कौशल तुरंत प्रकट नहीं हो सकते हैं। यह एक ज्ञात Claude Code समस्या है — नए इंस्टॉल किए गए प्लगइन्स को उठाने के लिए अपना Claude Code सत्र पुनः प्रारंभ करें।

या किसी भी Claude Code सत्र के अंदर इंटरैक्टिव प्लगइन ब्राउज़र का उपयोग करें:``` /plugins

### GitHub Copilot CLI

यह सभी कॉन्फ़िगर किए गए मार्केटप्लेस से उपलब्ध प्लगइन्स को ब्राउज़ करने, इंस्टॉल करने के लिए चुनने, और पहले से इंस्टॉल किए गए को प्रबंधित करने का मेनू खोलता है।

GitHub Copilot CLI में एक मूल प्लगइन सिस्टम है। इस रिपॉजिटरी को मार्केटप्लेस स्रोत के रूप में जोड़ें:```sh
copilot plugin marketplace add elastic/agent-skills

एक बार जोड़े जाने के बाद, व्यक्तिगत प्लगइन्स को नाम से स्थापित करें:```sh copilot plugin install elasticsearch@elastic-agent-skills copilot plugin install kibana@elastic-agent-skills copilot plugin install observability@elastic-agent-skills copilot plugin install security@elastic-agent-skills copilot plugin install cloud@elastic-agent-skills

या Copilot सत्र के अंदर इंटरैक्टिव रूप से उपलब्ध प्लगइन्स ब्राउज़ करें:```
/plugin list

npx (अनुशंसित)

स्किल्स इंस्टॉल करने का सबसे तेज़ तरीका skills CLI का उपयोग करना है। इस रिपॉजिटरी को क्लोन करने की आवश्यकता नहीं है — बस चलाएँ:

npx create-next-app@latest --typescript
``````sh
npx skills add elastic/agent-skills

यह एक इंटरैक्टिव प्रॉम्प्ट लॉन्च करता है जो कौशल और लक्ष्य एजेंटों का चयन करने के लिए होता है। CLI प्रत्येक कौशल फ़ोल्डर को एजेंट द्वारा खोजे जाने के लिए सही स्थान पर कॉपी करता है।

एक विशिष्ट कौशल को नाम से स्थापित करें:```sh npx skills add elastic/agent-skills --skill elasticsearch-esql

या `@` शॉर्टहैंड का उपयोग करके कौशल को सीधे `repo@skill` के रूप में निर्दिष्ट करें (`--skill` के समकक्ष):```sh
npx skills add elastic/agent-skills@elasticsearch-esql

विशिष्ट एजेंटों में स्थापित करें (देखें समर्थित एजेंट):```sh npx skills add elastic/agent-skills -a cursor -a claude-code

उपलब्ध कौशलों को स्थापित किए बिना सूचीबद्ध करें:```sh
npx skills add elastic/agent-skills --list

सभी एजेंटों को सभी कौशल स्थापित करें (गैर-इंटरैक्टिव):```sh npx skills add elastic/agent-skills --all

| फ़्लैग             | विवरण                                               |
| ----------------- | --------------------------------------------------- |
| `-a, --agent`     | विशिष्ट एजेंट को लक्ष्य करें (देखें [समर्थित एजेंट](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)) |
| `-s, --skill`     | नाम से विशिष्ट कौशल स्थापित करें                     |
| `-g, --global`    | प्रोजेक्ट निर्देशिका के बजाय उपयोगकर्ता होम में स्थापित करें |
| `-y, --yes`       | पुष्टि संकेतों को छोड़ें                             |
| `--all`           | बिना संकेत के सभी एजेंटों में सभी कौशल स्थापित करें |
| `--list`          | बिना स्थापित किए उपलब्ध कौशल सूचीबद्ध करें          |

### स्थानीय क्लोन

यदि आप स्थानीय चेकआउट से काम करना पसंद करते हैं, या आपके वातावरण में Node.js / npx नहीं है, तो रिपॉजिटरी को क्लोन करें और बंडल किए गए bash इंस्टॉलर का उपयोग करें:```sh
git clone https://github.com/elastic/agent-skills.git
cd agent-skills
./scripts/install-skills.sh add -a <agent>

The script requires bash 3.2+ and standard Unix utilities (awk, find, cp, rm, mkdir).

सभी उपलब्ध कौशल सूचीबद्ध करें:```sh ./scripts/install-skills.sh list

### समर्थित एजेंट

| एजेंट           | स्थापना निर्देशिका         |
| --------------- | ------------------------- |
| claude-code     | `.claude/skills`          |
| cursor          | `.agents/skills`          |
| codex           | `.agents/skills`          |
| opencode        | `.agents/skills`          |
| pi              | `.pi/agent/skills`       |
| windsurf        | `.windsurf/skills`        |
| roo             | `.roo/skills`             |
| cline           | `.agents/skills`          |
| github-copilot  | `.agents/skills`          |
| gemini-cli      | `.agents/skills`          |

## कौशल अद्यतन करना

अद्यतन प्रक्रिया इस बात पर निर्भर करती है कि कौशल कैसे स्थापित किए गए थे।

### Claude Code प्लगइन

सभी स्थापित प्लगइन को उनके नवीनतम संस्करणों में अद्यतन करें:```sh
claude plugin update

एक विशिष्ट प्लगइन अपडेट करें:```sh claude plugin update elastic-elasticsearch

प्लगइन्स को स्वचालित रूप से अपडेट रखने के लिए, Claude Code में `/plugins` का उपयोग करके ऑटो-अपडेट सक्षम करें।

जब ऑटो-अपडेट चालू होता है, तो Claude Code स्टार्टअप पर नए प्लगइन संस्करणों की जाँच करता है और पृष्ठभूमि में अपडेट करता है।

### GitHub Copilot CLI

सभी इंस्टॉल किए गए प्लगइन्स को उनके नवीनतम संस्करणों में अपडेट करें:```sh
copilot plugin update

किसी विशिष्ट प्लगइन को अपडेट करें:```sh copilot plugin update elasticsearch

### npx

जांचें कि क्या कोई स्थापित स्किल्स अपस्ट्रीम में बदल गया है:```sh
npx skills check

सभी स्थापित स्किल्स के नवीनतम संस्करण खींचें:```sh npx skills update

CLI प्रत्येक कौशल के स्रोत रिपॉजिटरी और एक सामग्री हैश को एक लॉक फ़ाइल में ट्रैक करता है। `check` आपके स्थानीय हैश की GitHub से तुलना करता है; `update` किसी भी चीज़ को फिर से डाउनलोड करता है जो बदल गई है।

> **सुझाव:** डिफ़ॉल्ट npx इंस्टॉलेशन सिमलिंक का उपयोग करता है, इसलिए प्रत्येक एजेंट एक एकल विहित प्रतिलिपि की ओर इंगित करता है। एक बार अपडेट करने से सभी एजेंट एक साथ ताज़ा हो जाते हैं।

### स्थानीय क्लोन

मौजूदा कौशल को अधिलेखित करने के लिए `--force` के साथ इंस्टॉलर को फिर से चलाएँ:```sh
git pull
./scripts/install-skills.sh add -a <agent> --force

--force के बिना स्क्रिप्ट उन कौशलों को छोड़ देती है जो पहले से स्थापित हैं।

कौशल प्रारूप

प्रत्येक कौशल फ़ोल्डर में YAML फ़्रंटमैटर और मार्कडाउन निर्देशों के साथ एक SKILL.md होता है:```yaml

name: elasticsearch-my-skill description: > What the skill does AND when an agent should activate it. metadata: version: 0.1.0 visibility: public

My Skill

[Instructions that the agent follows when this skill is active]

`description` फ़ील्ड एकमात्र ट्रिगर तंत्र है — एजेंट रनटाइम यह तय करने के लिए इसे पढ़ते हैं कि कब कोई स्किल लोड करनी है। पूर्ण प्रारूप विनिर्देश के लिए, देखें [agentskills.io/specification](https://agentskills.io/specification)।

## समस्याएं

कोई समस्या मिली या कोई सुझाव है? [एक समस्या खोलें](https://github.com/elastic/agent-skills/issues/new) और हम इसकी समीक्षा करेंगे।

## अस्वीकरण

ये स्किल्स जैसे-हैं वैसे प्रदान की जाती हैं। महत्वपूर्ण कार्यों के लिए उन पर भरोसा करने से पहले हमेशा अपने वातावरण में स्किल्स का पूरी तरह से परीक्षण करें।