matlab-write-help

When to Use

• Writing help text for a new MATLAB function, class, or script
• Rewriting or improving existing help text that is incomplete or non-conforming
• Reviewing help text for standards compliance
• Adding help to methods in a classdef file
• Generating property comments for a class

When NOT to Use

• Writing general documentation or README files (not help comments)
• Generating code — this skill only produces help text
• Working with non-MATLAB languages
• Writing MATLAB Live Script markup (use plain-text-live-code guidelines instead)

Task

Resolve $file to an M-file path and generate complete, standards-compliant MATLAB help text for it. If the file already has help text, improve it to meet the standards below. Present the proposed help text to the user for review before modifying the file.