k6-docs

This skill helps contributors write and review k6 documentation across three repositories: k6-DefinitelyTyped (TypeScript type definitions), k6-docs (user-facing documentation), and k6 (release notes and changelog). It solves the problem of keeping k6 documentation consistent, accurate, and verifiably correct by codifying the project's style conventions, generating TypeScript type definitions, drafting release notes, and validating every code example by running it against k6@master.

The skill routes work through write and review workflows and provides extensive reference material: repository structure and feature-type identification, TypeScript patterns and troubleshooting, a testing workflow using parallel subagents, an agent-browser command reference for visual verification, and checklists for documentation, release notes, and TypeScript. It enforces critical rules such as never pushing automatically, never chaining shell commands with && or semicolons, documenting only user-facing features, using 1. for every numbered list item, and testing every example against the latest master before committing. Helper scripts cover link validation, TypeScript formatting and testing, PR fetching, branch finding, and team-member updates, and the documentation checklist includes a link-validation procedure using curl against a local docs server and screenshot-based visual verification.

It is aimed at k6 maintainers and technical writers documenting load-testing features, API references, and changelogs. The shell operations it describes are development-workflow tasks (running examples with go run, git checkout/pull, curl for HTTP status checks against a local server, screenshotting) that are standard and read-oriented rather than destructive.