Official agent skill

Validate Oas

by elastic in elastic/kibana

A skill your agent uses when you need a quick VALID or NOT VALID result for a scoped Kibana OAS area, and first ensure the generated oasdocs inputs are up to date so validation runs against the…

OfficialCustom licenceAuto-check passed

Install Validate Oas

skills CLI
$ npx skills add elastic/kibana --skill validate-oas -a claude-code

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

GitHub CLI
$ gh skill install elastic/kibana validate-oas --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/validate-oas .claude/skills/validate-oas && 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
validate-oas
GitHub stars
21k
Token cost
~1.7k tokens
SKILL.md length
635 words
Files
2
Skills in repo
40
Repo updated
First seen
Licence
Custom licence

At a glance

A skill your agent uses when you need a quick VALID or NOT VALID result for a scoped Kibana OAS area, and first ensure the generated oasdocs inputs are up to date so validation runs against the…

  • Works in 2 steps: Bootstrap dependencies if needed → Regenerate captured OAS snapshots. Read…
  • You need a quick VALID
  • SKILL.md covers Overview, Environment setup, Required interaction flow and Path format, plus 3 more sections
  • Calls bash, node and make

What it does

Validate Oas is an agent skill from elastic/kibana, published by the product's own GitHub organization. Use when you need a quick VALID or NOT VALID result for a scoped Kibana OAS area, and first ensure the generated oasdocs inputs are up to date so validation runs against the current environment rather than stale snapshots.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It works with Elasticsearch. The repository describes itself as: Your window into all of your data.

When your agent uses it

  • You need a quick VALID
  • NOT VALID result for a scoped Kibana OAS area
  • First ensure the generated oasdocs inputs are up to date so validation runs against the current environment rather than stale snapshots

Example prompts

  • “/validate-oas”

Workflow steps

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

  1. Bootstrap dependencies if needed
  2. Regenerate captured OAS snapshots. Read the include paths from the Buildkite step

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:

    • bash
    • node
    • make
    • pnpm

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

  • Network

    No URLs in SKILL.md. Its commands use pnpm, which can reach the network depending on how they are called.

    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

Validate Oas loads about 1.7k tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 635 words of instructions outside code blocks.

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

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 635 words (~1,748 tokens).

“Use node ./scripts/validate_oas_docs.js for a fast pass/fail check of a specific API area.”

— opening of SKILL.md by elastic, Custom licence
name
validate-oas
user-invocable
true
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .agents/skills/validate-oas of elastic/kibana.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit ee7c86b

Compare with similar skills

Validate Oas 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.

Validate Oas compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Validate Oas this skillelastic/kibana21k—~1.7kAutomated safety check: PassCustom licence
Security Case Managementelastic/agent-skills5921 repos~2.6kAutomated safety check: NotesApache-2.0
Ecs Rfc Guideelastic/ecs1.1k—~1.2kAutomated safety check: PassApache-2.0
evlog Adapter Creatorevloghq/evlog1.9k—~2.9kAutomated safety check: PassMIT
Product Full-Text Searchlobehub/lobehub83k—~4.1kAutomated safety check: PassCustom licence
Security Detection Rule Managementelastic/agent-skills5921 repos~3.9kAutomated safety check: NotesApache-2.0

Similar skills

  • Security Case Management

    elastic/agent-skills

    Official

    Create, search, update, and manage SOC cases via the Kibana Cases API.

    592 GitHub starsUsed in 1 repo~2.6k tokens
    Backend & APIsAuto-check: notes
  • Ecs Rfc Guide

    elastic/ecs

    Official

    Guides contributors through the Elastic Common Schema (ECS) RFC (Proposal) process: template sections, target maturity (alpha/beta), rfcs/text artifacts, and optional OTel mapping.

    1.1k GitHub stars~1.2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Walks through adding a new built-in evlog drain adapter for an observability platform: source, build config, exports, tests, docs and PR scope.

    1.9k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Guides work on LobeHub's own product search: the shared search repository, provider choice, Elasticsearch mappings, change syncing and reindexing.

    83k GitHub stars~4.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Official

    Create, tune, and manage Elastic Security detection rules (SIEM and Endpoint).

    592 GitHub starsUsed in 1 repo~3.9k tokens
    SecurityAuto-check: notes
  • UModel Root Cause Analysis

    alibaba/UnifiedModel

    Investigates a service incident to its root cause by querying a UModel object graph alongside metrics, logs, topology and recent deployments.

    412 GitHub stars~1.9k tokensUpdated 14 days ago
    DevOps & CloudAuto-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

Works with

Questions about Validate Oas

What does Validate Oas do?

A skill your agent uses when you need a quick VALID or NOT VALID result for a scoped Kibana OAS area, and first ensure the generated oasdocs inputs are up to date so validation runs against the…. Validate Oas is an agent skill from elastic/kibana, published by the product's own GitHub organization. Use when you need a quick VALID or NOT VALID result for a scoped Kibana OAS area, and first ensure the generated oasdocs inputs are up to date so validation runs against the current environment rather than stale snapshots.

When should I use Validate Oas?

Validate Oas fits situations like: you need a quick VALID; NOT VALID result for a scoped Kibana OAS area; first ensure the generated oasdocs inputs are up to date so validation runs against the current environment rather than stale snapshots.

How do I install Validate Oas in Claude Code?

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

How do I install Validate Oas in Codex?

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

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

What does Validate Oas need to run?

Going by SKILL.md and its folder, Validate Oas needs the command-line tools its instructions call (bash, node, make and pnpm).

Does Validate Oas 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 Validate Oas 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 Validate Oas use?

Validate Oas 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 Validate Oas use?

About 1.7k tokens (SKILL.md is roughly 7k 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 Validate Oas?

Skills that share tags, products or a category with Validate Oas: Security Case Management (elastic/agent-skills, 592 stars), Ecs Rfc Guide (elastic/ecs, 1.1k stars), evlog Adapter Creator (evloghq/evlog, 1.9k stars) and Product Full-Text Search (lobehub/lobehub, 83k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Validate Oas?

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.