Validate Imperative Format

This skill validates that every API specification's info.description starts with an imperative action verb. It relies on agent reasoning rather than regex to evaluate whether the opening word is a genuine imperative verb appropriate for describing an API's capabilities.

When to Use This Skill

Use this skill when:

• Reviewing API descriptions for consistent voice and tone
• Auditing description quality across all specs before a release
• Fixing descriptions that use boilerplate or passive phrasing

What Makes a Good API Description

A good info.description starts with an imperative verb — a direct command form that tells the reader what the API does. The sentence should read as if completing the phrase "Use this API to..." without actually writing that phrase.

Examples of good imperative openers