--- title: "k6 test maintenance: review, setup & limitations · Undominated.ai" canonical: https://undominated.ai/skills/grafana-k6-test-maintenance/ description: "Treats a k6 edit as behaviour-aware change control, with a validation loop on every edit." --- # k6 test maintenance: review, setup & limitations · Undominated.ai > Treats a k6 edit as behaviour-aware change control, with a validation loop on every edit. [← Explore all skills](/skills/) TESTING AND RELIABILITY / Grafana Labs # k6 test maintenance Treats a k6 edit as behaviour-aware change control, with a validation loop on every edit. [See setup guidance ↓](#setup)[Original source ↗](https://github.com/grafana/skills/tree/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-k6/k6-test-maintenance) SOURCE REVIEW Reviewed 2026-10-15 Evidence 5 linked sources Publisher Grafana Labs Licence [Apache-2.0 ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE) Revision 1ccacf29049f [Read what was—and wasn’t—checked ↓](#review) “Maintain and improve existing k6 test scripts. Covers threshold tightening based on trend data, version migration between k6 releases, auto-fixing tests when the underlying service changes, refactoring for cleanliness, and auditing scripts against current best practices from docs. Use when the user asks to fix a failing k6 test, tighten thresholds, migrate a script to a new k6 version, refactor a test, update a script after a service change, or improve a script with best practices. Trigger on phrases like "fix my k6 test", "tighten my thresholds", "migrate to k6 v2", "update my test script", "refactor this k6 test", "my test is failing after a deploy", "apply best practices to my script", "modernize my k6 test", or "the service changed and my test broke". Also trigger when another skill (k6-trend-analysis or k6-cloud-investigate-test) hands off with a recommendation to edit a script.” [Grafana Labs · upstream description ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-k6/k6-test-maintenance/SKILL.md) Our analysis follows below. 01 / THE REASONING ## Why this made the selection. - The core-principle heading is behaviour-aware change control. - A validation loop is required on every edit, not only at the end. ### A good fit for - Fixing a k6 script that stopped testing the service - Tightening thresholds from trend data you already have - Choose verification depth based on whether a change alters runtime logic or only declarative thresholds - Check documentation version alignment before proposing a k6 API migration. ### Weigh up before choosing - Maintaining a script does not create a load measurement. - No k6 run was executed in this review. - Historical threshold predictions do not substitute for runtime verification when requests, helpers, scenarios or assertions change. A metric with no observations can make a threshold misleading. 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-test-maintenance/SKILL.md - README.md - LICENSE - skills/grafana-k6/k6-test-maintenance/references/verification.md ### Our findings - Headings include Validation loop (every edit). - The description covers version migration and threshold tightening. - The definition separates configuration-only historical prediction from runtime-logic verification and documents GET-backup-edit-validate-PUT-hash checks. - The definition permits k6 inspect for parse-only validation without a browser, or mcp-k6 validate_script; browser runtime behavior still needs a browser-backed smoke or cloud run. - The migration guidance warns that k6 x docs reflects the installed runtime and may lag the API of the migration target. ### Not established by this review - The skill was not executed inside a host agent. - 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 ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md) DOCUMENTED COMMAND npx skills add grafana/skills/skills/grafana-k6/k6-test-maintenance --skill k6-test-maintenance Copy command ↗ Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above. Optional: install the reviewed revision Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose. npx skills@1.7.1 add https://github.com/grafana/skills/tree/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-k6/k6-test-maintenance --skill k6-test-maintenance Copy reviewed-revision command ↗ - Choose your AI tools and project or global installation scope in Skills CLI. The review applies to the source revision shown on this page. - Retain all supporting files; separately configure companion skills, runtimes and service credentials named in the definition. - Review the resulting diff and use an isolated target before any migration, deployment, load test or warehouse operation. ### Before you start - k6 plus the complete skill references; k6-manage/gcx and a Grafana Cloud account for hosted script operations. ### Compatibility Agent Skills-compatible hosts · k6 ### Local Markdown instructions - Read the installed skill files - Read/write local or cloud-hosted scripts and run bounded target traffic; cloud edits need write credentials and backup/hash verification. ### Cost model Source is free to read under the stated licence. A host agent may charge for use. 04 / FOLLOW THE EVIDENCE ## The source trail. Our notes are separate from the original resource. Check upstream before adopting a new version. - [Skill definition ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-k6/k6-test-maintenance/SKILL.md) Checked 2026-10-14 https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-k6/k6-test-maintenance/SKILL.md Supports: Workflow and stated scope - [Repository licence ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE) Checked 2026-10-07 https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/LICENSE Supports: Redistribution terms - [Install instructions ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md) Checked 2026-10-07 https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/README.md Supports: Documented install path - [skills/grafana-k6/k6-test-maintenance/references/verification.md ↗](https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-k6/k6-test-maintenance/references/verification.md) Checked 2026-10-14 https://github.com/grafana/skills/blob/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-k6/k6-test-maintenance/references/verification.md Supports: review - [Pinned continuation review C2-W16 ↗](https://raw.githubusercontent.com/grafana/skills/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-k6/k6-test-maintenance/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/grafana/skills/1ccacf29049fde66637fe01ab93a83a772da323b/skills/grafana-k6/k6-test-maintenance/SKILL.md Supports: review.findings, bestFor KEEP COMPARING ## Other approaches to consider. Related by category or shared topics. These are alternatives to inspect, not a measured quality order. [### k6 ↗ Writes a k6 script from a matching example, then validates it by running it rather than by reading it.](/skills/grafana-k6/)[### Bug Receipt ↗ Creates an evidence-bearing defect or incident handoff that distinguishes verified, partial and blocked outcomes.](/skills/github-bug-receipt/)[### Diagnosing Bugs ↗ A debugging procedure that establishes a reproducible symptom, tests competing explanations and preserves a regression check.](/skills/mattpocock-diagnosing-bugs/) [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/) ## Continue your investigation - [Choose a toolkit](/tools/) - [Inspect execution hosts](/agents/) - [Check tool access](/mcp-servers/) - [Check project dependencies](/check-repo/)