Official agent skill

Workflows Custom Steps

by elastic in elastic/kibana

Register and implement custom workflow steps from an external Kibana plugin using @kbn/workflows-extensions.

OfficialCustom licenceAuto-check passedFrontend & Design

Install Workflows Custom Steps

skills CLI
$ npx skills add elastic/kibana --skill workflows-custom-steps -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install elastic/kibana workflows-custom-steps --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/elastic/kibana.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/platform/plugins/shared/workflows_extensions/.claude/skills/workflows-custom-steps .claude/skills/workflows-custom-steps && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
workflows-custom-steps
GitHub stars
21k
Token cost
~5.9k tokens
SKILL.md length
2,299 words
Files
2
Skills in repo
40
Repo updated
First seen
Licence
Custom licence

At a glance

Register and implement custom workflow steps from an external Kibana plugin using @kbn/workflows-extensions.

  • Works in 6 steps: Plugin location → Common file (common/step_types/.ts or… → Server file (server/step_types/.ts) —… → …
  • Modifying a step type with registerStepDefinition
  • SKILL.md covers Canonical guide — read this…, Overview, 0. Locate the owning plugin… and File layout, plus 6 more sections
  • Calls rg

What it does

Workflows Custom Steps is an agent skill from elastic/kibana, published by the product's own GitHub organization. Register and implement custom workflow steps from an external Kibana plugin using @kbn/workflows-extensions. Use when adding or modifying a step type with registerStepDefinition, designing input/output/config Zod schemas, implementing createServerStepDefinition / createPublicStepDefinition, choosing StepCategory, building editorHandlers (selection / dynamicSchema), wiring callKibanaApi / onCancel, deciding sync vs async loader registration, managing per-step approval files under approvedstepdefinitions/, or…

Its SKILL.md is about 5.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `reference.md`).

It sits in Frontend & Design, covering Forms and validation. It works with Elasticsearch and Zod. The repository describes itself as: Your window into all of your data.

When your agent uses it

  • Modifying a step type with registerStepDefinition
  • Designing input/output/config Zod schemas
  • Implementing createServerStepDefinition / createPublicStepDefinition
  • Choosing StepCategory

Example prompts

  • “/workflows-custom-steps”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Plugin location
  2. Common file (common/step_types/.ts or plugin convention) — see STEPS.md Step 1
  3. Server file (server/step_types/.ts) — see STEPS.md Step 2
  4. Public file (public/step_types/.ts) — see STEPS.md Step 3 and Custom Property Selection
  5. Registration ({server,public}/step_types/index.ts) — see STEPS.md Step 4
  6. Approval gate — see STEPS.md Step Definition Approval Process

What it can do on your machine

Read from SKILL.md and the folder at commit ee7c86b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • rg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Workflows Custom Steps loads about 5.9k tokens when it runs. Until then it costs about 149 tokens; SKILL.md has 2,299 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~149
When it runs · the whole SKILL.md, loaded when a task matches
~5.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 2,299 words (~5,908 tokens).

“Follow the end-to-end steps, code templates, naming conventions, and approval workflow in:”

— opening of SKILL.md by elastic, Custom licence
name
workflows-custom-steps

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in src/platform/plugins/shared/workflows_extensions/.claude/skills/workflows-custom-steps of elastic/kibana.

  • SKILL.md
  • reference.md

Open the folder on GitHubat commit ee7c86b

Compare with similar skills

Workflows Custom Steps next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Workflows Custom Steps compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workflows Custom Steps this skillelastic/kibana21k—~5.9kAutomated safety check: PassCustom licence
World Book Skillecho-xianyu/worldbook-skill211—~1.8kAutomated safety check: PassCustom licence
Reglevictorgarciaesgi/regle506—~840Automated safety check: PassMIT
Buzzformbuildnbuzz/buzzform101—~1.5kAutomated safety check: PassMIT
Regle Migrate Vuelidatevictorgarciaesgi/regle506—~752Automated safety check: PassMIT
Shared SchemasInsForge/InsForge13k—~628Automated safety check: PassApache-2.0

Similar skills

  • World Book Skill

    echo-xianyu/worldbook-skill

    Create and manage SillyTavern Character Cards (角色卡) and World Books (世界书).

    211 GitHub stars~1.8k tokensUpdated 4 mo ago
    Frontend & DesignAuto-check passed
  • Regle

    victorgarciaesgi/regle

    Core Regle form validation in Vue 3 — setup with useRegle, the reactive r$ object, validation properties, displaying errors, and modifiers.

    506 GitHub stars~840 tokensUpdated 9 days ago
    Frontend & DesignAuto-check passed
  • Buzzform

    buildnbuzz/buzzform

    A skill your agent uses when working with BuzzForm schema-driven forms, @buildnbuzz/form-core, @buildnbuzz/form-react, or any related APIs like defineSchema, InferType, FormProvider, useDataField…

    101 GitHub stars~1.5k tokensUpdated 4 mo ago
    Frontend & DesignAuto-check passed
  • Regle Migrate Vuelidate

    victorgarciaesgi/regle

    Migrate Vuelidate form validation to Regle. An agent skill from victorgarciaesgi/regle.

    506 GitHub stars~752 tokensUpdated 9 days ago
    Frontend & DesignAuto-check passed
  • Shared Schemas

    InsForge/InsForge

    A skill your agent uses when contributing to InsForge's shared schema package.

    13k GitHub stars~628 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Sets the conventions for the Opik React frontend: TanStack Query for data, Zustand for shared state, one-way layer imports and a fix for Google Translate crashes.

    22k GitHub stars~1.1k tokensUpdated today
    Frontend & DesignAuto-check passed

More from elastic/kibana

All 40 skills in this repo
  • Official

    Migrate Kibana Cypress E2E tests (.cy.ts) to Scout (Playwright).

    21k GitHub stars~3.8k tokensUpdated today
    Auto-check passed
  • Activate Connector

    elastic/kibana

    Official

    Creates a connector instance in a running Kibana. An agent skill from elastic/kibana.

    21k GitHub stars~1.9k tokensUpdated today
    Auto-check: notes
  • Codeql

    elastic/kibana

    Official

    Work with CodeQL in Kibana — write, test, and debug custom queries locally, fetch scan results from GitHub, and validate inline suppression comments.

    21k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Debug Oas

    elastic/kibana

    Official

    A skill your agent uses when debugging OpenAPI (OAS) issues for a specific API area in Kibana by scoping validation output with one or more --path filters, then separating structural invalid-OAS…

    21k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Evals Write Spec

    elastic/kibana

    Official

    Write LLM evaluation spec files with datasets, tasks, and evaluators using the @kbn/evals Playwright fixture.

    21k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Kbn GitHub

    elastic/kibana

    Official

    GitHub interactions via gh CLI for the Kibana repo. An agent skill from elastic/kibana.

    21k GitHub stars~1.3k tokensUpdated today
    Auto-check passed

Questions about Workflows Custom Steps

What does Workflows Custom Steps do?

Register and implement custom workflow steps from an external Kibana plugin using @kbn/workflows-extensions. Workflows Custom Steps is an agent skill from elastic/kibana, published by the product's own GitHub organization. Register and implement custom workflow steps from an external Kibana plugin using @kbn/workflows-extensions.

When should I use Workflows Custom Steps?

Workflows Custom Steps fits situations like: modifying a step type with registerStepDefinition; designing input/output/config Zod schemas; implementing createServerStepDefinition / createPublicStepDefinition; choosing StepCategory.

How do I install Workflows Custom Steps in Claude Code?

Run `npx skills add elastic/kibana --skill workflows-custom-steps -a claude-code`. Or copy the skill folder (src/platform/plugins/shared/workflows_extensions/.claude/skills/workflows-custom-steps in elastic/kibana) into .claude/skills/workflows-custom-steps in your project. Claude Code loads it when a task matches its description.

How do I install Workflows Custom Steps in Codex?

Run `npx skills add elastic/kibana --skill workflows-custom-steps -a codex`. Or copy the skill folder (src/platform/plugins/shared/workflows_extensions/.claude/skills/workflows-custom-steps in elastic/kibana) into .agents/skills/workflows-custom-steps in your project. Codex loads it when a task matches its description.

Can I use Workflows Custom Steps in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add elastic/kibana --skill workflows-custom-steps -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/workflows-custom-steps, .gemini/skills/workflows-custom-steps, .github/skills/workflows-custom-steps and .opencode/skills/workflows-custom-steps in your project.

What does Workflows Custom Steps need to run?

Going by SKILL.md and its folder, Workflows Custom Steps needs the command-line tools its instructions call (rg).

Does Workflows Custom Steps access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Workflows Custom Steps safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Workflows Custom Steps use?

Workflows Custom Steps has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Workflows Custom Steps use?

About 5.9k tokens (SKILL.md is roughly 24k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Workflows Custom Steps?

Skills that share tags, products or a category with Workflows Custom Steps: World Book Skill (echo-xianyu/worldbook-skill, 211 stars), Regle (victorgarciaesgi/regle, 506 stars), Buzzform (buildnbuzz/buzzform, 101 stars) and Regle Migrate Vuelidate (victorgarciaesgi/regle, 506 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workflows Custom Steps?

elastic (a GitHub organization, an official publisher) maintains it in elastic/kibana, which has 21,310 GitHub stars. The repository holds 40 skills in this directory. The repository was last updated on October 8, 2026.

Source: elastic/kibana on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.