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

$fractary$ byfractary

•

Learning & Documentation

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

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

012 GitHub stars

02Automatic semantic versioning and timestamp management for all updates

03Support for dual-format documentation (README.md and machine-readable JSON)

04Mustache template rendering for flexible and standardized content generation

05Dynamic context loading for type-specific templates, schemas, and standards

06Intelligent context merging from conversational, explicit, and file-specific sources

Use Cases

01Maintaining synchronized Markdown and JSON representations of technical specifications

02Generating standardized API documentation from source code and conversation context

03Updating existing project docs with automatic version bumping and change tracking

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fractary/claude-plugins doc-writer

For use in Claude.ai and ChatGPT

Download Skill