agentsclimarketplace
Sign in

Elastic package cli

Skill elastic/integration-skills/skills/elastic-package-cli

Use when developing or validating Elastic integrations with elastic-package commands such as build, check, lint, format, test, stack, service, install, profiles, and benchmark.From its SKILL.md

Install
npx -y skills add elastic/integration-skills --skill elastic-package-cli

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 15 stars15 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as Apache-2.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.2 KB, as published. Nobody here has run it

elastic-package CLI

When to use

Use this skill when tasks include:

  • validating package structure and formatting
  • building a package artifact
  • running pipeline or system tests
  • managing local Elastic test stack lifecycle
  • installing or checking package status in Kibana

When not to use

Do not use this skill as the primary guide for:

  • ECS field design decisions (use an ECS-focused skill)
  • ingest processor design and parsing strategy (use an ingest-pipeline-focused skill)
  • package layout architecture (use a package-structure-focused skill)

Prerequisites

  • elastic-package is installed and available in PATH
  • container runtime is available (Docker or Podman)
  • you run commands from a package directory (or pass -C <package-dir>)

Core workflows

1) Validate and build loop

Run this sequence for routine local verification:

elastic-package format
elastic-package lint
elastic-package check
elastic-package build

Notes:

  • check runs lint and build together and fails fast by default.
  • use format --fail-fast when you want read-only verification without rewriting files.

2) Pipeline test loop (fast iteration)

Use Elasticsearch-only stack for quicker feedback:

elastic-package stack up -d --services=elasticsearch
elastic-package test pipeline
elastic-package test pipeline --generate

Then review generated expected files before keeping changes.

3) System test loop (end-to-end)

Use this when you need full ingest behavior with service provisioning:

elastic-package stack up -d
elastic-package service up
elastic-package test system

Use --data-streams <name> to scope tests and reduce run time.

Practical command examples

# format package files
elastic-package format

# lint against package spec and templates
elastic-package lint

# combined validation workflow
elastic-package check

# build package artifact
elastic-package build

# start only Elasticsearch for pipeline tests
elastic-package stack up -d --services=elasticsearch

# run pipeline tests
elastic-package test pipeline

# regenerate expected pipeline outputs
elastic-package test pipeline --generate

# run end-to-end system tests
elastic-package test system

Key flags cheat sheet

  • global: -C, --change-directory, -v, --verbose
  • stack: -d, --daemon, -s, --services, --version, -p, --profile
  • pipeline tests: -d, --data-streams, -g, --generate, -m, --fail-on-missing
  • system tests: --setup, --tear-down, --no-provision, --variant

Quick command map

  • validate/build: format, lint, check, build
  • stack lifecycle: stack up, stack status, stack down
  • testing: test pipeline, test system, test static, test asset, test policy, test script
  • package lifecycle: create, install, status, uninstall
  • support: service up, profiles, benchmark

References

  • Failure diagnosis and fixes: references/troubleshooting.md

Keep looking

Skills are one crate of 627,801. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.