Does it support 'Document-Driven Development'?

Yes, it includes a specific exception for 'Retcon Documentation,' allowing you to draft implementation-pending specs with [PLANNED] markers.

What is the Diataxis framework used by this skill?

Diataxis is a documentation architecture that separates content into four categories: Tutorials (learning-oriented), How-to Guides (task-oriented), Reference (information-oriented), and Explanation (understanding-oriented).

Can I use it to create README files?

Absolutely. It automatically activates when you ask to 'create a README' and ensures the output follows best practices for simplicity and scanability.

How does this skill improve documentation discoverability?

The skill enforces a 'Linking' rule where every new document must be linked from at least one other document, typically the central docs/index.md, preventing 'orphan' pages.

Documentation Architect

Name: Documentation Architect
Author: rysweet

byrysweet

•

Learning & Documentation

Generates high-quality, discoverable software documentation using the Diataxis framework and professional technical writing principles.

This skill transforms Claude into a specialized technical writer capable of producing professional-grade documentation suites. It enforces the Diataxis framework, which categorizes content into tutorials, how-to guides, reference material, and explanations to serve specific user needs. By following the 'Eight Rules' of documentation, the skill ensures all files are correctly located in the docs/ directory, properly cross-linked for discoverability, and populated with real, runnable code examples rather than generic placeholders. It is ideal for developers looking to automate the creation of READMEs, API references, and comprehensive user guides while maintaining high standards of scanability and currency.

Key Features

01Provides specialized templates for tutorials, references, and how-to guides

0210 GitHub stars

03Mandates real, runnable code examples over placeholders

04Enforces the Diataxis framework for structured documentation

05Maintains cross-linking and central indices for discoverability

06Automates documentation placement in a standardized docs/ directory

Use Cases

01Standardizing legacy documentation into a searchable, categorized format

02Building a structured knowledge base for complex software projects

03Generating API reference documentation with functional code snippets

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rysweet/microsofthackathon2025-agenticcoding documentation-writing

For use in Claude.ai and ChatGPT

Download Skill