January 2026 Summaries

Mintlify has introduced enhancements to its web editor to better accommodate diverse publishing workflows and facilitate cross-functional contributions to documentation, enabling teams beyond developers—such as product managers, support, marketing, and HR—to edit and publish accurate knowledge without needing to code. While maintaining its robust docs-as-code workflows, Mintlify now offers a unified workspace that integrates configuration, content, and live previews, allowing users to visually adjust documentation structure and design directly in the editor. This new setup allows for immediate merging of changes or the option to require pull requests through branch protection rules, making the process adaptable to varying levels of publishing rigor. The editor also simplifies media handling with drag-and-drop features and enhances consistency and speed by allowing contributors to insert reusable snippets effortlessly. By reducing barriers and extending existing workflows, Mintlify enables organizations to scale their documentation efforts and maintain accuracy across teams.

Mintlify enhances the agent experience by using content negotiation to deliver clean Markdown documentation to agents, while maintaining human-facing HTML documentation unchanged. This approach reduces token usage by 30 times and improves discoverability for agents, as agents benefit from receiving only the semantic value needed without the overhead of unnecessary HTML elements like tags, attributes, and scripts. Mintlify also optimizes llms.txt discoverability by moving the instruction block to the top of Markdown pages and adding Link and X-Llms-Txt headers to HTTP responses, allowing agents to efficiently locate and process documentation indexes. By leveraging content negotiation, Mintlify enables a single URL to cater to both human and agent consumers, streamlining documentation management and ensuring that AI agents have access to the necessary context for effective reasoning.

Mintlify has introduced support for the Well-Known Skills Discovery standard, enabling users to install skills from any Mintlify documentation site with a single command, without needing to know the file path or site structure. This functionality leverages Cloudflare's Agent Skills Discovery RFC, which allows tools to locate resources at predictable URLs and automatically updates skills with each deployment. Users can further customize their skills by placing a skill.md file in their documentation repository. The CLI detects installed agents and allows for the installation of skills across multiple agents simultaneously. This new feature is part of Mintlify's efforts to enhance documentation discoverability and improve the agent experience through tools like llms.txt, while distinguishing the roles of skills and MCP in knowledge packaging and access management.

As AI-powered search engines increasingly drive user discovery, companies like Vercel, Anthropic, Supabase, and Windsurf are leveraging llms.txt files to optimize their online visibility and documentation accessibility. These files provide structured guidance for AI systems, enhancing their ability to index and interact with a site’s content effectively, which in turn boosts the traffic and user engagement generated via AI tools like ChatGPT. A free llms.txt generator is available to simplify the creation and maintenance of these files, offering users a quick, automated way to produce AI-optimized documentation without requiring extensive technical input. The generator creates a lightweight Markdown file that follows llms.txt format specifications, allowing for easy customization and manual refinement as needed. This approach is crucial as AI becomes a primary channel for discovering technical products, ensuring that AI systems deliver accurate and up-to-date information to users. The guide outlines various strategies for generating and maintaining llms.txt files, including manual creation, script-based automation, and platform-native automation, each catering to different team sizes and resource availability, ultimately facilitating a seamless integration of AI optimization into documentation workflows.

MCP (Modular Capability Protocol) and skills are complementary tools that enhance how agents authenticate and interact with external services. MCP standardizes the interface for authenticated access, resolving issues like bespoke integrations and the need for sharing long-lived API keys, by allowing users to grant scoped access without sharing credentials. Skills, on the other hand, package knowledge in a markdown format that helps agents perform tasks effectively by encoding best practices and tribal knowledge. While MCP has become the standard for third-party integrations despite initial criticisms of security and context bloat, skills have grown popular for their ability to enhance agents' performance by intelligently managing and applying context. The emergence of authenticated CLIs provides a third option that combines the strengths of both MCP and skills, offering standardized patterns and handling authentication naturally. As both MCP and skills continue to mature, they are expected to play crucial roles in AI tooling, providing developers with essential resources for building efficient and effective agents.

Skill.md is a markdown file designed to provide coding agents with essential, up-to-date information about using a product, aiming to improve the quality of code generated by agents. It consolidates various details such as personal preferences, capabilities, limitations, and best practices that are typically scattered throughout documentation or omitted to avoid overwhelming human readers. Mintlify automatically updates the skill.md file with the latest documentation changes, ensuring agents have access to the most current context. This file can be customized by users to reflect their specific requirements and is positioned as a more effective alternative to the deprecated install.md, which had limited adoption. The skill.md serves as a cheat sheet for agents, directing them to full documentation when more context is needed, and is structured in a concise manner tailored for agent interpretation rather than human browsing.

The proposal for an install.md standard aims to streamline software installation instructions for AI agents, making the process more efficient and adaptable across different environments. This standard involves creating a markdown file with LLM-executable instructions that are designed to be human-readable and adaptable by AI, allowing users to review and modify steps before execution. By offering a lightweight alternative to installation wizards, install.md provides clear success criteria and is structured to work with existing tools and scripts, addressing edge cases without overloading documentation. This initiative, currently live on Mintlify sites, promises to simplify installations by encoding complex scenarios into a format that AI can autonomously execute, while maintaining transparency and security by requiring user approval for each step.

Documentation plays a crucial role in the success of technical products, as it serves as a primary touchpoint for potential users evaluating whether a product can meet their needs. Unlike marketing materials, documentation offers a firsthand experience that influences conversion by reducing friction and aiding in user understanding, thereby accelerating the decision-making process. Good documentation, which accurately reflects the product, builds trust and signals operational maturity, making it a critical component for competitive differentiation and long-term customer retention. As technology evolves, tools like Mintlify enhance documentation by proposing updates, generating content, and facilitating collaboration, ensuring that documentation remains relevant and useful for both human users and AI agents. This underscores the importance of treating documentation with the same priority as other marketing efforts to maintain a consistent narrative and support user engagement throughout their journey.

Anahita Sahu, Chief of Staff, shares her experience of overhauling her team's internal knowledge base using Mintlify's assistant and web editor, which streamlined the migration of scattered documentation into a cohesive, accessible platform. Facing the challenge of consolidating documentation from multiple platforms, Sahu prioritized speed and quality to ensure the knowledge base was ready for onboarding new team members. The Mintlify agent simplified the process by handling formatting and placement tasks, allowing Sahu to focus on content strategy, information architecture, and ensuring content clarity. The web editor's intuitive drag-and-drop interface facilitated easy organization and review, while custom agent settings ensured consistent updates. This efficient process, achieved through Slack and a web browser, resulted in a well-structured and navigable knowledge base, demonstrating the power of effective tools in enhancing productivity and documentation management.

Mintlify has introduced a new feature that identifies documentation gaps by analyzing user interactions with a documentation assistant, providing conversation-driven suggestions to enhance existing systems that track pull request-based updates. As a product evolves, maintaining accurate documentation becomes challenging due to scattered signals across platforms. Mintlify automates this process by surfacing suggestions based on patterns in user inquiries, which helps pinpoint areas needing clarification or additional examples. This approach allows documentation to dynamically adapt to both product changes and user interactions, ensuring that information remains accurate and accessible. The dashboard now highlights these conversation-based suggestions, enabling teams to make precise updates that improve the overall user experience and efficiency of the documentation assistant.