docs

Automate writing and refreshing Diataxis project documentation in place.

1|Updated Apr 18, 2026

Search Tags:#workflow #documentation #reference #docs #diataxis #host-interaction

Ready to run

npx skills add https://github.com/mopeyjellyfish/flywheel --skill docs-mopeyjellyfish

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: docs
Source: https://github.com/mopeyjellyfish/flywheel/tree/main/skills/docs
Command: npx skills add https://github.com/mopeyjellyfish/flywheel --skill docs-mopeyjellyfish

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Maintains consistent, high-quality docs across Diataxis surfaces by automating documentation passes and ensuring alignment with repo truth.

Core Features & Use Cases

Classification of content into tutorial, how-to, reference, and explanation using the Diataxis map.
Host interaction contract guided task tracking and scoped changes.
Phase-based workflow that loads only needed references and updates in place.

Quick Start

Invoke the docs workflow with $fw:docs to start a targeted Diataxis pass and update the repository.

Frequently Asked Questions about docs

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

FAQPage Schema

How do I automate project documentation updates using Diataxis?▼

Automating project documentation updates involves invoking a targeted workflow that classifies content into Diataxis surfaces and applies scoped changes to repository docs in place.

What is the Diataxis framework for technical documentation?▼

The Diataxis framework is a documentation structure that classifies content into four distinct surfaces: tutorials, how-to guides, reference materials, and explanations, ensuring docs align with repository truth.

How do I write API reference and CLI docs that stay aligned with repository changes?▼

Writing API reference and CLI docs that stay aligned requires a phase-based workflow that loads only needed references and updates documentation in place after configuration changes or setup flow modifications.

Do I need YAML frontmatter in SKILL.md to refresh project docs?▼

Yes, refreshing project docs relies on YAML frontmatter presence in SKILL.md to establish host interaction contracts and guide the phase-based workflow for scoped documentation updates.

What's the best way to classify documentation into tutorials, how-tos, and references?▼

The best way to classify documentation into tutorials, how-tos, and references is using the Diataxis map, which categorizes content by purpose and applies a phase-based workflow to update docs in place.

Can I update setup flow documentation without rewriting the entire repository?▼

Yes, you can update setup flow documentation without rewriting the entire repository by using a phase-based workflow that loads only needed references and applies scoped changes to existing docs in place.