← Explore all skills

K6 DOCUMENTATION / Grafana Labs

k6 documentation

Pins Grafana's k6 documentation skill, which requires a confirmation before any git push and a clean k6 master run before commit.

“Write or review k6 documentation across the three k6 repositories - k6-DefinitelyTyped (TypeScript types), k6-docs (user documentation), and k6 (release notes / changelog). …”

01 / THE REASONING

Why this made the selection.

  • No selected skills record uses this source path.
  • The file forbids an automatic git push and says to ask first, and it forbids committing an example that does not run cleanly against current k6 master.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • skills/grafana-k6/k6-docs/SKILL.md
  • README.md
  • LICENSE

Our findings

  • The file forbids an automatic git push and says to ask first.
  • It forbids chaining commands with && or a semicolon, and its validation example shows separate commands.
  • It says every documentation and release-note example must run against k6 master before committing.
  • It says not to commit a change whose example does not run cleanly against current master.
  • The validation loop checks out master and pulls in the k6 repository before that run. The file also forbids an AI co-author trailer on commits.
  • The critical rules restrict documentation to user-facing features and distinguish TypeScript types, user documentation and release notes across their repositories.

Not established by this review

  • The resource was not executed.
  • git checkout, git pull, go run, and k6 were not run. Nothing was committed or pushed.
  • references/workflows/write.md, references/workflows/review.md, and references/testing-workflow.md were not opened.
  • Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗

DOCUMENTED COMMAND

claude plugin install grafana-k6@grafana-skills

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. The README Claude Code section shows claude plugin marketplace add grafana/skills and then claude plugin install grafana-k6@grafana-skills.
  2. That install line installs the grafana-k6 plugin group. This file is skills/grafana-k6/k6-docs/SKILL.md.
  3. The same README also shows npx skills add grafana/skills, which installs from the repository and can include more than this file.
  4. This review did not run either install.

Before you start

  • Claude Code if the plugin command is used
  • A local k6 checkout, git, and a Go toolchain if the file's validation loop is followed, which this review did not run

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. k6-docs SKILL.md ↗Checked

    https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-k6/k6-docs/SKILL.md

    Supports: ask before push, no command chaining, and no commit of a failing example

  2. Repository README ↗Checked

    https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md

    Supports: grafana-k6 plugin install line and Apache-2.0 statement

  3. Repository LICENSE ↗Checked

    https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE

    Supports: Apache License, Version 2.0, Copyright 2026 Grafana Labs

  4. https://raw.githubusercontent.com/grafana/skills/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-k6/k6-docs/SKILL.md

    Supports: review.findings, bestFor, upstreamDescription

Evidence & Ask