Skip to content

Add grove-user-guide AI agent skill for authoring user documentation #588

@shmuel-runai

Description

@shmuel-runai

What you would like to be added?

Add a /grove-user-guide agent skill under .agents/skills/grove-user-guide/ that guides AI coding agents through writing or updating Grove user guides in docs/user-guide/.

The skill includes:

  • SKILL.md — an interactive dialogue flow that walks section by section (overview, prerequisites, enabling, how it works, usage examples, observability, scaling, limitations, etc.)
  • style-reference.md — Grove-specific formatting rules, terminology conventions, and YAML example guidelines aligned with the Kubernetes documentation style guide

Why is this needed?

Documentation quality currently depends on the author knowing Grove conventions — API object casing (PascalCase), annotation formatting, YAML example standards, and section ordering. This skill encodes those conventions into a repeatable, interactive workflow for AI agents (Cursor, Claude Code, Copilot, etc.), ensuring consistent structure and style across all user-facing guides.

Similar to the existing /grove-grep skill (#522) which standardized GREP authoring.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No fields configured for Task.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions