agent-skills v0.4.0
مهارات Elastic الرسمية
مهارات Elastic Agent
مهارات Elastic Agent — بُنيت بواسطة الأشخاص الذين بنوا Elastic — تقدّم خبرة المنصة الأصلية مباشرةً إلى وكيل البرمجة بالذكاء الاصطناعي الخاص بك. هذه هي مكتبة مهارات الوكيل الرسمية، المتوافقة مع بيئات التطوير المتكاملة الوكيلية مثل Cursor وGitHub Copilot وWindsurf وGemini CLI وغيرها. تتبع المهارات المعيار المفتوح Agent Skills.
[!NOTE] معاينة تقنية
هذه المهارات في إصدار مبكر وتحت تطوير نشط. توقّع تغييرات مع تدوين المهارات بتقييمات قوية ومع تطور مشهد النماذج. تحقق بشكل متكرر للحصول على التحديثات.
نبذة
يحتوي هذا المستودع على مهارات منسّقة عبارة عن حزم من التعليمات والسياق والأدوات التي تعلّم أي وكيل ذكاء اصطناعي كيفية العمل بشكل صحيح مع Elasticsearch وKibana وElastic Observability وElastic Security. أضفها إلى بيئة تشغيل الوكيل التي تستخدمها بالفعل، وسيتوقف مساعدك عن استخدام الأنماط القديمة ويبدأ في العمل بشكل صحيح.
ما هي المهارات؟
المهارات هي حزم مكتفية ذاتيًا تمنح وكلاء الذكاء الاصطناعي المعرفة والأدوات لإنجاز مهام محددة بطريقة قابلة للتكرار. توجد كل مهارة في مجلد خاص بها يحتوي على ملف SKILL.md يتضمن البيانات الوصفية والتعليمات التي يتبعها الوكيل.
لمزيد من الخلفية حول معيار Agent Skills، راجع agentskills.io.
النطاق
تركز المهارات في هذا المستودع على:
- التفاعل مع واجهات Elasticsearch APIs (البحث، الفهرسة، إدارة العنقود)
- بناء وإدارة محتوى Kibana مثل التنبيهات والموصلات وغيرها
- أنماط Elastic Observability وElastic Security وAgent Builder
المهارات المتاحة
Cloud (2)
| Skill | Description | Version | Author |
|---|---|---|---|
| cloud-onboarding | Onboard an Elastic Cloud organization: configure the elastic CLI's Cloud context and API key, establish a default region, then invite users, assign predefined or custom Serverless project roles, and create or revoke Cloud API keys. Use when setting up Cloud authentication or when granting, modifying, or auditing user access to an organization and its projects. | 0.3.0 | elastic |
| cloud-provisioning | Provision and operate Elastic Cloud infrastructure: create, connect to, update, and delete Serverless projects (Elasticsearch, Observability, Security); manage traffic filters (IP and AWS PrivateLink network security); and manage the lifecycle of Elastic Cloud Hosted deployments. Use when creating or performing day-2 operations on serverless projects or hosted deployments, or restricting their network access. | 0.3.0 | elastic |
Elasticsearch (10)
| Skill | Description | Version | Author |
|---|---|---|---|
| elasticsearch-anomaly-detection | Create and manage Elastic ML anomaly detection jobs via the API. Use when setting up jobs on an index or data stream, configuring jobs and datafeeds, or opening, starting, or stopping them. | 1.1.0 | elastic |
| elasticsearch-anomaly-detection-explainer | Explain Elasticsearch ML anomaly detection scores, model behavior, and result interpretation. Use when the user asks why a score is high or low, how the model learns, what the numbers mean, or how to troubleshoot unexpected anomaly scores. | 0.3.0 | elastic |
| elasticsearch-cluster-health | Diagnose a non-green Elasticsearch cluster and surface the single most likely cause with remediation. Use when an operator reports yellow or red status, unassigned shards, allocation failures, or wants read-only triage before deeper investigation. Teaches replica-vs-primary impact, allocation decider classification, and data-loss awareness. | 0.1.0 | elastic |
| elasticsearch-esql | Execute ES|QL (Elasticsearch Query Language) queries, use when the user wants to query Elasticsearch data, analyze logs, aggregate metrics, explore data, or create charts and dashboards from ES|QL results. | 0.7.0 | elastic |
| elasticsearch-index-design | Design and review Elasticsearch index mappings for stated access patterns: correct field types, text+keyword multi-fields, doc_values tuning, mapping-explosion avoidance, and explicit shard settings. Use when creating a new index, reviewing a mapping for storage or query performance, fixing wrong field types, or when the user asks which type to use for search, filter, sort, or aggregation on a field. | 0.1.0 | elastic |
| elasticsearch-ingest | Load CSV and JSON files into Elasticsearch indices using the bulk API and explicit mappings when field types matter. Use when batch-importing local files, converting CSV rows or JSON arrays to NDJSON bulk format, or verifying document counts and mappings after ingest — not for Logstash pipelines, Beats, custom scripts, or index-to-index reindex. | 0.1.0 | elastic |
| elasticsearch-onboarding | Help developers new to Elasticsearch get from zero to a working search experience. Guide them through understanding their intent, mapping their data, and building a search experience with best practices baked in. Use this when the user shows intent to build search-related functionality, asks about Elasticsearch-related concepts for their use case, or expresses the need for help getting started with Elasticsearch. | 0.1.0 | elastic |
| elasticsearch-query-optimization | Diagnose slow Elasticsearch Query DSL searches and propose measured fixes. Use when a search is slow, profile output shows an expensive clause, exact-match filters sit in scoring context, or leading wildcards dominate latency. Ground every recommendation in search profiling — move non-scoring clauses to filter context, eliminate leading wildcards, and re-profile to confirm improvement. | 0.1.0 | elastic |
| elasticsearch-reindex | Guide Elasticsearch reindex for performance: local and remote, slicing, throttling, task API. Use when copying or migrating indices, changing mappings, or transforming during reindex. | 0.2.0 | elastic |
| elasticsearch-search-relevance | Improve Elasticsearch search relevance for content and catalog indices: pin or promote results with query rules (correct rule type, criteria, and rule-query wiring) and tune organic ranking with multi_match, field boosts, and analysis grounded in the index mapping. Use when search results rank poorly, a specific document must appear first for a query, or the user asks to tune full-text matching — not for ES|QL analytics, index ingest, or cluster health. | 0.1.0 | elastic |
Kibana (5)
| Skill | Description | Version | Author |
|---|---|---|---|
| kibana-agent-builder | Create and manage Kibana Agent Builder agents and custom tools. Use when asked to create, update, delete, test, or inspect agents or tools in Agent Builder, or when the user wants to understand what agents or tools already exist. | 0.3.0 | elastic |
| kibana-alerting-rules | Create and manage Kibana alerting rules. Use when creating, updating, or managing rule lifecycle (enable, disable, mute, snooze), choosing metric threshold rule types and params, or read-only find/list with tag filters. | 0.3.0 | elastic |
| kibana-anomaly-detection | Elastic ML anomaly detection — investigation/RCA, score explanation, job lifecycle troubleshooting, and job operations. Use when answering "what broke?"/"which entity?"/RCA, "why is score high/low?"/renormalization, "datafeed stopped"/"memory limit"/hard_limit, or configuring ML anomaly detection jobs. Reads results from .ml-anomalies-* and job state from ML REST APIs. | 0.3.0 | elastic |
| kibana-dashboards | Create and manage Kibana Dashboards and Lens visualizations. Use when you need to define dashboards and visualizations declaratively, version control them, or automate their deployment. | 0.3.0 | elastic |
| kibana-workflows | Author, validate, test, run, and inspect Elastic Workflow YAML definitions. Use when the user wants to turn natural language into a Kibana workflow, fix workflow YAML, understand triggers or steps, or run a quick test loop against a real Kibana. | 0.5.0 | elastic |
Observability (5)
| Skill | Description | Version | Author |
|---|---|---|---|
| observability-k8s-investigation | Investigate Kubernetes workload, node, and control-plane issues using OTel telemetry (EDOT). Use when diagnosing pod failures (CrashLoopBackOff, OOMKilled, Error), node pressure, resource exhaustion, image pull failures, admission rejections, autoscaling anomalies, or correlating K8s state with application signals. OTel ingest path only — the legacy ECS Kubernetes integration shape is out of scope. | 0.5.1 | elastic |
| observability-llm-obs | Answer questions about LLM and agentic-application behavior from data already ingested into Elastic: latency and error rate, token and cost utilization, response quality and guardrail events, and agentic call-chain orchestration. Use when the user asks about LLM monitoring, GenAI observability, token spend or AI cost, model latency, prompt or guardrail failures, or how an agent's tool-call chain executed. | 0.3.1 | elastic |
| observability-onboarding | Onboard an application into Elastic Observability with the Elastic Distribution of OpenTelemetry (EDOT): route on language and runtime, detect and replace a classic Elastic APM agent, apply the required OTLP configuration, and then verify with ES|QL that traces, metrics, and logs actually arrive under the expected service name. Use when adding observability to a service, migrating off the classic Elastic APM agent, or debugging why an instrumented service is not showing up in Elastic. | 0.3.0 | elastic |
| observability-service-reliability | Design and operate service reliability targets in Elastic Observability: choose an SLI type and a defensible target, pick a time window and budgeting method, create and maintain SLOs through the Kibana API, attach burn-rate alert rules, and decide when an SLO is the wrong instrument and a threshold rule, anomaly job, or synthetics monitor is right. Use when defining or reviewing SLOs and error budgets, tuning burn-rate alerting, reducing alert noise, or setting up availability monitoring for a user-facing endpoint. | 0.4.1 | elastic |
| observability-sre-triage | Triage a degraded or suspect service end to end: read SLO status and burn rate, check active alerting rules and ML anomalies, measure throughput, latency, and error rate, assess dependency health and infrastructure saturation, and funnel logs down to the failures that explain it. Use when someone asks whether a service is healthy, why it is slow or erroring, what is in its logs, or which attribute distinguishes the requests that are failing. Also use when someone asks for the query behind any of those signals — throughput, latency percentiles, error rate, dependency health, or log volume — over APM/OTel traces, metrics, or logs. | 0.5.1 | elastic |
Security (4)
| Skill | Description | Version | Author |
|---|---|---|---|
| security-alert-triage | Triage Elastic Security alerts — gather context, classify threats, create cases, and acknowledge. Use when triaging alerts, performing SOC analysis, or investigating detections. | 0.1.0 | elastic |
| security-case-management | Create, search, update, and manage SOC cases via the Kibana Cases API. Use when tracking incidents, linking alerts to cases, adding investigation notes, or managing triage output. | 0.1.0 | elastic |
| security-detection-rule-management | Create, tune, and manage Elastic Security detection rules (SIEM and Endpoint). Use for false positives, exceptions, new coverage, noisy rules, or rule management via Kibana API. | 0.1.0 | elastic |
| security-generate-security-sample-data | Generate sample security events, attack scenarios, and synthetic alerts for Elastic Security. Use when demoing, populating dashboards, testing detection rules, or setting up a POC. | 0.1.0 | elastic |
اعتبارات أمنية
يعمل وكلاء البرمجة بالذكاء الاصطناعي ببيانات اعتماد حقيقية ووصول حقيقي إلى الصدفة، وغالبًا بكامل صلاحيات المستخدم الذي يشغّلها. عندما تُوجَّه هذه الوكلاء إلى سير عمل أمني، تصبح المخاطر أعلى. وهذا يستدعي محادثة صريحة حول المخاطر قبل أن تبدأ.
- أجرِ نمذجة التهديدات الخاصة بك. قيّم البيانات التي يمكن للوكيل الوصول إليها، والإجراءات التي يمكنه اتخاذها، وما يحدث إذا تصرف بشكل غير متوقع. تُعدّ إرشادات CISA المشتركة لنشر أنظمة الذكاء الاصطناعي بأمان نقطة بداية جيدة.
- كن على دراية بالبيانات التي تمر عبر الوكيل. قد تحتوي البيانات الأمنية على معلومات تعريف شخصية (PII)، وبيانات اعتماد مضمّنة في سطور الأوامر، وبيانات خاضعة للتنظيم أخرى. عندما يستعلم الوكيل عن التنبيهات أو أحداث العمليات، يدخل هذا المحتوى إلى سياق النموذج وقد يُرسَل إلى واجهة برمجة تطبيقات طرف ثالث. أشرك فرق أمن المعلومات والامتثال لديك مبكرًا.
- تعالج هذه الوكلاء مدخلات يتحكم بها المهاجم. تحتوي التنبيهات وحقول الأحداث ومحتويات الملفات بانتظام على سلاسل مصممة من قِبل المهاجمين. حقن الأوامر (Prompt injection) ليس نظريًا هنا؛ بل هو خاصية متأصلة في بيئة التشغيل. تُظهر أبحاث مثل Brainworm أن ملفات سياق الوكيل وحدها يمكن أن تكون بمثابة آلية استمرارية للبرمجيات التوجيهية (promptware).
- حدّد الصلاحيات بشكل ضيق. امنح مفاتيح API الحد الأدنى من الصلاحيات المطلوبة. صلاحيات الاستجابة الواسعة خطيرة بشكل خاص. الوصول للقراءة فقط هو إعداد افتراضي جيد حتى تتحقق من السلوك.
- قيّد وصول الوكيل إلى الأدوات والوصول الشبكي. تأتي معظم وكلاء البرمجة بالذكاء الاصطناعي بإعدادات افتراضية واسعة: تنفيذ الصدفة، الكتابة على نظام الملفات، الوصول إلى الإنترنت. تقليل سطح الأدوات المتاحة يحدّ مما يمكن لوكيل مخترق أو مُوجَّه بشكل خاطئ فعله.
- ابدأ في بيئات غير إنتاجية. استخدم مشروع Serverless تجريبي، أو عنقود تطوير، أو مساحة Kibana معزولة لتقييم المهارات قبل ربطها بأي شيء يحمل بيانات أمنية حية.
هذه المهارات مفتوحة المصدر تحديدًا لتتمكن من تدقيق ما تفعله. نشجعك على قراءتها قبل تشغيلها.
البدء
يمكنك تثبيت مهارات Elastic باستخدام نظام الإضافات الأصلي في Claude Code، أو أداة skills CLI مع npx، أو باستنساخ هذا المستودع وتشغيل سكربت التثبيت المرفق. تتطلب طريقة npx وجود Node.js مع npx متاحًا في بيئتك.
[!TIP] لا تثبّت كل المهارات. كل مهارة مثبّتة تضيف سياق توجيه يقيّمه وكيلك عند كل طلب. ثبّت مهارات المصادقة cloud وelasticsearch — فمعظم المهارات الأخرى تعتمد عليها — ثم أضف فقط المهارات ذات الصلة بسير عملك. الحفاظ على مجموعة مثبّتة مركّزة يتجنب تضخم السياق ويساعد الوكيل على التوجيه إلى المهارة الصحيحة بشكل موثوق.
إضافة Claude Code (موصى بها لمستخدمي Claude Code)
يمتلك Claude Code نظام إضافات أصليًا يدير المهارات مباشرةً. ابدأ بإضافة هذا المستودع كمصدر سوق:```sh claude plugin marketplace add https://github.com/elastic/agent-skills
بمجرد الإضافة، قم بتثبيت الإضافات الفردية بالاسم:```sh
claude plugin install elastic-elasticsearch@elastic-agent-skills
claude plugin install elastic-kibana@elastic-agent-skills
claude plugin install elastic-observability@elastic-agent-skills
claude plugin install elastic-security@elastic-agent-skills
claude plugin install elastic-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. لا حاجة لاستنساخ هذا المستودع — فقط شغّل:```sh
npx skills add elastic/agent-skills
يؤدي هذا إلى تشغيل موجه تفاعلي لاختيار المهارات و[الوكلاء المستهدفين](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents). تقوم واجهة سطر الأوامر بنسخ مجلد كل مهارة إلى الموقع الصحيح ليكتشفه الوكيل.
تثبيت مهارة محددة بالاسم:```sh
npx skills add elastic/agent-skills --skill elasticsearch-esql
أو استخدم الاختصار @ لتحديد المهارة مباشرةً بصيغة repo@skill (مكافئ لـ --skill):```sh
npx skills add elastic/agent-skills@elasticsearch-esql
التثبيت لوكلاء محددين (انظر [الوكلاء المدعومون](https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents)):```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 | استهداف وكلاء محددين (انظر الوكلاء المدعومون) |
-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
يتطلب السكربت bash 3.2+ وأدوات Unix القياسية (`awk`، `find`، `cp`، `rm`، `mkdir`).
| العَلَم | الوصف |
| ----------------- | ------------------------------------- |
| `-a, --agent` | الوكيل الهدف (قابل للتكرار) |
| `-s, --skill` | تثبيت مهارات محددة بالاسم |
| `-f, --force` | الكتابة فوق المهارات المثبّتة مسبقًا |
| `-y, --yes` | تخطي مطالبات التأكيد |
سرد جميع المهارات المتاحة:```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
للحفاظ على تحديث الإضافات تلقائيًا، فعّل التحديث التلقائي باستخدام /plugins داخل Claude Code.
عند تفعيل التحديث التلقائي، يتحقق 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 --force
بدون `--force` يتخطى السكربت المهارات المثبّتة بالفعل.
## تنسيق المهارة
كل مجلد مهارة يحتوي على ملف `SKILL.md` مع YAML frontmatter وتعليمات markdown:```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.
المشكلات
هل وجدت مشكلة أو لديك اقتراح؟ افتح مشكلة وسنراجعها.
إخلاء المسؤولية
تُقدَّم هذه المهارات كما هي. اختبر المهارات جيدًا دائمًا في بيئتك الخاصة قبل الاعتماد عليها في المهام الحرجة.