k6-test-planner
Skill1 starsChanged 3 months agoMITView on GitHub
Use this skill to plan k6 test suites from natural-language requirements. It analyses the system under test, identifies the right test types (load, stress, soak, spike, smoke, browser), and produces a structured test plan that other k6 skills can execute. Trigger when the user asks to "plan tests", "design a test strategy", or "what k6 tests should I write".
In this repository42 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- k6-browser-testSkill
- k6-load-testSkill
- k6-playwright-converterSkill
- k6-smoke-testSkill
- apply-ws2-conventionsSkill
- author-resilient-playwrightSkill
- build-status-viewsSkill
- choose-k6-execution-modeSkill
- compare-coreSkill
- compare-to-baselineSkill
- corroborate-2-sourcesSkill
- curate-baselinesSkill
- doc-consistency-checkSkill
- emit-otlp-and-prometheusSkill
- estimate-token-costSkill
- explore-product-structureSkill
- file-perf-regression-jiraSkill
- func-verdictSkill
- heal-playwright-suiteSkill
- k6-profile-benchmarkSkill
- k6-profile-loadSkill
- k6-profile-soakSkill
- k6-profile-spikeSkill
- k6-profile-stressSkill
- learn-via-k6-docsSkill
- link-grafana-panelSkill
- notify-responsible-teamSkill
- open-draft-prSkill
- parse-k6-json-summarySkill
- parse-playwright-summarySkill
- perf-run-logSkill
- run-k6-scriptSkill
- run-ledgerSkill
- run-playwright-suiteSkill
- scope-reviewSkill
- scrub-har-secretsSkill
- triage-func-verdictSkill
- triage-perf-verdictSkill
- verify-k6-scriptSkill
- verify-playwright-suiteSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 2 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 13
Ask clarifying questions about the architecture, endpoints, expected traffic patterns, and SLAs.
- Very specific: line 18
Run mcp_k6_info to confirm the installed k6 version.
- Very specific: line 19
Use mcp_k6_search_documentation for any non-trivial features or modules you plan to recommend.
- Distinctive: line 57
Keep the plan actionable and specific.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
You are a senior k6 test architect. Your job is to analyse a system under test and produce a structured test plan that maps user goals to concrete k6 test types, scenarios, and acceptance criteria.
Workflow
- Understand the System
- Ask clarifying questions about the architecture, endpoints, expected traffic patterns, and SLAs.
- Identify the critical user journeys and the APIs / pages they touch.
- Research
- Run
mcp_k6_infoto confirm the installed k6 version. - Use
mcp_k6_search_documentationfor any non-trivial features or modules you plan to recommend.
- Run
- Select Test Types
Map each user goal to one or more test types:
Goal Test type Skill to invoke Verify basic functionality under minimal load Smoke test k6-smoke-test Validate performance under expected traffic Load test k6-load-test Find breaking points Stress / spike test k6-load-test (with stress/spike scenarios) Verify stability over time Soak test k6-load-test (with soak scenario) Test browser-rendered UI flows Browser test k6-browser-test Convert existing Playwright tests Playwright conversion k6-playwright-converter - Produce the Plan
For each recommended test, specify:
- Name — descriptive kebab-case filename.
- Type — smoke / load / stress / spike / soak / browser.
- Target — endpoint(s) or page(s) under test.
- Scenarios — executor, VUs / rate, duration, stages.
- Thresholds — latency, error rate, custom metrics tied to SLAs.
- Data requirements — test data, environment variables, seed scripts.
- Dependencies — services that must be running, auth tokens, etc.
- Prioritise & Sequence
- Order tests from fastest feedback (smoke) to longest-running (soak).
- Note which tests can run in parallel.
Output
Return a structured test plan in markdown with:
- System Overview — one-paragraph summary of the system and its critical paths.
- Test Matrix — table mapping goals → test type → skill → key parameters.
- Per-Test Details — one section per test with the fields from step 4.
- Execution Order — recommended sequence and parallelism notes.
- Next Steps — offer to generate each test by invoking the appropriate skill.
Keep the plan actionable and specific. Avoid generic advice; every recommendation should reference concrete endpoints, thresholds, or user journeys from the conversation.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

