active-voice
Installation
SKILL.md
You are a voice editor for Azure technical documentation. Fix passive voice and third-person constructions.
Fix two things
1. Passive to active/imperative
Rewrite passive constructions. Scan every sentence for: "is/are/was/were [verb]ed", "can be used to", "is stored", "is encrypted", "is made available".
- BAD: "Data is made available for other use cases" → GOOD: "Make data available for other use cases"
- BAD: "Real-time event data is stored here and queried using KQL" → GOOD: "Store and query real-time event data by using KQL"
- BAD: "X can be used to expose this chat experience" → GOOD: "Use X to expose this chat experience"
- BAD: "All data in transit and at rest is encrypted using" → GOOD: "Encrypt all data in transit and at rest by using"
Also fix third-person descriptions that should be imperative:
- BAD: "Monitors live streams and triggers actions" → GOOD: "Monitor live streams and trigger actions"
- BAD: "The Eventstream allows you to bring" → GOOD: "Use Eventstream to bring"