docs

Organize documentation using the Divio four-type system of tutorials, how-to guides, reference, and explanation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Documentation often fails because a single page tries to be a tutorial, a reference, and an explanation at once, serving no reader well. This Skill applies the Divio documentation system to classify every page into one of four distinct types so each reader's need is met by the right kind of writing. ## Core Features & Use Cases - Four-Type Classification: Distinguishes tutorials, how-to guides, reference, and explanation using the 2x2 framework of action vs. cognition and study vs. work. - Mixed-Type Detection: Identifies symptoms of pages that blend types, such as how-to guides buried in background theory or reference pages written as prose narrative. - Site Structure Guidance: Provides a docs/ directory layout (tutorials/, how-to/, reference/, concepts/) so readers in one mode can navigate without leaving it. - Use Case: When planning a new docs site or reviewing an existing page that feels unfocused, use this Skill to decide which quadrant the content belongs in and split merged pages accordingly. ## Quick Start Review my documentation page and tell me which Divio quadrant it belongs in and whether it mixes types it should not.

Frequently Asked Questions about docs

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

FAQPage Schema
How do I structure a documentation site with the Divio system?▼

Divide content into four directories: tutorials/ for guided lessons, how-to/ for task recipes, reference/ for factual lookup, and concepts/ for explanation. Each page serves exactly one of the four types so readers in one mode never have to leave it.

What is the difference between a tutorial and a how-to guide?▼

A tutorial is a learning-oriented lesson that takes a beginner by the hand through every step. A how-to guide is goal-oriented, assumes competence, and gives a recipe for one specific task without explaining why.

How do I tell which Divio quadrant a page belongs in?▼

Ask two questions about the reader: are they doing something or trying to understand something, and are they learning or pursuing a known goal. The two answers together pick exactly one of the four quadrants.

Why does my documentation page feel unfocused?▼

It likely mixes types, such as a how-to guide that opens with background theory or a reference page written as prose narrative. Split the content so each page serves a single reader need, and link between pages instead of merging them.

When should I not split a page into separate Divio types?▼

The separation applies at the page level, not the site level. A short tutorial can link out to reference and explanation pages right after its quick start, as long as the tutorial itself stays focused and the deeper material lives on its own pages.