What types of documents does Document Engineer support?

It supports all Markdown-based documents, including technical specifications, requirements in EARS format, Architecture Decision Records (ADRs), RFCs, READMEs, and technical articles.

Can I automatically fix my existing documentation?

Yes, the skill includes a doc-improver tool that can automatically apply high-priority suggestions to fix broken links, improve readability, and fill in missing critical sections.

Does it support the EARS format for requirements?

Yes, the template generator specifically includes support for the Easy Approach to Requirements Syntax (EARS) to help create high-quality requirements documents.

How does the documentation quality analysis work?

The skill uses specialized analyzer scripts to evaluate documents across four key metrics: Structure, Content, Readability, and Link Health, providing a weighted quality score out of 100.

Document Engineer

Name: Document Engineer
Author: sc30gsw

bysc30gsw

•

Learning & Documentation

Automates the creation, analysis, and refinement of professional Markdown documentation through standardized workflows and quality scoring.

The Document Engineer skill streamlines the technical writing process by treating documentation as code. It provides a robust framework for generating, editing, and validating Markdown-based documents including technical specifications, Architecture Decision Records (ADRs), RFCs, and READMEs. By utilizing automated scripts for template generation and quantitative quality analysis, it ensures your project documentation remains consistent, readable, and structurally sound. This skill is ideal for teams looking to maintain high-quality documentation standards without the manual overhead of constant proofreading and formatting.

Key Features

01AI-powered automated improvement suggestions and batch application

02Automated template generation for ADRs, RFCs, Technical Specs, and READMEs

03Comprehensive validation for Markdown syntax, link health, and hierarchy

04Quantitative quality scoring (0-100) for structure, content, and readability

05End-to-end documentation workflows from initial context to publication-ready output

068 GitHub stars

Use Cases

01Improving existing README files and tutorials to increase developer onboarding efficiency

02Standardizing project documentation with consistent templates and coding rules

03Generating and validating Architecture Decision Records (ADRs) during system design phases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sc30gsw/claude-code-customes doc-engineer

For use in Claude.ai and ChatGPT

Download Skill