skills.rest
jayteealao
jayteealaoCOMMUNITY
Explore all skills by this author →
GitHub

diataxis:review

Analyze documentation for Diátaxis misalignment and produce prioritized fixes.

2|Updated Jan 12, 2026
Search Tags:#documentation#audit#review#diataxis#content-quality#docs-review
One-click install
npx skills add https://github.com/jayteealao/agent-skills --skill diataxis-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: diataxis:review
Source: https://github.com/jayteealao/agent-skills/tree/main/plugins/sdlc-workflow/skills/docs-reviewer
Command: npx skills add https://github.com/jayteealao/agent-skills --skill diataxis-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation often lacks alignment with the intended purpose and audience, leading to confusion and low adoption. The Diátaxis-based review helps teams identify type mismatches, boundary violations, and gaps, then prioritize concrete fixes.

Core Features & Use Cases

  • Diátaxis-aligned evaluation of pages to confirm appropriate type, audience, and structure.
  • Prioritized, actionable fixes for reorganization, splitting overloaded pages, or creating missing pages.
  • Outputs can feed a docs roadmap or sprint planning for the content team.

Quick Start

Provide the docs you want reviewed and I will run a Diátaxis-based audit and return prioritized fixes.

Frequently Asked Questions about diataxis:review

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

FAQPage Schema
How do I audit my documentation for Diátaxis alignment?▼

A Diátaxis documentation review analyzes your docs to identify type mismatches, audience misalignment, and structural gaps, producing concrete, prioritized fixes to guide content improvements.

Can I review an entire documentation set or just single pages?▼

You can review single pages, specific sections, or entire documentation sets across projects. The audit identifies overloaded pages and provides optional page-splitting recommendations for reorganization.

What is the best way to fix documentation with low adoption and confusion?▼

A Diátaxis-based review is an effective way to fix low adoption and confusion by evaluating pages for appropriate type, audience, and structure, then generating prioritized, actionable fixes.

Does a Diátaxis docs review provide actionable outputs for sprint planning?▼

Yes, a Diátaxis docs review produces prioritized, actionable fixes for reorganization, splitting overloaded pages, or creating missing pages. These outputs can directly feed a docs roadmap or sprint planning.

When should I request page-splitting recommendations during a docs audit?▼

Request page-splitting recommendations during a docs audit when the review identifies overloaded pages that violate Diátaxis boundaries by mixing multiple content types, audiences, or purposes.

Related Skills

Explore More Content & Communication Skills→
nashgaonashgao
3

doc-audit-existing

Audit existing documentation against Diátaxis framework best practices and generate reports.

Community
Advanced
Busboom-FooBusboom-Foo

plan-sprint

Plan sprint roadmaps and detailed artifacts with usecases, architecture updates, and tickets.

Official
Advanced
jayteealaojayteealao

every-style-editor

Review editorial content against Every's style guide for grammar and punctuation.

Community
Basic
cjohnhansoncjohnhanson

writing-docs-eval

Evaluate technical documentation using IBM DQTI, Diátaxis, and EPPO principles.

Community
Advanced