What problem does it solve?
It removes the guesswork and repetitive effort of turning Jira tickets or issue context into style-compliant AsciiDoc documentation that is ready for merge review.
Core Features & Use Cases
- Requirement gathering: Collects the “why” and “what” from Jira, GitHub issues, or provided text and pulls linked implementation context.
- Structure-first drafting: Plans the exact documentation placement before writing, then produces Red Hat/AsciiDoc-convention-compliant AsciiDoc.
- Quality gates and publishing: Runs Vale (and optionally AsciiDoctor) for validation, applies changes to the repo workspace, and prepares a merge request.
Use case: You need to add or update an AsciiDoc topic in the Edge Manager docs based on a Jira change request, while ensuring Vale style compliance before creating the MR.
Quick Start
Run the docs-writer skill with your Jira ticket URL so it gathers context, plans placement, drafts AsciiDoc, validates with Vale, applies changes, and prepares a GitLab merge request.
