Does this skill merge changes automatically?

No, Doc Author is designed to open pull requests for human review and never commits directly to the main branch.

Can it work with non-Mintlify sites?

Yes, while optimized for Mintlify-powered sites, it is compatible with any markdown or MDX documentation system that uses git.

How does it handle information it can't verify?

If information cannot be verified in the codebase or via user input, the skill inserts a clear TODO comment and flags the uncertainty in the PR description.

What file formats does it support?

It is primarily designed for Markdown (.md) and MDX (.mdx) files, with specific support for YAML frontmatter and custom components.

Does it support marketing or promotional copy?

No, the skill's core principles strictly prohibit marketing language, fluff, and emojis to maintain professional, technical clarity.

Doc Author by Mintlify

Name: Doc Author by Mintlify
Author: mintlify

bymintlify

•

333

•

Learning & Documentation

Writes and maintains technical documentation autonomously while adhering to strict style guides and verification guardrails.

Doc Author is a specialized skill designed to manage documentation workflows autonomously within your codebase. Built by Mintlify, it enables Claude to draft new pages, update existing content, and ensure consistency across your documentation site by reading surrounding context and adhering to specific voice and tone standards. It follows a safety-first approach by flagging uncertainties with TODOs and always opening pull requests for human review, making it an ideal companion for maintaining high-quality developer docs without manual oversight.

Key Features

01Built-in verification guardrails and uncertainty flagging via TODOs

02Seamless integration with Mintlify MDX components and frontmatter

03333 GitHub stars

04Strict adherence to technical writing style guides and voice patterns

05Autonomous documentation creation and maintenance

06Automated pull request creation for human-in-the-loop review

Use Cases

01Documenting new features by analyzing the underlying codebase

02Keeping existing API documentation in sync with recent code changes

03Refactoring and standardizing documentation tone and structure across a project

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mintlify/docs doc-author

For use in Claude.ai and ChatGPT

Download Skill