Official agent skill

Evals Write Spec

by elastic in elastic/kibana

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

OfficialCustom licenceAuto-check passedAI & LLM Engineering

Install Evals Write Spec

skills CLI
$ npx skills add elastic/kibana --skill evals-write-spec -a claude-code

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

GitHub CLI
$ gh skill install elastic/kibana evals-write-spec --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/.agents/skills/evals-write-spec .claude/skills/evals-write-spec && 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
evals-write-spec
GitHub stars
21k
Token cost
~2.3k tokens
SKILL.md length
575 words
Files
3 (incl. references)
Skills in repo
40
Repo updated
First seen
Licence
Custom licence

At a glance

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

  • Works in 2 steps: Inline array -- pass evaluator objects… → selectEvaluators -- typed wrapper that…
  • Authoring new eval specs
  • SKILL.md covers Spec File Anatomy, Tags, Datasets and Tasks, plus 7 more sections
  • Calls node

What it does

Evals Write Spec is an agent skill from elastic/kibana, published by the product's own GitHub organization. Write LLM evaluation spec files with datasets, tasks, and evaluators using the @kbn/evals Playwright fixture. Use when authoring new eval specs, adding datasets or evaluators, or debugging evaluation test failures.

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/evaluator-patterns.md`).

It sits in AI & LLM Engineering, covering LLM evaluation. It works with Playwright. The repository describes itself as: Your window into all of your data.

When your agent uses it

  • Authoring new eval specs
  • Adding datasets
  • Debugging evaluation test failures

Example prompts

  • “/evals-write-spec”

Workflow steps

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

  1. Inline array -- pass evaluator objects directly (simple suites)
  2. selectEvaluators -- typed wrapper that enforces Example/TaskOutput generics

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:

    • node

    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

Evals Write Spec loads about 2.3k tokens when it runs, and up to ~4.4k if it reads all its reference files. Until then it costs about 58 tokens; SKILL.md has 575 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.4k

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 575 words (~2,342 tokens).

“Eval specs use the evaluate Playwright fixture (not test). A spec file follows this structure:”

— opening of SKILL.md by elastic, Custom licence
name
evals-write-spec
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files (references) in .agents/skills/evals-write-spec of elastic/kibana.

  • SKILL.md
  • agents/openai.yaml
  • references/evaluator-patterns.md

Open the folder on GitHubat commit ee7c86b

Compare with similar skills

Evals Write Spec 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.

Evals Write Spec compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Evals Write Spec this skillelastic/kibana21k—~2.3kAutomated safety check: PassCustom licence
Phoenix Pxi PlaywrightArize-ai/phoenix12k—~2.6kAutomated safety check: PassCustom licence
Eval Loopjacob-dietle/context-os111—~5.2kAutomated safety check: PassMIT
LLM Benchmarking with lm-evaluation-harnessOrchestra-Research/AI-Research-SKILLs13k8 repos~3kAutomated safety check: PassMIT
Azure AI Projects Python SDKmicrosoft/skills3.1k6 repos~2.8kAutomated safety check: PassMIT
Fine-Tuning ExpertJeffallan/claude-skills12k1 repos~1.7kAutomated safety check: PassMIT

Similar skills

  • Phoenix Pxi Playwright

    Arize-ai/phoenix

    Write, extend, and debug PXI Playwright E2E tests for Phoenix.

    12k GitHub stars~2.6k tokensUpdated today
    Testing & QAAuto-check passed
  • Eval Loop

    jacob-dietle/context-os

    This skill should be used when a specific quality problem (UX, data, architecture, feature) needs systematic diagnosis and iterative fixing toward a defined target.

    111 GitHub stars~5.2k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • LLM Benchmarking with lm-evaluation-harness

    Orchestra-Research/AI-Research-SKILLs

    Runs lm-evaluation-harness to benchmark language models on academic suites such as MMLU, GSM8K and HumanEval, compare models and track training checkpoints.

    13k GitHub starsUsed in 8 repos~3k tokens
    AI & LLM EngineeringAuto-check passed
  • Official

    Reference for building on Microsoft Foundry with the azure-ai-projects Python SDK: project clients, versioned agents, evaluations, connections, datasets and indexes.

    3.1k GitHub starsUsed in 6 repos~2.8k tokens
    AI & LLM EngineeringAuto-check passed
  • Fine-Tuning Expert

    Jeffallan/claude-skills

    Guides LLM fine-tuning with LoRA and QLoRA through Hugging Face PEFT, from dataset validation and training checks to adapter merging, quantization and deployment.

    12k GitHub starsUsed in 1 repo~1.7k tokens
    AI & LLM EngineeringAuto-check passed
  • Looper

    ksimback/looper

    Scaffold a well-designed agent loop with best-practice coaching and a cross-model review council.

    710 GitHub stars~2.7k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check: notes

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
  • 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
  • Official

    Implement and review Kibana feature privilege deprecations. An agent skill from elastic/kibana.

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

Works with

Questions about Evals Write Spec

What does Evals Write Spec do?

Write LLM evaluation spec files with datasets, tasks, and evaluators using the @kbn/evals Playwright fixture. Evals Write Spec is an agent skill from elastic/kibana, published by the product's own GitHub organization. Write LLM evaluation spec files with datasets, tasks, and evaluators using the @kbn/evals Playwright fixture.

When should I use Evals Write Spec?

Evals Write Spec fits situations like: authoring new eval specs; adding datasets; debugging evaluation test failures.

How do I install Evals Write Spec in Claude Code?

Run `npx skills add elastic/kibana --skill evals-write-spec -a claude-code`. Or copy the skill folder (.agents/skills/evals-write-spec in elastic/kibana) into .claude/skills/evals-write-spec in your project. Claude Code loads it when a task matches its description.

How do I install Evals Write Spec in Codex?

Run `npx skills add elastic/kibana --skill evals-write-spec -a codex`. Or copy the skill folder (.agents/skills/evals-write-spec in elastic/kibana) into .agents/skills/evals-write-spec in your project. Codex loads it when a task matches its description.

Can I use Evals Write Spec 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 evals-write-spec -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/evals-write-spec, .gemini/skills/evals-write-spec, .github/skills/evals-write-spec and .opencode/skills/evals-write-spec in your project.

What does Evals Write Spec need to run?

Going by SKILL.md and its folder, Evals Write Spec needs the command-line tools its instructions call (node).

Does Evals Write Spec 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 Evals Write Spec 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 Evals Write Spec use?

Evals Write Spec 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 Evals Write Spec use?

About 2.3k tokens (SKILL.md is roughly 9.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to Evals Write Spec?

Skills that share tags, products or a category with Evals Write Spec: Phoenix Pxi Playwright (Arize-ai/phoenix, 12k stars), Eval Loop (jacob-dietle/context-os, 111 stars), LLM Benchmarking with lm-evaluation-harness (Orchestra-Research/AI-Research-SKILLs, 13k stars) and Azure AI Projects Python SDK (microsoft/skills, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Evals Write Spec?

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.