input-configurations — скилл для Claude Code: шаблоны входов Elastic
Скилл для сборки и правки шаблонов входов в интеграциях Elastic: от HTTPJSON и S3 до Journald и WebSocket. Плюс федеративная идентичность для AWS.
npx skills add elastic/integration-skills --skill input-configurations -a claude-codeЧто делает input-configurations
Скилл ведёт по файлам agent/stream/*.yml.hbs для всех типов входов, кроме CEL. Внутри — таблица маршрутизации: по имени файла агент определяет тип и подгружает нужный справочник. httpjson.yml.hbs тянет гайд по HTTPJSON, aws-s3.yml.hbs — по S3, journald.yml.hbs — по Journald, и так для пятнадцати типов: CloudWatch, Azure Blob, Azure EventHub, GCS, GCP Pub/Sub, TCP, UDP, HTTP Endpoint, Filestream, Logfile, Winlog, WebSocket.
Первым делом скилл требует прочитать references/common-input-patterns.md. Там общие для всех типов вещи: теги, проброс процессоров, соглашения по переменным, связка forwarded и publisher_pipeline.disable_host. Без этого дальше идти смысла нет, потому что типовые гайды опираются на эти паттерны.
Отдельная ветка — Federated Identity (Cloud Connectors) для безагентных интеграций AWS. Для неё грузится references/federated-identity-aws.md независимо от типа входа, включая cel. Блок auth.aws и use_cloud_connectors на шаблонах CEL-потоков остаётся за этим скиллом, а вот логика самих CEL-программ — уже территория cel-programs. Схему манифеста (var_groups, provider_permissions, format_version) отдают в package-spec, проблемы пайплайнов — в ingest-pipelines, маппинг полей — в ecs-field-mappings. Если правите только шаблон входа, лишние гайды не подтягиваются: скилл велит брать ровно один справочник под найденный тип.
Какие задачи решает
- собрать шаблон
agent/stream/*.yml.hbsдля нового типа входа - настроить блоки request, response, pagination, cursor и аутентификации в HTTPJSON
- подключить сбор из облачных хранилищ: AWS S3, GCS, Azure Blob, Azure EventHub
- описать сетевые входы TCP, UDP, HTTP Endpoint и WebSocket
- включить Federated Identity на пакете интеграции AWS
Примеры запросов агенту
- Собери шаблон
agent/stream/aws-s3.yml.hbsдля сбора уведомлений из бакета S3 - Проверь блок пагинации и cursor в
httpjson.yml.hbs - Настрой
auth.awsиuse_cloud_connectorsдля безагентной интеграции AWS
Как установить input-configurations
1Через Skills CLI (Vercel)
npx skills add elastic/integration-skills --skill input-configurations -a claude-code2Вручную: положить файлы
~/.claude/skills/input-configurations/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/input-configurations/
1Через Skills CLI (Vercel)
npx skills add elastic/integration-skills --skill input-configurations -a codex2Вручную: положить файлы
.agents/skills/input-configurations/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add elastic/integration-skills --skill input-configurations -a cursor2Вручную: положить файлы
.cursor/skills/input-configurations/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install elastic/integration-skills input-configurations2Вручную: положить файлы
.github/skills/input-configurations/SKILL.md1Через Skills CLI (Vercel)
npx skills add elastic/integration-skills --skill input-configurations -a gemini-cli2Командой платформы
gemini skills install https://github.com/elastic/integration-skills --path skills/input-configurationsВручную: положить файлы
.devin/skills/input-configurations/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add elastic/integration-skills --skill input-configurations -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о input-configurations
Как установить input-configurations в Claude?
Выполните npx skills add elastic/integration-skills --skill input-configurations -a claude-code. После этого скилл лежит в ~/.claude/skills/input-configurations/SKILL.md.
Что делает input-configurations?
Помогает писать и проверять шаблоны входов Elastic: подсказывает структуру, пагинацию, аутентификацию и переменные для конкретного типа входа. Отдельно разбирает Federated Identity для AWS.
Чем этот скилл отличается от cel-programs?
Логика CEL-программ — в cel-programs. Здесь остаются шаблоны всех не-CEL входов, а из CEL-части только блок auth.aws и use_cloud_connectors для федеративной идентичности.
Исходный текст
SKILL.md · Apache-2.0
--- name: input-configurations description: >- Input template configuration for Elastic integrations. Covers agent stream templates (agent/stream/*.yml.hbs) for all non-CEL input types: HTTPJSON, AWS S3, CloudWatch, Azure Blob, Azure EventHub, GCS, GCP Pub/Sub, TCP, UDP, HTTP Endpoint, Filestream, Logfile, Journald, Winlog, and WebSocket. Also covers Federated Identity (Cloud Connectors) for agentless AWS integrations, including the auth.aws / use_cloud_connectors block on CEL stream templates. For CEL program logic, use the cel-programs skill. license: Apache-2.0 metadata: author: elastic version: "1.0" --- # input-configurations ## When to use Load this skill whenever tasks include: - building, modifying, or reviewing `agent/stream/*.yml.hbs` templates for non-CEL input types - configuring request, response, pagination, cursor, or authentication blocks in HTTPJSON templates - wiring up cloud storage inputs (AWS S3, GCS, Azure Blob, Azure EventHub) - setting up network inputs (TCP, UDP, HTTP Endpoint, WebSocket) - configuring file-based inputs (Filestream, Logfile, Journald, Winlog) - enabling Federated Identity (Cloud Connectors) on an AWS integration package ## When not to use Do not use this skill as the primary guide for: - CEL *program* development (`cel-programs`) -- CEL program structure, state model, and mito workflow. Exception: the `auth.aws` / `use_cloud_connectors` template block for Federated Identity is owned here via `references/federated-identity-aws.md` - ingest pipeline processor design (`ingest-pipelines`) - field mappings and ECS compliance (`ecs-field-mappings`) - `var_groups` / `provider_permissions` *schema* and `format_version` floors alone (`package-spec`) -- use this skill for the end-to-end federation procedure that applies them ## Mandatory first read **Always load `references/common-input-patterns.md` first.** It covers patterns that apply to every input type (tags, processors passthrough, variable conventions, `forwarded`/`publisher_pipeline.disable_host` coupling). These patterns are prerequisites for all type-specific guides. ## Type routing table Detect the input type from the filename pattern in `agent/stream/` or from the data stream manifest `input:` field, then load the matching guide. | Input type | Filename pattern | Guide | |---|---|---| | HTTPJSON | `httpjson.yml.hbs` | `references/httpjson-guide.md` | | AWS S3 | `aws-s3.yml.hbs` | `references/aws-s3-guide.md` | | CloudWatch | `aws-cloudwatch.yml.hbs` | `references/aws-cloudwatch-guide.md` | | Azure Blob Storage | `azure-blob-storage.yml.hbs` | `references/azure-blob-storage-guide.md` | | Azure Event Hub | `azure-eventhub.yml.hbs` | `references/azure-eventhub-guide.md` | | GCS | `gcs.yml.hbs` | `references/gcs-guide.md` | | GCP Pub/Sub | `gcp-pubsub.yml.hbs` | `references/gcp-pubsub-guide.md` | | TCP | `tcp.yml.hbs` | `references/tcp-udp-guide.md` | | UDP | `udp.yml.hbs` | `references/tcp-udp-guide.md` | | HTTP Endpoint | `http_endpoint.yml.hbs` | `references/http-endpoint-guide.md` | | Filestream | `filestream.yml.hbs` | `references/filestream-logfile-guide.md` | | Logfile | `log.yml.hbs` | `references/filestream-logfile-guide.md` | | Journald | `journald.yml.hbs` | `references/journald-guide.md` | | Winlog | `winlog.yml.hbs` | `references/winlog-guide.md` | | WebSocket | `websocket.yml.hbs` | `references/websocket-guide.md` | Load **only** the guide for the detected input type, not all guides. For **Federated Identity** tasks (any eligible input type, including `cel`), load `references/federated-identity-aws.md` regardless of which input type is involved. ## Handoff - For **CEL program logic**, hand off to the `cel-programs` skill. Keep this skill loaded for Federated Identity `auth.aws` / `use_cloud_connectors` edits on `cel.yml.hbs`. - For **manifest schema** (`var_groups`, `provider_permissions`, `format_version` / conditions floors), hand off to the `package-spec` skill (`references/var-groups-and-provider-permissions.md`). - For **pipeline issues** discovered while reviewing input templates, hand off to the `ingest-pipelines` skill. - For **field mapping issues** found in template variable wiring, hand off to the `ecs-field-mappings` skill. ## References - `references/common-input-patterns.md` -- tags, processors passthrough, variable conventions, review flags (applies to ALL input types) - `references/httpjson-guide.md` -- HTTPJSON template syntax, structure, validation rules, pagination patterns, authentication, cursor persistence - `references/aws-s3-guide.md` -- S3 bucket/SQS notification collection - `references/aws-cloudwatch-guide.md` -- CloudWatch log group collection - `references/azure-blob-storage-guide.md` -- Azure Blob Storage collection - `references/azure-eventhub-guide.md` -- Azure Event Hub collection - `references/gcs-guide.md` -- Google Cloud Storage collection - `references/gcp-pubsub-guide.md` -- GCP Pub/Sub collection - `references/tcp-udp-guide.md` -- TCP and UDP (syslog-style) listeners - `references/http-endpoint-guide.md` -- HTTP Endpoint (webhook receiver) - `references/filestream-logfile-guide.md` -- Filestream and legacy Logfile inputs - `references/journald-guide.md` -- Journald collection - `references/winlog-guide.md` -- Windows Event Log collection - `references/websocket-guide.md` -- WebSocket streaming (may embed CEL) - `references/federated-identity-aws.md` -- AWS Federated Identity procedure: input classification, federation vars, `auth.aws` / `use_cloud_connectors`, input gating (schema lives in `package-spec`)
© elastic · Apache-2.0 · elastic/integration-skills