Official agent skill

Fix Package Docs

by elastic in elastic/kibana

Fix API documentation issues in a Kibana plugin or package. An agent skill from elastic/kibana.

OfficialCustom licenceAuto-check passedDevelopment

Install Fix Package Docs

skills CLI
$ npx skills add elastic/kibana --skill fix-package-docs -a claude-code

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

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

At a glance

Fix API documentation issues in a Kibana plugin or package. An agent skill from elastic/kibana.

  • Works in 7 steps: Resolve the target → Generate the stats file → Read and plan → …
  • Add JSDoc/API documentation for a Kibana plugin
  • SKILL.md covers Non-negotiable conventions, Workflow and Example: full run on the…
  • Calls node

What it does

Fix Package Docs is an agent skill from elastic/kibana, published by the product's own GitHub organization. Fix API documentation issues in a Kibana plugin or package. Use when asked to fix, improve, or add JSDoc/API documentation for a Kibana plugin or package, or when checkpackagedocs validation fails.

Its SKILL.md is about 2.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 sits in Development, covering Technical documentation. It works with Elasticsearch. The repository describes itself as: Your window into all of your data.

When your agent uses it

  • Add JSDoc/API documentation for a Kibana plugin
  • Checkpackagedocs validation fails

Example prompts

  • “/fix-package-docs”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Resolve the target
  2. Generate the stats file
  3. Read and plan
  4. Fix issues file by file
  5. After each file, verify locally (optional)
  6. Final verification
  7. PR notes

What it can do on your machine

Read from SKILL.md and the folder at commit 452e025. 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

Fix Package Docs loads about 2.7k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 809 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~2.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 809 words (~2,702 tokens).

“Systematically find and fix all actionable API documentation issues in a Kibana plugin or package using check_package_docs.”

— opening of SKILL.md by elastic, Custom licence
name
fix-package-docs
disable-model-invocation
true

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .agents/skills/fix-package-docs of elastic/kibana.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 452e025

Compare with similar skills

Fix Package Docs 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.

Fix Package Docs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fix Package Docs this skillelastic/kibana21k—~2.7kAutomated safety check: PassCustom licence
New Entity Requirementselastic/terraform-provider-elasticstack210—~1.9kAutomated safety check: PassApache-2.0
Diagram Designcathrynlavery/diagram-design47k1 repos~7.5kAutomated safety check: PassMIT
Simple Englishmoeru-ai/airi50k2 repos~4.6kAutomated safety check: PassMIT
Doc SyncJetBrains/ideavim10k2 repos~2.6kAutomated safety check: PassMIT
Mailspring App ScreenshotsFoundry376/Mailspring18k—~1.5kAutomated safety check: PassGPL-3.0

Similar skills

  • New Entity Requirements

    elastic/terraform-provider-elasticstack

    Official

    Gathers initial requirements for a new Terraform resource or data source by examining API clients (go-elasticsearch, generated kbapi), Elastic API docs (Elastic docs MCP server and/or web), then…

    210 GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Diagram Design

    cathrynlavery/diagram-design

    Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.

    47k GitHub starsUsed in 1 repo~7.5k tokens
    DevelopmentAuto-check passed
  • Simple English

    moeru-ai/airi

    Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.

    50k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed
  • Doc Sync

    JetBrains/ideavim

    Official

    Keeps IdeaVim documentation in sync with code changes. An agent skill from JetBrains/ideavim.

    10k GitHub starsUsed in 2 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Mailspring App Screenshots

    Foundry376/Mailspring

    Captures screenshots of the running Mailspring dev app for docs, PRs or visual checks by launching it with a debugging port, driving the UI and clipping to an element.

    18k GitHub stars~1.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Draw.io Diagram Studio

    Agents365-ai/drawio-skill

    Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.

    10k GitHub stars~2.4k tokensUpdated 6 days ago
    DevelopmentAuto-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
  • 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

Categories

Questions about Fix Package Docs

What does Fix Package Docs do?

Fix API documentation issues in a Kibana plugin or package. An agent skill from elastic/kibana. Fix Package Docs is an agent skill from elastic/kibana, published by the product's own GitHub organization. Fix API documentation issues in a Kibana plugin or package.

When should I use Fix Package Docs?

Fix Package Docs fits situations like: add JSDoc/API documentation for a Kibana plugin; checkpackagedocs validation fails.

How do I install Fix Package Docs in Claude Code?

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

How do I install Fix Package Docs in Codex?

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

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

What does Fix Package Docs need to run?

Going by SKILL.md and its folder, Fix Package Docs needs the command-line tools its instructions call (node).

Does Fix Package Docs 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 Fix Package Docs 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 Fix Package Docs use?

Fix Package Docs 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 Fix Package Docs use?

About 2.7k tokens (SKILL.md is roughly 11k 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 Fix Package Docs?

Skills that share tags, products or a category with Fix Package Docs: New Entity Requirements (elastic/terraform-provider-elasticstack, 210 stars), Diagram Design (cathrynlavery/diagram-design, 47k stars), Simple English (moeru-ai/airi, 50k stars) and Doc Sync (JetBrains/ideavim, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fix Package Docs?

elastic (a GitHub organization, an official publisher) maintains it in elastic/kibana, which has 21,307 GitHub stars. The repository holds 40 skills in this directory. The repository was last updated on October 9, 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.