devtu-optimize-descriptions

To optimize API documentation, this Skill enforces a three-section description structure, validates metadata fields against the schema, and expands abbreviations to generate ready-to-publish, user-friendly descriptions with clear prerequisites.

Standardizing tool descriptions for onboarding involves automating consistency checks across required fields, clarifying prerequisites to reduce friction, and standardizing quick-start instructions to ensure uniform language throughout the documentation.

Validating YAML frontmatter and metadata fields during tool reviews requires enforcing the presence of required name and description attributes, checking alignment with the Skill metadata schema, and ensuring the three-section structure is applied.

Yes, you can improve parameter guidance and examples in markdown documentation by providing the tool JSON, which the Skill processes to expand abbreviations, validate metadata, and output ready-to-publish descriptions with improved parameter instructions.

No specific dependencies are required to enforce the description structure; the Skill operates independently to validate metadata fields, apply the three-section template, and standardize quick-start instructions for API references.