holydocs-writing

Generate documentation pages using Diataxis classification and style guidelines.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/seangeng/holydocs-skills --skill holydocs-writing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: holydocs-writing
Source: https://github.com/seangeng/holydocs-skills/tree/main/holydocs-writing
Command: npx skills add https://github.com/seangeng/holydocs-skills --skill holydocs-writing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams craft clear, scannable HolyDocs content that consistently follows the Diataxis model and the project's style guide, reducing ambiguity and rewriting effort.

Core Features & Use Cases

  • Guided writing framework: Enforces Diataxis classification and tone rules during drafting across tutorials, how-tos, references, and explanations.
  • Template-driven content creation: Provides reusable page skeletons, frontmatter defaults, and components that ensure consistency across docs.
  • Quality-forward templates & real-world use: Delivers ready-to-paste page templates aligned with style-guide patterns for common product docs.
  • Use Case: Create a feature overview page that follows the recommended structure and tone for fast onboarding.

Quick Start

Create a new documentation page using the writing patterns and your project’s style guide.

Frequently Asked Questions about holydocs-writing

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

FAQPage Schema
How do I write documentation that follows the Diataxis framework?

Diataxis documentation classifies content into tutorials, how-tos, references, and explanations, then applies style guidelines and page templates to ensure clear, scannable text that reduces ambiguity and rewriting effort.

What is the best way to create consistent markdown documentation templates?

Creating consistent markdown templates involves using reusable page skeletons with predefined frontmatter defaults and components, ensuring structural uniformity across all product documents.

How do I generate ready-to-paste documentation pages from a style guide?

To generate ready-to-paste documentation pages, use AI prompts that apply your project's style guide patterns, automatically enforcing tone rules and Diataxis classification during the drafting process.

Can I use Diataxis classification for technical references and how-to guides?

Diataxis classification fully supports technical references and how-to guides by enforcing specific tone rules and structural templates for each type, improving overall documentation quality.

How do I structure a feature overview page for fast user onboarding?

Structuring a feature overview page for fast onboarding involves applying recommended Diataxis explanation patterns and tone rules, using reusable templates that deliver clear, scannable content.