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.
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.
- The README Claude Code section shows claude plugin marketplace add grafana/skills and then claude plugin install grafana-k6@grafana-skills.
- That install line installs the grafana-k6 plugin group. This file is skills/grafana-k6/k6-docs/SKILL.md.
- The same README also shows npx skills add grafana/skills, which installs from the repository and can include more than this file.
- 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.
- 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
- Repository README ↗Checked
https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md
Supports: grafana-k6 plugin install line and Apache-2.0 statement
- Repository LICENSE ↗Checked
https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE
Supports: Apache License, Version 2.0, Copyright 2026 Grafana Labs
https://raw.githubusercontent.com/grafana/skills/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-k6/k6-docs/SKILL.md
Supports: review.findings, bestFor, upstreamDescription