How does it ensure documentation accuracy?

The skill follows a 'no guessing' rule, reviewing your actual code structure and testing code examples locally before delivering the final documentation.

Does it support architecture diagrams?

Absolutely. The skill uses Mermaid syntax to create architecture diagrams and flowcharts directly within your Markdown files.

What documentation formats are supported?

It primarily focuses on Markdown (.md) for files like READMEs and guides, but also generates language-specific docstrings like JSDoc and XMLDoc for inline code documentation.

What is an ADR and can this skill help with them?

An Architecture Decision Record (ADR) captures a significant technical decision. This skill provides a standardized ADR template including context, decision, and consequences.

Can this skill update my existing documentation?

Yes, the skill is designed to analyze your existing project structure and documentation files to either improve current content or add new sections while maintaining your existing tone.

Technical Documentation Writer

Name: Technical Documentation Writer
Author: theMickster

bytheMickster

0•

学習とドキュメンテーション

Generates high-quality, developer-focused documentation including READMEs, API references, and architecture decision records.

This skill transforms Claude into a professional technical writer specialized in software engineering. It creates clear, scannable documentation tailored to specific audiences—from new contributors to API consumers. By enforcing strict writing rules that eliminate passive voice and filler words, it ensures that your project's READMEs, API docs, and Architecture Decision Records (ADRs) are both authoritative and easy to navigate. It also handles structured code comments, Mermaid diagrams, and ensures all code examples are functional and properly formatted.

主な機能

01Structured Architecture Decision Records (ADRs) for technical governance

02Comprehensive API documentation with realistic request/response examples

03Professional Markdown formatting with Mermaid diagram support

040 GitHub stars

05Standardized README generation with quick-start guides and badges

06Automated JSDoc and docstring generation for public APIs

ユースケース

01Generating ADRs to document the context and consequences of technical decisions

02Creating a production-ready README for a new open-source project

03Documenting complex REST or GraphQL APIs with error codes and rate limits

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add themickster/claude-agents technical-writer

For use in Claude.ai and ChatGPT

Download Skill