Can I generate both Markdown and JSON files?

Yes, if the document type's schema requires dual-format support, doc-writer will generate both a README.md and a machine-readable .json file simultaneously.

Does it handle versioning automatically?

Yes, it uses semantic versioning (MAJOR.MINOR.PATCH) and automatically increments the version and updates the 'updated' timestamp whenever a document is modified.

What document types does doc-writer support?

It supports any document type defined in your local configuration, such as APIs, datasets, ETL processes, and testing documentation, by loading the corresponding schema and template at runtime.

Does doc-writer validate the documentation content?

No, doc-writer focuses strictly on the write operation. Validation is handled by a separate 'doc-validator' skill to ensure a clean separation of concerns.

Dynamic Doc Writer

Name: Dynamic Doc Writer
Author: fractary

byfractary

•

Learning & Documentation

Automates the creation and updating of structured software documentation using dynamic, type-specific templates and schemas.

About

The doc-writer skill is a specialized execution layer for Claude Code designed to generate and maintain consistent, high-quality documentation for APIs, datasets, ETL processes, and more. By dynamically loading context-specific templates and standards at runtime, it ensures all documentation remains type-agnostic and uniform. It intelligently merges conversational facts with existing file content, handles semantic versioning automatically, and supports dual-format outputs (Markdown and JSON). This skill is essential for teams looking to automate technical writing while maintaining strict architectural standards and version control.

Key Features

2 GitHub stars
Automatic semantic versioning and timestamp management for all updates
Support for dual-format documentation (README.md and machine-readable JSON)
Mustache template rendering for flexible and standardized content generation
Dynamic context loading for type-specific templates, schemas, and standards
Intelligent context merging from conversational, explicit, and file-specific sources

Use Cases

Maintaining synchronized Markdown and JSON representations of technical specifications
Generating standardized API documentation from source code and conversation context
Updating existing project docs with automatic version bumping and change tracking

About

Key Features

2 GitHub stars
Automatic semantic versioning and timestamp management for all updates
Support for dual-format documentation (README.md and machine-readable JSON)
Mustache template rendering for flexible and standardized content generation
Dynamic context loading for type-specific templates, schemas, and standards
Intelligent context merging from conversational, explicit, and file-specific sources

Use Cases

Maintaining synchronized Markdown and JSON representations of technical specifications
Generating standardized API documentation from source code and conversation context
Updating existing project docs with automatic version bumping and change tracking