docs

Review Markdown documentation structure and enforce frontmatter usage.

Updated Jan 14, 2026
One-click install
npx skills add https://github.com/oornnery/skills --skill docs-oornnery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs
Source: https://github.com/oornnery/skills/tree/main/skills/docs
Command: npx skills add https://github.com/oornnery/skills --skill docs-oornnery

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Documentation skill helps teams craft clear, consistent, and high-quality project documentation for READMEs, ADRs, changelogs, and general Markdown guidelines.

Core Features & Use Cases

  • Enforces structured documentation patterns for READMEs, ADRs, and changelogs.
  • Provides standardized Markdown structure guidance, including headers, lists, and diagrams.
  • Supports a documentation workflow with reviews, versioning notes, and practical samples.

Quick Start

Run rumdl after editing Markdown-heavy content to ensure structure and readability.

Frequently Asked Questions about docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce consistent Markdown structure across project documentation?

To enforce consistent Markdown structure, this Skill reviews headers, lists, and diagrams while enforcing documented frontmatter usage and structured sections. It ensures standardized Markdown patterns for READMEs, ADRs, and changelogs.

What is the best way to write an Architecture Decision Record for a software project?

Writing an Architecture Decision Record (ADR) is best handled by enforcing structured documentation patterns. This Skill provides standardized Markdown structure guidance to ensure ADRs and other project documents remain clear and consistent.

How do I structure a README with practical quick-start examples?

To structure a README with practical quick-start examples, this Skill enforces documented frontmatter usage and structured sections. It provides standardized Markdown guidance to improve README quality and consistency across software projects.

Can I use this documentation skill to review an existing changelog?

Yes, you can use this documentation skill to review an existing changelog. It supports a documentation workflow with reviews and versioning notes, enforcing structured documentation patterns specifically for changelogs and Markdown content.

Does the rumdl tool check Markdown readability and frontmatter compliance?

Yes, running rumdl checks Markdown readability and frontmatter compliance after editing content. It ensures structure and readability across project documentation by enforcing documented frontmatter usage and practical quick-start examples.

What are the limitations of using a style-guide for project documentation?

A limitation of using a style-guide for documentation is that it focuses strictly on Markdown structure, frontmatter, and sectioning. It does not generate content from scratch, meaning teams must provide the initial text for READMEs, ADRs, and changelogs.