Devtu Docs Quality

What it does

The Devtu Docs Quality skill assesses documentation for clarity, accuracy, and consistency using a two-phase approach. It combines automated validation scripts with structural audits specific to ToolUniverse environments. The goal is to ensure high-quality developer resources by identifying and flagging potential issues like outdated information, broken links, or inconsistencies in terminology.

When to use it

This skill is useful for:

• Pre-release documentation review before new versions are launched.
• Reviewing documentation after major refactoring involving changes to commands, APIs, or tool counts.
• Investigating user reports of confusing or outdated documentation.
• Identifying potential circular navigation or structural problems within the documentation.
• Establishing an automated validation pipeline for ongoing documentation quality control.

Key capabilities

• Automated Validation (Phase A): Creates and runs scripts to detect issues like deprecated terminology, broken links, and inconsistencies.
• ToolUniverse-Specific Audit (Phase B): Checks for circular navigation, MCP configuration duplication, tool count consistency, and auto-generated file conflicts.
• False Positive Detection: Includes logic to avoid flagging legitimate uses of outdated terms or technical values as errors.
• Script Generation: Creates validate_documentation.py scripts to perform automated checks on Markdown (.md) and reStructuredText (.rst) files.

Example prompts

Here are some example prompts for an AI agent equipped with this skill:

• "Run the documentation quality check on the ToolUniverse docs."
• "Assess the documentation for any inconsistencies after the recent API changes."
• "Check the documentation for circular navigation issues."

Tips & gotchas

• The automated validation phase (Phase A) takes approximately 15-20 minutes to complete.
• The ToolUniverse-specific audit (Phase B) takes around 20-25 minutes.
• This skill is specifically designed for documentation within a ToolUniverse environment and may not be applicable or accurate in other contexts.