docs-team

Organize technical documentation into Diátaxis quadrants with consistent structure and style.

6|1|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/kouko/monkey-skills --skill docs-team
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-team
Source: https://github.com/kouko/monkey-skills/tree/main/domain-teams/skills/docs-team
Command: npx skills add https://github.com/kouko/monkey-skills --skill docs-team

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation often drifts across projects, quadrants, and teams. The Docs Team skill establishes a Diátaxis-aligned, style-consistent approach to creating tutorials, how-to guides, references, explanations, READMEs, ADRs, and API docs, ensuring clear ownership and governance.

Core Features & Use Cases

  • Diátaxis quadrant discipline to separate Tutorial, How-to, Reference, and Explanation content, reducing mode mixing.
  • Docs-as-Code governance: frontmatter metadata, style conformance, freshness, ADR structure, API reference standards.
  • Use cases include writing READMEs, API references, architecture decisions, codebase and documentation health audits, and cross-team documentation projects.

Quick Start

Write a frontmatter-guided doc task by declaring the mode and owner, then route the request through the doc-writing router.

Frequently Asked Questions about docs-team

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

FAQPage Schema
How do I organize technical documentation using the Diátaxis framework?

The Diátaxis framework structures technical documentation into four quadrants: tutorials, how-to guides, references, and explanations. Separating content by user intent reduces mode mixing and ensures each doc type maintains a consistent structure and style.

What's the best way to enforce docs-as-code governance for READMEs and API references?

Enforcing docs-as-code governance requires applying frontmatter metadata, style conformance checks, and freshness tracking across READMEs and API references. Treating documentation with the same rigor as source code pipelines ensures clear ownership and maintainability.

How do I write an Architecture Decision Record that stays consistent across teams?

Writing a consistent Architecture Decision Record requires enforcing a standardized ADR structure with frontmatter metadata. Applying docs-as-code principles ensures architecture decisions remain clear, governed, and maintainable across cross-team projects.

Does this approach support separating API reference standards from tutorial content?

Yes, the Diátaxis quadrant discipline explicitly separates API reference standards from tutorial content. This prevents mode mixing by keeping strict reference documentation distinct from learning-oriented tutorials, ensuring both maintain their specific structural rules.

Why does my documentation drift across different projects and quadrants?

Documentation drifts across projects when there is no consistent structural alignment or governance. Without enforcing frontmatter metadata, style conformance, and Diátaxis quadrant discipline, different teams naturally diverge in how they write and maintain their docs.

Can I run a codebase documentation health audit to check style conformance?

Yes, you can run a codebase and documentation health audit to check style conformance and freshness. This process validates frontmatter metadata, verifies API reference standards, and ensures all content correctly aligns with its intended Diátaxis quadrant.